什么是 Kaleidr?产品与限制

Kaleidr 平台示意图:上方为 AI、Studio、Analytics 和 Enterprise,交互式地图周围为 Chat、Viewer、Tile 和 Editor。

什么是 Kaleidr?Kaleidr 是一个面向对话式地图、地图发布、分析和开发者嵌入的 Spatial AI 平台。一个浏览器加载器即可提供 Chat、Viewer、Tile 和 Editor。Studio 是创建和发布地图的地方。Editor 是页面内编辑工具,两者不是同一个产品。

什么是 Kaleidr?

Kaleidr AI 是处理地点问题的对话层。Studio 用于创建地图、设置样式、添加数据并发布。Analytics 是用于了解地图如何被使用的产品区域。Enterprise 是面向需要自定义用量、合同以及让 AI 回答使用业务数据的组织路径。

这些区域旁边的四个名称,是网页可以加载的产品。Chat 并不等同于整个 Kaleidr AI,Editor 也不等同于 Studio。已发布的地图可以在页面中不放置 API key 的情况下带有 Ask Kaleidr 面板,这条路径仍然是 Viewer 加上地图自身的开关。上排回答公司提供什么,下排回答页面嵌入什么。

平台区域 Kaleidr AI、Studio、Analytics 和 Enterprise,与 kaleidr.js 产品 Chat、Viewer、Tile 和 Editor 并列。

两列彼此相关,但不是同一份列表。Kaleidr AI 不是 Chat 的同义词,Studio 也不是 Editor 的同义词。中间的堆栈是一张地图,不是第五个产品。

哪个 Kaleidr 产品适合这项工作?

按工作选择产品,而不是按品牌名选择。已经有地图的网站,在该地图上使用 Chat,Free 计划即可,并使用 publishable key。通过 Studio 设计的地图用 Viewer 嵌入,不需要 key,同样可在 Free 使用。设计好的底图使用 Tile,在 Free 中使用 publishable key。

页面内编辑工具是 Editor,可在 Free 中使用 publishable key。由 backend 返回回答、地点和路线的是 Server API,它需要 server key,并从 Pro 开始提供。需要让 AI 回答以私有业务数据为依据时,应使用 Enterprise 上传,而不是把文件直接放到地图上。即使完全没有地图,Chat 也可以继续在 Free 中运行,只要页面仅需要一个具备地点理解能力的面板 (Kaleidr, 2026)。

六种工作分别对应 Chat、Viewer、Tile、Editor、Server API 和 Enterprise 业务数据。

每张卡片先说明一项工作,再说明执行该工作的产品。Viewer 用于已经在 Studio 中创建好的地图。Enterprise 数据是私有 grounding 路径,不是地图上的 dataset。

kaleidr.js 中的四个产品是什么?

一个 script 即可加载所有浏览器产品。加载器会定义 window.Kaleidr 和 kaleidr-map 元素,然后获取你所挂载产品的 bundle。Chat 和 Editor 在宿主页面中渲染,Viewer 和 Tile 则在 Kaleidr iframe 中渲染。页面里的 publishable key 会被交换成一个短时 session,而 server key 从 backend 调用 API;该 Server API 没有 JavaScript client,也没有 npm package (Kaleidr, 2026)。

浏览器加载器没有 npm package,script 标签是唯一的加载方式。React、Next.js 或 Vue 应用会注入这个 script,而不是导入 Kaleidr module。加载器 URL 为 https://cdn.kaleidr.com/embed/v1/kaleidr.js。挂载产品时才会拉取 Chat、Viewer、Tile 或 Editor (Kaleidr, 2026)。

位于 cdn.kaleidr.com/embed/v1/kaleidr.js 的加载器分支到 Chat、Viewer、Tile 和 Editor。

Chat 和 Editor 在页面中运行。Viewer 和 Tile 在 iframe 中运行。Viewer 是不需要 API key 的产品。图底部说明无需 Kaleidr npm package。

Chat 可以连接到哪些地图?

目前有 Mapbox GL JS、MapLibre GL JS、Google Maps JavaScript API 和 Leaflet 的指南。宿主保留自己的 renderer、style 和 layers。Chat 会添加流式回答、pins、camera 移动,以及在问路时添加 route。Apple MapKit JS 和 Naver Maps 也能被识别,但两者都没有专门指南 (Kaleidr, 2026)。

Kaleidr Chat 连接到 Mapbox GL JS、MapLibre GL JS、Google Maps JavaScript API 和 Leaflet。

四个有指南的库继续保留,Chat 添加在它们旁边。Apple MapKit JS 和 Naver Maps 在文档中可被识别,但未出现在此图中。

每个产品使用哪种 key?

