使用設計型底圖

將 Kaleidr 設計型 basemap 作為 iframe 嵌入，透過 style id 選擇，並由 您的 publishable key 授權。Tile 可在所有方案中運行，包括 Free — Free-tier key 預設會以 maps 範圍與 tile 產品權限 建立。

您頁面的 origin 必須位於 key 的 allowlist 中，並透過 HTTP(S) 提供 — 請參閱 取得 API 金鑰。

<script src="https://cdn.kaleidr.com/embed/v1/kaleidr.js"></script>
<kaleidr-map product="tile" publishable-key="kld_pk_live_…" style-id="kaleidr-morning"
             center="-0.12,51.5" zoom="11" style="height:480px"></kaleidr-map>

可用 styles 包括 kaleidr-morning, kaleidr-afternoon, kaleidr-night, kaleidr-editorial, kaleidr-plain。請參閱 Tiles。

相機透傳

center, zoom, pitch 與 bearing 在 tile 上都會生效 — 既可以作為 attributes，也可以在 mount 後透過 handle.setCamera(...) 使用。

即時切換 style

tile handle 提供 setStyle(styleId)：

const handle = Kaleidr.mount('#basemap', {
  product: 'tile',
  publishableKey: 'kld_pk_live_…',
  styleId: 'kaleidr-morning',
});

// Later, swap to the night palette without remounting:
handle.setStyle('kaleidr-night');

setStyle 只在 tile handle 上公開 — 在 chat、editor 或 viewer 上呼叫時，會記錄 [kaleidr] 警告並傳回。

計量

Basemap access 屬於您的 Kaleidr account：key 上的 maps 範圍 負責授權，使用量會計入您方案的 map-loads allowance — 與 shared-map 開啟次數與 embedded map view 共用 同一個 pool。不存在獨立的 tile key，也不存在未驗證的 tile API。

自行託管 basemap CDN

Enterprise 客戶可以從獨立 CDN 提供 tiles。使用 viewer-base（attribute）或 viewerBase（mount option）將 Tile 產品 iframe 指向該 deployment。 這與 loader base（base / __KALEIDR_EMBED_BASE__）互相獨立 — 請參閱 CDN versioning。