跳至主要内容

更新紀錄

本頁記錄嵌入式 SDK、平台 API 及相關文件的重要變更。SDK 的版本路徑為 /embed/v1/*，API 的版本路徑為 /inference-api/b2b/v1/*。不相容的變更會以新的主要版本與舊版本並行發布（參見 CDN 版本管理）。新增串流事件或回應欄位等相容性擴充不會變更版本號，因此用戶端必須忽略無法辨識的項目。

2026-10-21：Viewer 聊天列，以及根據地圖自身地點回答功能上線​

  • 為您的網頁提供聊天列。 <kaleidr-map product="viewer" layout="bar"> 是一個提問欄位，會帶著訪客的問題開啟已發布地圖：預設在網頁上方開啟，或透過 results-url 在您自己的網頁上開啟。其標題、預留位置文字、範例問題、強調色、主題與語言皆為屬性。參見 聊天列。
  • Viewer 可在開啟時提問。 prompt（或以 prompt-param 從頁面 URL 讀取）與 iframe 的 q 參數會在地圖開啟時向地圖的 Kaleidr AI 提出問題，handle.send() 則從程式碼提問。屬相容性擴充：不變更版本號。
  • 根據地圖自身地點回答已啟用。 已發布地圖或分享連結上的 Ask Kaleidr 面板會優先根據地圖顯示的命名地點回答。參見 根據地圖自身地點回答。
  • 範本商店為您產生程式碼。 template.kaleidr.com 會為您選擇的地圖產生兩段程式碼片段。可下載的網站範本已停用。

2026-10-18：分享連結的 Kaleidr AI 需要其地圖處於已發佈狀態​

  • 地圖取消發佈後，分享連結的 Kaleidr AI 隨之停止。 它也只在地圖目前允許的網域所包含的網頁上可用，而不再依據連結快照中的網域。取消發佈地圖或移除網頁的網域後，與已發佈地圖一樣，會在五分鐘內停止；重新發佈即可恢復。Control Tower 與 Popup Window 開關仍來自快照，連結本身仍顯示其地圖。對於地圖已取消發佈的分享連結，POST /sdk/share-sessions 返回 404 not_found。參見已發佈地圖上的 Kaleidr AI。

2026-10-16：已發布地圖上的 Kaleidr AI 依地圖自身的開關運作​

  • 地圖的 Kaleidr AI 圖塊是唯一的開關。 在 Studio 中，Control Tower 為已發布地圖的訪客提供 Ask Kaleidr 面板，Popup Window 則在其彈出視窗中提供 AI 聊天，iframe 與 Viewer 元素皆然。Share、Embed 中的 Visitor AI Chat 開關已移除。參見 已發布地圖上的 Kaleidr AI。
  • 不再有單張地圖的每月上限。 Monthly AI Credit Limit 欄位已移除。訪客消耗所有者的 AI 點數，上限為方案的額度；每位訪客及每張地圖的速率限制保持不變。
  • POST /sdk/share-sessions 接受 feature。 值為 control_tower（預設值）或 popups，各自僅在對應開關開啓時授予，否則返回 403 chat_disabled。參見 POST /sdk/share-sessions。
  • 分享連結也可開啓 Kaleidr AI。 其 ID 依據連結的快照授予：即連結建立時的 Control Tower 與 Popup Window 開關及允許的網域，費用由地圖所有者支付。在 Studio 中關閉 Kaleidr AI，不會關閉已分發出去的分享連結上的 AI。未知的 ID 仍返回 404 not_found。
  • Viewer 與 Tile 可直接以捲動縮放，與 Studio 相同。 指標位於地圖上方時捲動即可縮放地圖，無需按住 Ctrl 或 ⌘；指標位於地圖之外時，捲動會移動頁面。iframe 不再讀取 gestures=greedy 參數。

2026-10-14：查詢某個位置的資訊，以及兩個已淘汰的端點​

  • 新增：POST /spot 和 POST /spot/overview/stream。 /spot 查詢某個位置有甚麼：用戶點擊的地點、最近的街道地址以及包含該位置的行政區域。每項數據都帶有應顯示的來源署名；按需還可包含地點介紹和照片。/spot/overview/stream 以流式方式返回其中一項的概述，之前先傳送一個提供地點完整名稱的 place 框架。參見 POST /spot。
  • /spot 僅在本次呼叫需要取得內容時收取內容費用。 先前請求已取得的內容不收費，因此 /spot 內容查詢的費用與 /retrieval/poi/enrich 相同或更低。
  • 已棄用：GET /retrieval/poi/enrich 和 POST /chat/summary/stream。 這兩個端點在 2027-01-15 前仍按原方式響應，此日期之後可能隨時移除。響應頭包含 Deprecation、Sunset 及指向替代端點的 Link。參見 從棄用端點遷移。
  • 現在會返回 tenants。 /spot 會將樓宇中的商家作為具有 poi: 引用的 tenant 實體返回，遵循 CDLA-Permissive-2.0，而不再隱藏這些數據。該項查詢仍免費。
  • 每次摘要均計費。 地點摘要或概述按每次請求實際使用的 token 計費；start 和 end 事件不再發送 cached 字段。
  • 樓宇摘要沒有替代端點。 API 不提供樓宇概述。參見 API 不會返回的內容。/spot/overview/stream 也接受不帶 ID 的 building:，並與 building:<id> 一樣，以一個 error 框架回應。

2026-10-13：產品變更及文件的修訂與擴充​

本次更新分為兩部分。產品變更和 API 限制與拒絕回應列出了本版本中產品行為的變化。文件修訂列出先前文件描述了產品實際上不具備的功能之處：我們逐行比對 SDK 和 API 並修訂這些頁面，同時補充內容。如果您的實作根據這些頁面的舊版本，請閱讀修訂說明。

產品變更​

  • 商家數據通過 Kaleidr Studio 上傳。 上傳入口位於任意地圖的“數據”面板底部 Data for AI Answers 區域：選擇 .csv 或 .json 文件，為 CSV 提議並核對列映射、預覽、發佈，並在 Releases 列表中查看結果。這是唯一的上傳入口，僅對擁有上傳權限的組織所有者或管理員顯示；其處理流程與原有上傳 API 相同。已退出 Enterprise 但仍保留發佈版本的組織，其所有者和管理員仍可看到此區域，以及“上傳屬於 Enterprise 方案。”提示和 Releases 列表；其他低於 Enterprise 的組織看不到該區域。參見 使用自有數據回答問題 和 無法上傳時的頁面狀態。
  • 商家數據的上傳和問答均僅限 Enterprise。 Enterprise 組織的所有者或管理員可以上傳併發布。只有在組織仍使用 Enterprise 時，Kaleidr Studio 助手才會向該組織已登錄成員提供基於這些數據的回答。Free 和 Pro 無法上傳。地點數量、文檔數量和文件大小限制按組織在協議中約定，且不得超過平台上限。超限上傳會返回 422，並在原因中注明限額和方案。以組織在 kaleidr.com/billing 購買及更改的 Kaleidr 方案為準。通過 API 金鑰或 SDK 讀取此類數據還需要 Enterprise 專屬的 vendor 權限範圍。參見 各方案可用功能。
  • 地圖數據集的限制取決於方案。 已登錄用戶可以在所有方案中通過 Studio 數據面板向地圖添加文件，但受不同限額約束：Free 每個數據集最多 50,000 行、每個文件 32 MiB、組織所有數據集合計 250,000 行；Pro 分別為 100,000 行、64 MiB 和 5,000,000 行。Enterprise 的單數據集和單文件上限與 Pro 相同，組織總量在協議中約定。超出方案限額時，僅拒絕新的上傳並返回 HTTP 402 quota_exceeded，已存儲的數據不受影響。另有四項適用於所有方案（包括 Enterprise）的硬上限，超出時返回 HTTP 400 VALIDATION_ERROR，而不是 402：文件超過 64 MiB、數據集超過 100,000 行、地理文件超過 50,000 個要素、圖像疊加層超過 16 MiB（指 Studio 從 GeoTIFF 生成的圖像，而非 GeoTIFF 原始文件）。粘貼至 Studio 上傳器的 JSON 對所有用戶都存儲於地圖內部，不計入這些限額。參見 地圖上的數據集 和 錯誤。
  • 被拒絕的數據集上傳不會向地圖添加任何內容。 Studio 會在上傳控制項附近顯示伺服器的任何拒絕原因，且不添加文件：方案限額（402，附伺服器提示和 Upgrade Plan 鏈接）、未登錄工作階段、權限不足、文件過大、上傳次數過多或其他拒絕，包括超過通用硬上限時的 400。只有伺服器無響應、超時或故障時，系統才可能改為將行存入地圖並顯示警告，而且表格必須仍在方案限額內；否則甚麼都不添加。參見 上傳未成功時。
  • 在數據面板刪除數據集將永久刪除。 點擊已存儲數據集的垃圾桶後需要確認，隨後刪除該數據集、從地圖移除其圖層，並釋放組織總資料列數配額。已發佈地圖和分享鏈接都將停止提供該數據集。上傳同名文件會在新數據成功存儲後替換舊數據；若新文件無法讀取，地圖會恢復舊數據並給出提示。“撤銷”可能恢復地圖對已刪除數據集的引用，但該圖層將無法繪制。參見 刪除或替換數據集。
  • Studio 的限制與組織 Kaleidr 方案一致。 組織可保留的地圖數量及上述數據集限額均由在 kaleidr.com/billing 購買或調整的方案決定。Studio 沒有獨立方案。
  • 已發佈地圖和分享鏈接會展示地圖中上傳的數據。 Studio 數據面板添加的數據集會以圖層顯示，圖像疊加層也會繪制在嵌入式查看器和分享鏈接中。僅提供已發佈地圖所包含的數據。在數據面板刪除數據集後，已發佈地圖及所有使用該數據集的分享鏈接都會停止顯示它。取消發佈會停止地圖的嵌入展示，但已經分發的分享鏈接仍會使用先前的數據繼續工作。瀏覽器會保留已經加載的數據，已發出的下載鏈接可能在最長一小時內仍可訪問。每位訪問者都會下載包含所有列的完整數據集，因此大型表格會降低加載速度，已發佈的數據集屬於公開數據。參見 已發佈地圖上的上傳數據。
  • 可以在 Studio 中取消發佈地圖。 對正在發佈的地圖，Publish & embed 頁面提供需要確認的 Unpublish 按鈕。之後所有嵌入頁面會顯示地圖不可用提示。地圖 ID 不變，因此再次發佈即可恢復原有嵌入 URL。參見 取消發佈地圖。
  • Studio AI 助手能夠回答整個數據集的問題。 對當前打開的地圖，助手分析已上傳數據集的所有行，而不是樣本；支持篩選、排序、計數、求和、平均、分組，以及查找某點附近或某區域內的行。一次分析一個數據集，結果最多列出 100 行或分組；僅讀取數據，不修改數據。參見 向助手詢問數據集。
  • 數據集具有列角色。 上傳後 Studio 自動識別名稱、類別、描述和地址列，作者可以在數據面板該數據集的 Column Roles 折疊區域中糾正。名稱列決定 Studio AI 助手和已發佈地圖聊天功能如何稱呼各地點。在 Studio 上傳同名文件會存儲新數據集；舊數據集的列角色會在新文件仍包含對應列時沿用。參見 列角色。
  • 開啓基於地圖自身地點的回答後，Visitor AI Chat 可從已發佈地圖上傳的數據集中作答。 Kaleidr 在平台層面控制此功能，默認關閉。啓用後，聊天檢索的地點也包括已發佈地圖包含的數據集行，前提是數據集存在名稱列、資料列中具有點坐標，且每張地圖最多 200 個地點。參見 基於地圖地點的回答。
  • 新增端點用於報告組織允許上傳的內容。 GET /shared-api/datahub/limits 返回組織是否可以上傳商家數據、方案以及限額。所有方案均返回 200，低於 Enterprise 的組織返回 can_upload: false。Studio 中相應區域用一行展示同樣的限額。參見 組織可上傳的內容。
  • 無上傳權限方案的拒絕碼為 403 vendor_data_not_on_plan。 它替代此前文檔中列出的舊錯誤碼；舊碼已不再返回。依賴舊碼判斷的客戶端應更新。
  • 發佈版本可以取消發佈並刪除。 POST /shared-api/datahub/releases/{id}/unpublish 會立即停止提供指定已發佈版本；DELETE /shared-api/datahub/releases/{id} 會刪除未發佈版本及其派生內容。所有方案的組織所有者或管理員都可執行，即使已經降級。Studio 的 Releases 列表提供 Unpublish 和 Delete，離開 Enterprise 但仍保留版本的組織也可操作。版本列表新增 state 和 ingest_id。參見 撤回發佈版本。
  • 舊發佈版本會自動清除。 已被替換、取消發佈或過期的預覽版本在失去當前狀態 30 天後刪除；失敗版本在最後一次處理嘗試 30 天後刪除。參見 版本保留期限。
  • 列映射提議會消耗 AI 積分。 POST /inference-api/vendor/mapping/propose 從組織 AI 積分中扣費，積分耗盡時返回 429 quota_exceeded。每個賬號每小時最多 30 次提議的限制仍有效；兩種 429 響應的結構不同。參見 區分兩種 429。
  • vendor 權限範圍僅限 Enterprise。 Free 和 Pro 金鑰不能擁有此權限。低於 Enterprise 的方案請求創建帶 vendor 的金鑰會返回 403 tier_capability_not_allowed；以前 Free 會靜默刪除該權限，Pro 則允許創建。低方案中輪換原本帶 vendor 的金鑰時，新金鑰不再包含它。組織從 Enterprise 降級後，原有金鑰會在無報錯的情況下失去數據訪問能力，瀏覽器中已有工作階段也將結束。Pro 仍支持伺服器金鑰及更多有效金鑰。參見 認證與權限範圍。
  • Chat 支持語言、標題和佔位提示。 新增掛載選項 lang、title、placeholder；元素屬性為 lang、chat-title、placeholder。未設置 lang 時，面板使用頁面有效的 <html lang> 屬性，否則使用英語。參見 Chat 參考。
  • <kaleidr-map> 默認是塊級元素。 除非 CSS 覆蓋，否則元素為 display:block，因此設置的 height 可以生效。此前若未另行設置 display:block，高度無效。示例代碼中仍保留 display:block，以兼容 Safari 16.4 之前版本。參見 尺寸設置。
  • 掛載後立即調用的控制句柄方法會被保留。 對 Viewer 和 Tile，在內嵌地圖就緒前調用 setCamera（Tile 也包括 setStyle），會在地圖準備就緒後應用，最多保存最近 256 次調用；此前這類調用會丟失。如果內嵌框架加載後經過有限等待（通常 10 秒）仍未報告就緒，已保存的調用也會被發出，並記錄一次控制台警告。現在無需先等待 kaleidr-embed:ready 再使用句柄。
  • CDN 基礎地址覆蓋只允許三類來源。 base 選項與屬性以及 window.__KALEIDR_EMBED_BASE__ 僅在值為 Kaleidr CDN（https://cdn.kaleidr.com）、加載 kaleidr.js 的來源或頁面自身來源時生效。其他值會被忽略，並在控制台警告，轉而使用默認 CDN。只要加載器和資源包來自同一來源，自托管仍可用。參見 CDN 版本管理。
  • 產品腳本在每個頁面都以 UTF-8 加載。 不論頁面聲明何種編碼，加載器都會按 UTF-8 加載產品腳本。過去，在未聲明編碼的頁面中，Chat 或 Editor 可能無法掛載，並出現 chat.js loaded but window.KaleidrGeoChat is missing 控制台錯誤。參見 故障排除。
  • 調用 destroy() 後可安全地在同一元素上再次掛載， 即使第一次掛載尚在加載中也可以，例如 React 嚴格模式下的情況。
  • 被拒絕的請求不會佔用積分。 在處理前由於頻率、併發、驗證失敗或請求體過大而被拒絕的請求，不再保留任何 AI 積分或併發名額。參見 配額與頻率限制。
  • Viewer 和 Tile 優先採用頁面傳入的相機參數。 加載時傳入的相機設置（center、zoom、pitch、bearing 或 iframe URL 中的 camera），或通過 setCamera 設置的相機，會覆蓋作者保存的視圖，包括依據訪客屏幕寬度與內容自動調整的視圖，並終止尺寸變化時的自動重新取景。頁面未傳的字段仍沿用作者設置；只傳 zoom 而不傳 center 會被忽略。參見 相機設置。
  • Viewer 或 Tile 元素上的 Chat 會保留標記。 與其他地圖一樣，多個回答的標記會持續累積；再次提到同一地點但坐標改變時，更新已有標記的位置，而不是新增標記。關閉或銷毀聊天會移除其標記、路線和所有其他繪制內容。參見 能力與限制。
  • Chat 的 title 是面板標題。 傳入的標題會在每段對話開始後顯示於聊天窗口標題欄；過去它會被從對話生成的標題替換。最小化的聊天窗口顯示所屬對話的標題。參見 標題與佔位提示。
  • Editor 使用可發佈金鑰標識底圖請求。 通過 kaleidr.js 掛載的 Editor 在向 https://tile.kaleidr.com 請求樣式、精靈圖和字體時，會附帶頁面的可發佈金鑰。工作階段權杖絕不會放在 URL 中，無需新增選項。參見 頁面中運資料列的內容。

API 限制與拒絕​

  • 聊天流請求有限額和專用錯誤碼。 422 too_many_messages、message_too_long、conversation_too_long、invalid_session_id 和 lang_too_long。參見 端點。
  • 摘要流和按鈕流 對過長字段返回 422 field_too_long。
  • 請求體超過 2 MiB（設計端點為 5 MiB）時返回 413 request_too_large。
  • 未完整結束的聊天流 至少按其發送的工作階段內容計費。
  • 工作階段權杖可見信息更少。 對工作階段權杖，429 quota_exceeded 響應體和 quota 流事件不再包含方案、使用量或限額。
  • 伺服器金鑰和舊版金鑰的產品限制 在每次調用時執行，違規返回 403 product_not_allowed。
  • 商家數據上傳 增加了字段和列表的限制，以及 413 request_body_too_large、409 org_ingest_in_progress 和 429 ingest_rate_limited；申請列映射提議必須由有上傳權限組織（Enterprise）的所有者或管理員發起。參見 上傳商家數據。
  • Kaleidr Studio 上傳數據集 超過方案限額時返回 402 quota_exceeded，超出所有方案通用上限時返回 400 VALIDATION_ERROR。參見 錯誤。

這些頁面的更正​

以下每一項都表示文件先前有誤，產品本身並未變更。

錯誤代碼與狀態碼

  • AI 積分配額不足時請求返回 429，正文包含 "error": "quota_exceeded"。舊文檔展示的 b2b.tokens_exceeded 從未由 API 返回，且響應示例缺少 detail、product 和 period。
  • map_load_hard_stop 錯誤碼不存在。參見下文“方案”。
  • 從金鑰允許列表以外的來源交換工作階段時返回 403 origin_not_allowed。舊文檔誤寫為 session_origin_mismatch；後者用於工作階段權杖從簽發來源以外的來源使用。
  • vendor_scope_requires_acknowledgement 是 422 而非 403，僅適用於可發佈金鑰。
  • sessions_disabled 是 404，sessions_not_configured 是 503；以前兩者都標成 403。
  • 401 響應包含 {"detail": "Invalid or missing API key"}；舊文檔稱其無響應體。
  • map_load_quota_exceeded 的實際結構為 {"detail": "map_load_quota_exceeded"}，過去展示的扁平對象不存在。
  • 金鑰服務故障返回 401，不是 503。
  • 向 Viewer 嵌入組件傳遞金鑰不會觸發 product_not_allowed，因為 Viewer 不需要金鑰。
  • 已補充之前缺失的錯誤碼，包括 visitor_limit_reached、chat_disabled、not_found、owner_has_no_organization、org_admin_required、key_not_found 和 key_already_rotated。
  • 編輯時出現 key_already_rotated 和 key_expired 僅涉及 expires_at；仍可編輯金鑰的其他字段。撤銷已撤銷的金鑰返回 200。
  • 錯誤碼所在字段。 403 或 404 使用 detail；平台 API 的 429 在 error 中給出錯誤碼，在 detail 中提供說明；map_load_quota_exceeded 則例外，位於 detail。上傳 API 的 429 參見 響應結構。

完整清單請參閱錯誤參考。

方案、配額與金鑰

  • 從自有數據生成回答 曾被寫成“Pro 起可用”。實際上，商家數據的上傳及通過 API/SDK 的 vendor 權限讀取均為 Enterprise 專屬。Free 和 Pro 的另一項功能是將數據集添加到 Kaleidr Studio 地圖。參見上方“產品變更”。
  • 所有方案的地圖加載在達到限額後都會停止。 舊文檔稱付費方案可繼續使用五倍額度，這一行為並不存在。購買地圖加載包可提高限額。
  • AI 積分由組織共享一個資金池， 組織 API 金鑰和團隊使用 Kaleidr 自有應用均從中扣除。舊文檔曾描述獨立的每月 API token 預算。
  • 配額週期取決於賬單週期，不一定是自然月。
  • 頻率限制按金鑰計算，併發限制按組織計算。舊文檔誤稱不同金鑰共享頻率限制。
  • 可發佈金鑰的允許來源列表是可選的。舊文檔曾要求正式金鑰至少配置一個來源；空列表表示允許任何來源。
  • 金鑰創建後不能編輯權限範圍。 此前關於增加或移除權限的說明有誤；請創建新金鑰並撤銷舊金鑰。
  • 伺服器金鑰和舊版金鑰可直接用於運行時 API 調用；舊文檔誤稱所有調用都需工作階段權杖。
  • Free 方案中的金鑰輪替。 輪換可發佈金鑰後，新金鑰具有完整的 Free 權限（ai、maps、design 和全部四種產品），不受舊金鑰配置影響。Free 輪換伺服器或舊版金鑰返回 403 free_plan_publishable_only。
  • monthly_cap_tokens： 取 1 或更大值表示限額；0 或 null 表示不設限。
  • 創建金鑰時的 org_id 應放在 JSON 請求體中；其他金鑰端點才會讀取查詢參數 org_id。
  • Visitor AI Chat 會計入每個請求。 一次提問需要一次回答請求，且回答中的每張結果卡還會觸發一次照片請求。打開地點卡、繼續提問、在路線規劃中查找地址和請求路線，都屬於額外請求並計入訪客限額。參見 已發佈地圖上的 Chat。

請參閱配額與速率限制和驗證與權限範圍。

串流傳輸

  • quota 是流中的最後一個事件，位於 end 或 error 之後。舊文檔誤稱它在流中途發送。該事件報告用量，不能在流結束前發出預警。
  • place 事件可以不包含坐標，並標記 unverified: true。
  • error 事件僅在一種情況下含 code：upstream_stall。
  • 已列出流發送的卡片和圖層事件，包括 weather_card、building_card、arrivals_card 等。
  • 摘要流和按鈕流現已有文檔。
  • 工作階段權杖的 quota 事件 僅包含 type、meter 和 reset_at；舊示例中的使用量數字只對伺服器金鑰返回。
  • end 只重復五類卡片與圖層事件，並非全部：weather_card、satellite_card、constellation_layer、weather_layer 和 vehicles_layer。

請參閱 SSE 串流協定。

端點

  • POST /design/analyze 和 POST /design/apply-direct 的請求體說明曾有錯誤，按原示例發送設計分析會返回 422。現已糾正兩個請求體，並說明目錄響應會包含外層鍵。
  • POST /chat/control/route 要求每個地點對象直接包含 lat 和 lng，而不是放在 coordinates 內。
  • 發給 POST /chat/control/stream 的 system 消息會被忽略，之前沒有注明。

請參閱端點。

已發布的地圖與分享連結

  • 已發佈地圖展示當前保存的版本。 舊文檔稱嵌入組件展示“最後一次發佈的版本”，可用 Re-publish 更新。事實並非如此：Studio 中保存的任何修改，包括新增數據集，在嵌入組件下次加載時就會公開，無需重新發佈。Re-publish 只記錄新的已發佈版本，仍保留相同 ID、鏈接和嵌入代碼。若要私下修改地圖，應先取消發佈，修改完畢後再發佈。參見 嵌入地圖。
  • Studio 無法刪除或暫停分享鏈接。 打開 Share 對話框會發佈地圖，並每次生成新分享鏈接。鏈接是地圖設計的快照；即使地圖取消發佈仍繼續工作，直到地圖被刪除或 Kaleidr 應請求移除鏈接。舊文檔提到的刪除或暫停鏈接的控制項實際上不存在。參見 分享鏈接。

SDK 與嵌入元件

  • Chat 可以移動地圖。 舊文檔誤稱 Chat 不控制地圖相機。實際上它可以飛行定位或縮放到回答中的地點，添加自己的標記並繪制路線。僅聊天掛載句柄的 setCamera 不受支持。
  • Editor 的功能範圍。 嵌入式 Editor 在頁面內運行，工作結果僅保存在頁面內存中；不會保存、導出或發佈，也不會調用設計 API。此前聲稱能從嵌入式 Editor 發佈的描述有誤。
  • 內容安全策略的域名。 Editor 從 https://tile.kaleidr.com 加載底圖，舊策略文檔漏列該地址。任何嵌入組件默認都不會調用第三方地圖主機。Chat 會通過 Google 的 favicon 服務加載答案所引用網站的圖標；現在策略文檔和 能力與限制 已明確列出。
  • Leaflet 再次被列為 Chat 支持的地圖，與 Mapbox GL JS、MapLibre GL JS 和 Google Maps JavaScript API 一同使用。
  • Tile 框架的 URL 不攜帶憑據。 其中僅有樣式 ID 和相機參數，不包含可發佈金鑰或工作階段權杖。Tile 工作階段交換會驗證金鑰、計入一次地圖加載並返回組織默認底圖；框架中的地圖不會使用該憑據發起請求。參見 Tile 參考。
  • Kaleidr.enable(false) 僅暫停之後的掛載。 如果瀏覽器在加載器執行時已讀取 <kaleidr-map> 元素，該元素會立刻掛載，早於您的調用。應在加載器之前設置頁面標誌 window.__KALEIDR_EMBED_ENABLED__ = false。
  • 沒有選項對象時調用 Kaleidr.mount 會拋出 TypeError。 其他掛載失敗只會在控制台記錄包含 [kaleidr:<product>] 的錯誤（顯示為 Error: [kaleidr:…），不會拋異常。
  • 嵌入式 Editor 的工具欄 包含 Text、Image、Marker、Popup、Background、Layer、Design 和 Legend。舊文檔誤稱沒有 Design；實際缺少的是 Studio 設計目錄、Data 標籤、AI 面板和 3D 模型庫。
  • kaleidr-plain 在縮放級別 15 起顯示 3D 建築；此前誤稱沒有。
  • Tile 未指定樣式且組織沒有默認樣式時 會發送 kaleidr-embed:error，其中包含 code: 'no_id' 和 id: null。
  • Viewer 的 shareId 可以是已發佈地圖 ID，也可以是分享鏈接的 16 字符 ID；已發佈地圖的 Chat 只能使用地圖自身的 ID。

新增頁面​

2026-10​

  • 地址結果包含更多信息。 GET /retrieval/geocode/forward 對街道地址新增 id（Kaleidr 為門牌分配、跨數據更新保持不變的標識符）；估算地址還在 method 和 matched_numbers 旁新增 within_m 和 score。method 可以為 "range"，表示沿美國相應街區估計門牌位置。這些均為新增字段。參見 端點。
  • Free 方案的 API 金鑰。 Free 組織的可發佈金鑰現在除了底圖外，也能使用 AI Chat、已發佈地圖及 Editor（擁有 ai、maps、design 權限，涵蓋所有產品），消耗 Free AI 積分。伺服器金鑰需要 Pro 或 Enterprise。（vendor 自 2026-10-13 起僅限 Enterprise。）組織有效金鑰數量上限為：Free 2、Pro 10、Enterprise 25（超出返回 409 key_limit_reached；輪換不計入且已有的超額金鑰保留）。

2026-09​

  • 地址搜索支持街道門牌。 GET /retrieval/geocode/forward 現在也能返回用戶輸入的街道地址（type: "address"）。attribution.sources 列出使用的地址數據集、署名及任何許可證限制；G-NAF 結果不得用於匯總郵寄地址。數據中缺失的門牌號會根據同一街道鄰近門牌估算，帶有 approximate: true、method 和 matched_numbers。這是新增能力，原有地點搜索結果不變。
  • 公交出行路線。 POST /chat/control/route 接受 profile: "transit"，在 action.payload.transit 中返回只需乘坐一條線路的行程；若沒有直達交通工具，返回 { "error": "…" }。請求體不變，其他 profile 值保持原有路線方式。新增 GET /retrieval/geocode/forward（需要 ai 權限並計費）支持起點和終點搜索框。Chat 路線界面新增可輸入的起終點字段和公交模式。
  • 金鑰權限取決於當前方案。 工作階段交換和所有運行時調用都會按組織當時的方案檢查金鑰，因此更改方案無需編輯或輪換金鑰即可生效。tier_capability_not_allowed 表示金鑰有權限但當前方案不包含；insufficient_scope 表示金鑰從未擁有該權限。
  • 方案更改會影響已簽發工作階段。 降級會在數分鐘內終止此前簽發的工作階段，而不是等到過期。升級在下次工作階段交換時生效。
  • Free 方案的產品修改會被檢查。 將 Free 金鑰的 allowed_products 改為空列表或方案不支持的產品，會返回 403 tier_capability_not_allowed。
  • 移除了 grounding 流事件。 監聽該事件的客戶端將不再收到它。

2026-08​

  • 底圖訪問需要金鑰。 限制第三方直接使用 tile.kaleidr.com；<kaleidr-map> 嵌入組件和 Kaleidr 托管地圖不受影響。Tile 工作階段計入組織的地圖加載次數（配額）。
  • 工作階段交換和刷新。 可發佈金鑰會交換為短期、綁定來源的工作階段（kld_sess_…，15 分鐘），SDK 負責刷新。
  • Chat 可控制 Kaleidr 地圖元素。 掛載 Chat 時，可用 map-target 指向同頁的 Viewer 或 Tile 元素。
  • 組織默認底圖。 POST /sdk/sessions 在 basemap_style_id 中返回組織默認底圖；未指定樣式的嵌入組件會使用它。
  • 瀏覽器拒絕伺服器金鑰。 SDK 在掛載階段拒絕 kld_sk_…。
  • 基礎地址選項拆分。 viewerBase 和 tileBase 從加載器的 base 選項中拆分出來。
  • 路線顏色。 route 流事件攜帶 color、label、alternatives 和 comparison。

v1​

  • kaleidr.js 加載器和 <kaleidr-map> 元素：一個加載器支持四種產品（Chat、Viewer、Editor、Tile）。
  • 瀏覽器可發佈金鑰（kld_pk_）及伺服器金鑰（kld_sk_），支持 ai、maps、design 和 vendor 權限；可發佈金鑰需要交換為短期、綁定來源的工作階段。舊版 kld_live_ 金鑰繼續有效。
  • /inference-api/b2b/v1/chat/*（流式）和 /design/* 端點系列。