宿主地图上的 Chat、无地图的 Chat、Tile 和 Editor 使用 publishable key。Viewer 不使用 key。publishable key 可以限制到允许的 origins,页面会将其交换为与产品和 origin 绑定的短时 session。server key 保留在 backend,如果请求看起来来自浏览器就会被拒绝。

Chat 面板会发送对话、该对话的随机 id、地图的 zoom level 和 language tag。面板不会发送宿主地图的 layers、sources 或 markers,也不会发送地图当前显示的区域。关于 camera,只发送 zoom level。你不能给浏览器 Chat 自己的指令或每用户 permissions,Kaleidr 也不知道最终用户是谁,并且目前没有适用于 iOS、Android、React Native 或 Flutter 的 native SDK (Kaleidr, 2026)。

浏览器中的 publishable key 被交换为短时 session token,server key 从 backend 调用 Server API。

左侧 key 用于浏览器,可按 origin 限制。中间 token 是短时 session。右侧 key 是 Pro 和 Enterprise 的 backend secret。图中的 prefix 只是格式,不是真实 credentials。

你自己的数据路径有何不同?

地图上的 dataset 是你在 Studio 中添加的文件,Free、Pro 和 Enterprise 都可使用。该文件属于这张地图,可以作为 layer 绘制,Studio assistant 也可以对其中的行回答问题。这个 dataset 不会通过 API key 或 SDK 读取。用于 AI 回答的业务数据需要通过 Enterprise 单独上传,以便对回答进行 grounding;而已发布地图仍会完整提供它所绘制的任何 dataset,包括所有列 (Kaleidr, 2026)。

地图上的 dataset 可在 Free、Pro 和 Enterprise 使用,旁边是用于 AI 回答 grounding 的 Enterprise 业务数据。

左侧路径是单张 Studio 地图上的文件。右侧路径是组织用于 AI 回答的业务数据,仅限 Enterprise。图底部说明两者并不是同一个共享存储。

在宿主地图上,Chat 看不到什么?

接入 Chat 并不会把整个宿主应用交给 Kaleidr。现有 layers、markers、sources、已登录用户和私有应用状态仍由宿主保留。Chat 可以回答、返回地点、添加 pins、移动 camera 和绘制 route。这些是 Kaleidr 自己执行的动作,并不意味着它读取了地图上已经绘制的所有内容。

宿主拥有的 layers、markers、identity 和 private systems 保留在 Chat 之外,Chat 负责添加 answers、pins、camera moves 和 routes。

左列是宿主保留的内容,右列是 Chat 可以添加的内容。图底部说明,宿主地图上的 Chat 不会自动读取现有 host layers 或 markers。

Kaleidr 目前不做什么?

浏览器加载器不会以 npm package 的形式发布,也没有 native mobile SDK。浏览器 Chat 不会自动读取宿主 layers 或 markers,也不接受 custom system prompt 或每用户 permissions。嵌入式 Editor 不会保存、export 或 publish,其工作内容会留在页面 memory 中,直到页面 reload 或 editor 被销毁。需要长期保留的地图应在 Studio 中创建 (Kaleidr, 2026)。

一张参考卡片,列出 Kaleidr 目前会做和不会做的事情,审核日期为 2026 年 11 月 12 日。

“会做”一列与本指南中的产品一致。“不会做”一列对应当前限制:kaleidr.js 没有 npm package、没有 native mobile SDK、不自动读取 host layers、没有 custom prompt、没有每用户 permissions,也没有可保存的 Editor 地图。卡片上的审核日期是 2026 年 11 月 12 日。

各计划包含什么?

Free 每月 0 美元,包含 500,000 AI credits 和 50,000 map loads。Pro 每月 29 美元,包含 5,000,000 AI credits 和相同的 50,000 map loads。一次 map load 指一次打开共享地图、一次查看已发布或嵌入地图,或一次 SDK basemap session;tile requests 不单独计量。Enterprise 按协议定价,支持 custom usage,并可通过独立 CDN 提供 tiles (Kaleidr, 2026)。

先从工作开始,再选择计划。prototype 可以留在 Free,需要 server key 的 backend 升级到 Pro,private business data 则使用 Enterprise。如果下一步工作是地图本身,可以 探索 Kaleidr Studio。

说明:Kaleidr 在创意和开发工作流程中使用 AI 辅助工具进行图像创建、内容优化和研究。

常见问题

什么是 Kaleidr?

Kaleidr 是一个 Spatial AI 平台。Kaleidr AI、Studio、Analytics 和 Enterprise 是平台区域。Chat、Viewer、Tile 和 Editor 是在浏览器中加载的四个产品。

Studio 和 Editor 是同一个产品吗?

不是。Studio 用于创建和发布地图。Editor 会在宿主页面中挂载编辑工具,工作内容保留在页面 memory 中。

