Zum Hauptinhalt springen

Eine gestaltete Basemap verwenden

Bette eine gestaltete Kaleidr-Basemap als iframe ein, ausgewählt per Style-ID und autorisiert durch deinen Publishable Key. Tile läuft in jedem Tarif, einschließlich Free — ein Free-Tier-Key wird standardmäßig mit maps-Scope und tile-Produktzulassung erstellt.

Der Origin deiner Seite muss in der Allowlist des Schlüssels stehen und über HTTP(S) ausgeliefert werden — siehe API-Schlüssel erhalten.

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

Verfügbare Styles umfassen kaleidr-morning, kaleidr-afternoon, kaleidr-night, kaleidr-editorial, kaleidr-plain. Siehe Tiles.

Kamera-Durchleitung​

center, zoom, pitch und bearing werden bei Tile vollständig berücksichtigt — sowohl als Attribute als auch über handle.setCamera(...) nach dem Mounten.

Live-Style-Wechsel​

Das Tile-Handle stellt setStyle(styleId) bereit:

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 ist ausschließlich auf dem Tile-Handle verfügbar — ein Aufruf auf Chat, Editor oder Viewer protokolliert eine [kaleidr]-Warnung und kehrt zurück.

Messung​

Basemap-Zugriff ist Teil deines Kaleidr-Kontos: Der maps-Scope auf deinem Schlüssel autorisiert ihn, und die Nutzung zählt zum Map-Loads-Kontingent deines Plans — demselben Pool, aus dem auch geöffnete freigegebene Karten und eingebettete Kartenansichten schöpfen. Es gibt keinen separaten Tile-Key und keine unauthentifizierte Tile-API.

Basemap-CDN selbst hosten​

Enterprise-Kunden können Tiles über ein unabhängiges CDN bereitstellen. Richte das iframe des Tile-Produkts mit viewer-base (Attribut) oder viewerBase (Mount-Option) auf dieses Deployment. Dies ist unabhängig von der Loader-Base (base / __KALEIDR_EMBED_BASE__) — siehe CDN versioning.