跳到主要内容

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。