Aller au contenu principal

Tiles — intégrer un fond de carte conçu

product="tile" intègre un fond de carte Kaleidr conçu dans un iframe à partir de son ID de style. Il possède sa propre carte ; pilotez-le via l’interface postMessage kaleidr-embed:*.

  • Mode d’intégration : iframe — la carte se charge dans map-embed.kaleidr.com.
  • Portée requise : maps.
  • Forfait minimum : Free — une clé Free est créée avec la portée ["maps"] et l’autorisation produit ["tile"]. Tile est le seul produit avec clé utilisable sur Free.

Avant de commencer​

  • L’origine de votre page doit figurer dans la liste des origines autorisées de la clé. Sinon, l’échange de session échoue avec 403 session_origin_mismatch. file:// n’envoie aucun Origin et échoue toujours — utilisez HTTP(S). Consultez Obtenir une clé API.
  • Votre CSP doit autoriser le chargeur SDK et l’hôte de frame map-embed.kaleidr.com. Aucun hôte d’images de tuiles/fournisseur n’est nécessaire pour un embed Tile uniquement — ceux-ci se trouvent dans l’iframe Kaleidr. Consultez Content Security Policy.

Montage​

<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>

Les IDs de style intégrés incluent kaleidr-morning, kaleidr-afternoon, kaleidr-night, kaleidr-editorial, kaleidr-plain (ainsi que les alias du registre).

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) est exposé uniquement sur le handle tile. L’appeler sur chat, editor ou viewer enregistre un avertissement [kaleidr] puis retourne.

Une clé, un pool

Le publishable-key (portée maps) autorise l’accès au fond de carte — il n’existe pas de clé de tuile distincte — et chaque session de fond de carte compte dans l’allocation mensuelle partagée de chargements de cartes de votre forfait. Consultez Utiliser les tuiles.