デザインされたベースマップを使用

style id で選択し publishable key で認証された Kaleidr designed basemap を iframe として埋め込みます。Tile は Free を含むすべての plan で動作します — Free-tier key はデフォルトで maps scope と tile product admission を持って 発行されます。

ページの 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>

利用可能な style には kaleidr-morning, kaleidr-afternoon, kaleidr-night, kaleidr-editorial, kaleidr-plain があります。 Tiles を参照してください。

カメラの pass-through

center, zoom, pitch, bearing は tile ですべて反映されます — attribute としても、mount 後の handle.setCamera(...) 経由でも利用できます。

Live style swap

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] warning が記録され、そのまま戻ります。

Metering

Basemap access は Kaleidr account の一部です。key の maps scope が アクセスを認証し、使用量は plan の map-loads allowance に計上されます — shared-map の open と embedded map view が使う 同じ pool です。別の tile key や unauthenticated tile API は ありません。

Basemap CDN の self-hosting

Enterprise customer は独立した CDN から tile を配信できます。 Tile product iframe をその deployment に向けるには viewer-base（attribute）または viewerBase（mount option）を使用します。これは loader base（base / __KALEIDR_EMBED_BASE__）とは独立しています — CDN versioning を参照してください。