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。