使用设计型底图

将 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。