Viewer

Viewer 產品透過 share id 嵌入已發布的 Kaleidr 地圖。它 無需金鑰 — share 本身就是授權，因此不需要 publishable 金鑰， 也不會進行工作階段交換。

決定是否能正常運作的三個關鍵因素

要素	說明
接入方式	iframe — 地圖在 Kaleidr 自身 CSP 下的 map-embed.kaleidr.com 中載入。
所需範圍	無 — 不交換任何金鑰。
最低方案	Free — 任何擁有 share id 的使用者都可以在任何方案中嵌入 Viewer。

向 Viewer embed 傳遞金鑰會以 product_not_allowed 拒絕，因為 Viewer 完全不需要金鑰。share-id 是 必填項目 — 省略時會在 bundle 載入時拋出錯誤。

各元件的位置

• SDK 參考 — Viewer embed — 必填的 share-id、選用相機設定與 handle matrix。
• 指南 — 嵌入 Kaleidr 地圖。

唯一需要的程式碼片段

最小可用 Viewer embed：

<script src="https://cdn.kaleidr.com/embed/v1/kaleidr.js"></script>
<kaleidr-map product="viewer"
             share-id="YOUR_SHARE_ID"
             style="height:480px"></kaleidr-map>