Pular para o conteúdo principal

Tiles — incorpore um mapa-base projetado

product="tile" incorpora um mapa-base projetado da Kaleidr em um iframe pelo ID de estilo. Ele possui seu próprio mapa; controle-o pela interface postMessage kaleidr-embed:*.

  • Forma de integração: iframe — o mapa é carregado dentro de map-embed.kaleidr.com.
  • Escopo necessário: maps.
  • Plano mínimo: Free — uma chave Free é criada com o escopo ["maps"] e admissão do produto ["tile"]. Tile é o único produto com chave que o Free pode executar.

Antes de começar​

  • A origem da sua página deve estar na lista de origens permitidas da chave. Caso contrário, a troca de sessão falha com 403 session_origin_mismatch. file:// não envia nenhum Origin e sempre falha — use HTTP(S). Consulte Obter uma chave de API.
  • Sua CSP deve permitir o loader do SDK e o host de frame map-embed.kaleidr.com. Nenhum host de imagem de tile/fornecedor é necessário em uma incorporação somente de Tile — esses recursos ficam dentro do iframe da Kaleidr. Consulte Content Security Policy.

Montagem​

<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 IDs de estilo integrados incluem kaleidr-morning, kaleidr-afternoon, kaleidr-night, kaleidr-editorial, kaleidr-plain (e aliases do registro).

Handle​

const handle = Kaleidr.mount('#basemap', {
  product: 'tile',
  publishableKey: 'kld_pk_live_…',
  styleId: 'kaleidr-night',
});

handle.setCamera({ center: [2.35, 48.85], zoom: 12 });
handle.setStyle('kaleidr-editorial');   // live style swap — tile only
handle.destroy();

setStyle(styleId) é exposto apenas no handle de tile. Chamá-lo em chat, editor ou viewer registra um aviso [kaleidr] e retorna.

Uma chave, um pool

O publishable-key (escopo maps) autoriza o acesso ao mapa-base — não existe uma chave separada para tiles — e cada sessão de mapa-base conta para a franquia mensal compartilhada de carregamentos de mapas do seu plano. Consulte Usar tiles.