Pular para o conteúdo principal

Usar um mapa-base projetado

Incorpore um mapa-base projetado da Kaleidr como iframe, selecionado por style id e autorizado pela sua chave publishable. Tile funciona em todos os planos, incluindo Free — uma chave Free-tier é criada por padrão com escopo maps e admissão do produto tile.

A origin da sua página deve estar na allowlist da chave e ser servida via HTTP(S) — consulte Obter uma chave de 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>

Os styles disponíveis incluem kaleidr-morning, kaleidr-afternoon, kaleidr-night, kaleidr-editorial, kaleidr-plain. Consulte Tiles.

Passagem da câmera​

center, zoom, pitch e bearing são todos respeitados em tile — tanto como attributes quanto via handle.setCamera(...) após o mount.

Troca de style em tempo real​

O tile handle expõe 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 é exposto somente no tile handle — chamá-lo em chat, editor ou viewer registra um aviso [kaleidr] e retorna.

Medição​

O acesso ao basemap faz parte da sua conta Kaleidr: o escopo maps da sua chave o autoriza, e o uso conta para o map-loads allowance do seu plano — o mesmo pool usado por aberturas de mapas compartilhados e visualizações de mapas incorporados. Não existe uma chave tile separada nem uma tile API sem autenticação.

Hospedar o CDN do basemap por conta própria​

Clientes Enterprise podem servir tiles de um CDN independente. Aponte o iframe do produto Tile para esse deployment com viewer-base (attribute) ou viewerBase (mount option). Isso é independente da loader base (base / __KALEIDR_EMBED_BASE__) — consulte CDN versioning.