Tile
The Tile product renders a designed Kaleidr basemap inside a Kaleidr-hosted
iframe. It is the one keyed product Free-tier accounts can run — the
publishable key carries the maps scope and tile product admission by
default.
The three facts that decide whether it will work
| Fact | Answer |
|---|---|
| Doorway | iframe — the map loads inside map-embed.kaleidr.com under Kaleidr's own CSP. |
| Required scope | maps. |
| Minimum plan | Free — a Free key mints with ["maps"] scope and ["tile"] product admission. |
Because the map renders inside a Kaleidr iframe, the parent page's CSP does NOT need any map / tile / vendor image hosts to embed Tile alone. Only when you also run Chat or Editor on the same page do those hosts matter — see Content Security Policy.
Where the pieces live
- SDK reference — Tile — attributes (
style-id,center,zoom,pitch,bearing), the handle matrix,setStyle. - Guide — Use tiles — style picker, camera pass- through, self-hosting notes.
The one snippet
Minimum-viable 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 defaults to the viewer's canvas default if omitted; a full style
URL is also accepted.