Tile
Tile 產品會在 Kaleidr 託管的 iframe 中呈現設計型 Kaleidr 底圖。
它是 Free 帳戶唯一可使用的需要金鑰的產品 —
publishable 金鑰預設包含 maps 範圍與 tile 產品權限。
決定是否能正常運作的三個關鍵因素
| 要素 | 說明 |
|---|---|
| 接入方式 | iframe — 地圖在 Kaleidr 自身 CSP 下的 map-embed.kaleidr.com 中載入。 |
| 所需範圍 | maps. |
| 最低方案 | Free — Free 金鑰建立時包含 ["maps"] 範圍與 ["tile"] 產品權限。 |
由於地圖是在 Kaleidr iframe 中呈現,如果只嵌入 Tile,父頁面的 CSP 不需要允許任何地圖 / tile / vendor image host。只有當您在同一頁面上 同時運行 Chat 或 Editor 時,這些 host 才需要允許 — 請參閱 Content Security Policy。
各元件的位置
- SDK 參考 — Tile — 屬性(
style-id,center,zoom,pitch,bearing)、handle matrix、setStyle。 - 指南 — 使用 tiles — style picker、camera pass-through、 self-hosting 注意事項。
唯一需要的程式碼片段
最小可用 Tile embed:
<script src="https://cdn.kaleidr.com/embed/v1/kaleidr.js"></script>
<kaleidr-map product="tile"
publishable-key="kld_pk_live_…"
style-id="kaleidr-morning"
style="height:480px"></kaleidr-map>
如果省略 style-id,預設使用 viewer 的預設 canvas;也可以使用完整的
style URL。