Skip to main content

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

FactAnswer
Doorwayiframe — the map loads inside map-embed.kaleidr.com under Kaleidr's own CSP.
Required scopemaps.
Minimum planFree — 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 referenceTile — attributes (style-id, center, zoom, pitch, bearing), the handle matrix, setStyle.
  • GuideUse 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.