跳至主要内容

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。