什麼是 Kaleidr?產品與限制

Kaleidr 平台示意圖:上方為 AI、Studio、Analytics 與 Enterprise,互動式地圖周圍為 Chat、Viewer、Tile 與 Editor。

什麼是 Kaleidr?Kaleidr 是一個用於對話式地圖、地圖發布、Analytics 與開發者嵌入的 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}
}