Sprache
Deutsch

Karten einbetten

Sobald Sie eine Karte veröffentlichen, steht sie als schreibgeschützter eingebetteter Viewer bereit, den Sie in Ihre eigene Website, App oder Ihr Portal einfügen können.

Diese Seite beschreibt das Einbetten einer veröffentlichten Karte für Betrachter ohne Fabric-Zugriff, etwa auf einer öffentlichen Website oder in einem Kundenportal. Wenn Sie stattdessen in Ihre eigene interne Anwendung einbetten, in der sich jeder Betrachter mit seinem eigenen Geschäftskonto anmeldet und nur seine eigenen Daten sehen soll, lesen Sie Einbetten für Ihre Organisation. Dieser Modus ist live statt veröffentlicht und wendet Ihre Fabric-Sicherheit auf Zeilenebene pro Betrachter an.

Funktionsweise

Eine veröffentlichte Karte wird über eine URL wie https://embed.iconmap.ai/v/pub_XXXX bereitgestellt. Sie platzieren diese URL in einem <iframe> auf Ihrer Seite, und die Karte erscheint direkt in der Seite: vollständig interaktiv zum Verschieben und Zoomen, dazu alle Steuerelemente, die Sie aktiviert haben (Navigation, Maßstab, Projektion, Grundkartenwechsel, Ebenenumschaltung), aber schreibgeschützt. Betrachter können die Karte nicht ändern und gelangen nicht in die Bearbeitungsumgebung.

Daten und Zugriff

  • Die eingebettete Karte liest nur die eingefrorenen veröffentlichten Dateien aus Ihrem OneLake. Die zugrunde liegenden Fabric-Daten und das Element werden nie offengelegt.
  • Der Zugriff wird über die Veröffentlichungseinstellungen gesteuert: anonymer Link, signierte Token und eine Positivliste zulässiger Ursprünge.
  • Zum Bereitstellen der veröffentlichten Dateien wird eine eigene Leseidentität verwendet. Ihr Administrator richtet diese einmalig ein (siehe Sicherheit & Berechtigungen).
  • Da die eingebettete Karte nur diese veröffentlichten Dateien liest, werden Bilder auf 3D-Modellen, die aus OneLake-Pfaden in Ihren Daten stammen, nicht angezeigt. Verwenden Sie stattdessen Web-URLs oder SVG in den Daten, siehe Text und Bilder auf 3D-Modellen.

Die Karte von Ihrer Seite aus steuern

Die Seite, die die Karte einbettet, kann sie mit JavaScript steuern: die Kamera bewegen, Ebenen ein- und ausblenden, Filter und Datenschnitte anwenden, Features auswählen, Ansichten speichern und wiederherstellen. Außerdem erfährt sie, was der Leser tut, ähnlich wie die Clientbibliothek von Power BI Embedded bei Berichten. Der Autor der Karte legt im Veröffentlichungsdialog fest, welche Websites dies dürfen und welche Arten von Befehlen sie verwenden dürfen.

Entwickler: siehe Embed API. Seiten, die kein Skript ausführen können, können eine Karte trotzdem über einen Deep Link in einem gewählten Zustand öffnen.

Steuerelemente in der Leseansicht

Sie legen fest, welche Steuerelemente der eingebettete Viewer anbietet. So reicht die Spanne von einer gesperrten, statisch wirkenden Karte bis zu einer vollständig erkundbaren Karte mit Grundkartenwechsel und Ebenenumschaltung.

Nächste Schritte