Viewer 需要 API key 吗?

不需要。Viewer 通过已发布 Studio 地图的 id 进行嵌入。Chat、Tile 和 Editor 使用 publishable key。Server API 使用 server key,并从 Pro 开始提供。

Chat 会读取我地图上的 layers 吗?

不会。Chat 不会发送宿主地图的 layers、sources 或 markers。camera 信息只发送 zoom level。Chat 绘制的 pins 和 routes 属于 Chat 自己。

Kaleidr 有 npm package 吗?

没有。kaleidr.js 通过 script 标签加载。Server API 没有 JavaScript client,也没有 npm package。

Free 包含什么?

Free 每月 0 美元,包含 500,000 AI credits 和 50,000 map loads。Pro 每月 29 美元,包含 5,000,000 AI credits 和 50,000 map loads。Enterprise 使用量按协议确定。

有 native mobile SDK 吗?

没有。不存在适用于 iOS、Android、React Native 或 Flutter 的 SDK。移动应用可以加载使用 kaleidr.js 的网页,或者通过自己的 backend 使用 server key 调用 Kaleidr。

References

  1. Kaleidr Developer Docs. Choose your path. Which product, key, and minimum plan match each job, including Chat on Free, Viewer with no key, the Server API on Pro, and Enterprise business data. Accessed November 12, 2026. https://docs.kaleidr.com/concepts/choose-your-path
  2. Kaleidr Developer Docs. How Kaleidr works. One loader, four products, where each renders, publishable keys exchanged for sessions, and no npm package for the Server API. Accessed November 12, 2026. https://docs.kaleidr.com/concepts/how-kaleidr-works
  3. Kaleidr Developer Docs. kaleidr.js. The browser loader has no npm package, and the script tag is the only way to load it. Accessed November 12, 2026. https://docs.kaleidr.com/sdk/kaleidr-js
  4. Kaleidr Developer Docs. Supported maps. Guides for Mapbox GL JS, MapLibre GL JS, the Google Maps JavaScript API, and Leaflet. Apple MapKit JS and Naver Maps are recognized and have no guide. Accessed November 12, 2026. https://docs.kaleidr.com/chat/supported-maps
  5. Kaleidr Developer Docs. Security model. What the chat panel sends, including zoom and not the host layers, and the absence of a native mobile SDK. Accessed November 12, 2026. https://docs.kaleidr.com/security/security-model
  6. Kaleidr Developer Docs. Answers from your own data. Datasets on a map versus Enterprise business data for AI answers. Accessed November 12, 2026. https://docs.kaleidr.com/your-data/overview
  7. Kaleidr Developer Docs. Editor. In-page edits stay in the page's memory and are not saved, exported, or published. Accessed November 12, 2026. https://docs.kaleidr.com/editor
  8. Kaleidr. Choose Your Plan. Free at $0 with 500,000 AI credits and 50,000 map loads a month. Pro at $29 a month with 5,000,000 AI credits and 50,000 map loads. Enterprise by agreement. Accessed November 12, 2026. https://kaleidr.com/pricing

References in BibTeX

@misc{kaleidr_choose_your_path_2026,
  title  = {Choose your path},
  author = {{Kaleidr}},
  year   = {2026},
  url    = {https://docs.kaleidr.com/concepts/choose-your-path}
}

@misc{kaleidr_how_kaleidr_works_2026,
  title  = {How Kaleidr works},
  author = {{Kaleidr}},
  year   = {2026},
  url    = {https://docs.kaleidr.com/concepts/how-kaleidr-works}
}

@misc{kaleidr_js_2026,
  title  = {kaleidr.js},
  author = {{Kaleidr}},
  year   = {2026},
  url    = {https://docs.kaleidr.com/sdk/kaleidr-js}
}

@misc{kaleidr_supported_maps_2026,
  title  = {Supported maps},
  author = {{Kaleidr}},
  year   = {2026},
  url    = {https://docs.kaleidr.com/chat/supported-maps}
}

@misc{kaleidr_security_model_2026,
  title  = {Security model},
  author = {{Kaleidr}},
  year   = {2026},
  url    = {https://docs.kaleidr.com/security/security-model}
}

@misc{kaleidr_answers_from_your_own_data_2026,
  title  = {Answers from your own data},
  author = {{Kaleidr}},
  year   = {2026},
  url    = {https://docs.kaleidr.com/your-data/overview}
}

@misc{kaleidr_editor_2026,
  title  = {Editor},
  author = {{Kaleidr}},
  year   = {2026},
  url    = {https://docs.kaleidr.com/editor}
}

@misc{kaleidr_choose_your_plan_2026,
  title  = {Choose Your Plan},
  author = {{Kaleidr}},
  year   = {2026},
  url    = {https://kaleidr.com/pricing}
}