본문으로 건너뛰기

디자인된 베이스맵 사용

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(...)를 통해서도 사용할 수 있습니다.

실시간 style 변경​

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] 경고를 기록하고 반환합니다.

사용량 측정​

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 자체 호스팅​

Enterprise customer는 독립된 CDN에서 tile을 제공할 수 있습니다. Tile product iframe을 해당 deployment로 지정하려면 viewer-base(attribute) 또는 viewerBase(mount option)를 사용하세요. 이는 loader base(base / __KALEIDR_EMBED_BASE__)와 별개입니다 — CDN versioning을 참조하세요.