Zum Hauptinhalt springen

Viewer — veröffentlichte Karte einbetten

product="viewer" bettet eine veröffentlichte Kaleidr-Karte anhand ihrer Share- ID in ein iframe ein. Sie besitzt ihre eigene Karte; du steuerst sie über die kaleidr-embed:*-postMessage-Schnittstelle.

  • Einbindung: iframe — die Karte wird innerhalb von map-embed.kaleidr.com geladen.
  • Erforderlicher Scope: keiner. Viewer ist schlüssellos — die Share-Autorisierung ist die Berechtigung.
  • Mindestplan: Free — jeder mit einer Share-ID kann einen Viewer in jedem Tarif einbetten.

share-id ist erforderlich — fehlt sie, wird beim Bundle-Laden ein Fehler ausgelöst. Das Übergeben eines Publishable Key an ein Viewer-Embed wird mit product_not_allowed abgelehnt.

Mount​

<kaleidr-map product="viewer" share-id="abcd1234"
             center="-0.12,51.5" zoom="11" style="height:520px"></kaleidr-map>

Handle​

const handle = Kaleidr.mount('#map', { product: 'viewer', shareId: 'abcd1234' });
handle.setCamera({ center: [-0.12, 51.5], zoom: 12, duration: 800 });
handle.destroy();

Vom Publisher festgelegte erlaubte Domains gelten weiterhin — eine auf bestimmte Websites beschränkte Karte wird auch mit Share-ID anderswo nicht gerendert. Siehe Karte einbetten.