Aller au contenu principal

Utiliser un fond de carte conçu

Intégrez un fond de carte Kaleidr conçu sous forme d’iframe, sélectionné par style id et autorisé par votre clé publishable. Tile fonctionne sur tous les forfaits, y compris Free — une clé Free-tier est créée par défaut avec le scope maps et l’autorisation produit tile.

L’origin de votre page doit figurer dans l’allowlist de la clé et être servi en HTTP(S) — consultez Obtenir une clé 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>

Les styles disponibles incluent kaleidr-morning, kaleidr-afternoon, kaleidr-night, kaleidr-editorial, kaleidr-plain. Consultez Tiles.

Transmission de la caméra​

center, zoom, pitch et bearing sont tous pris en compte sur tile — à la fois comme attributes et via handle.setCamera(...) après le mount.

Changement de style en direct​

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

Mesure​

L’accès au basemap fait partie de votre compte Kaleidr : le scope maps de votre clé l’autorise, et l’utilisation compte dans le map-loads allowance de votre forfait — le même pool utilisé par les ouvertures de cartes partagées et les vues de cartes intégrées. Il n’existe aucune clé tile distincte ni tile API non authentifiée.

Auto-héberger le CDN du basemap​

Les clients Enterprise peuvent servir les tiles depuis un CDN indépendant. Pointez l’iframe du produit Tile vers ce deployment avec viewer-base (attribute) ou viewerBase (mount option). Cela est indépendant de la loader base (base / __KALEIDR_EMBED_BASE__) — consultez CDN versioning.