Langue
Français

Intégrer des cartes

Une fois que vous avez publié une carte, elle est disponible sous forme de visionneuse intégrée en lecture seule, que vous pouvez insérer dans votre propre site web, application ou portail.

Cette page décrit l'intégration d'une carte publiée pour des lecteurs qui n'ont aucun accès à Fabric : un site public, un portail client. Si vous intégrez plutôt la carte dans votre propre application interne, où chaque lecteur se connecte avec son propre compte professionnel et ne doit voir que ses propres données, consultez Intégration pour votre organisation. Ce mode est en direct plutôt que publié, et applique votre sécurité au niveau des lignes de Fabric à chaque lecteur.

Fonctionnement

Une carte publiée est servie depuis une URL comme https://embed.iconmap.ai/v/pub_XXXX. Vous placez cette URL dans un <iframe> sur votre page, et la carte s'affiche dans le contenu : entièrement interactive pour le déplacement et le zoom, avec les contrôles que vous avez activés (navigation, échelle, projection, sélecteur de fond de carte, affichage des couches), mais en lecture seule : les lecteurs ne peuvent ni modifier la carte ni accéder à l'expérience de création.

Données et accès

  • La carte intégrée ne lit que les fichiers publiés figés de votre OneLake ; les données et l'élément Fabric sous-jacents ne sont jamais exposés.
  • L'accès est régi par les paramètres de publication : lien anonyme, jetons signés et liste d'origines autorisées.
  • Une identité de lecture dédiée sert les fichiers publiés ; votre administrateur la configure une seule fois (voir Sécurité et autorisations).
  • Comme la carte intégrée ne lit que ces fichiers publiés, les images des modèles 3D qui proviennent de chemins OneLake dans vos données ne sont pas affichées. Utilisez plutôt des URL web ou du SVG dans les données ; consultez Texte et images sur les modèles 3D.

Piloter la carte depuis votre page

La page qui héberge la carte peut la piloter en JavaScript (déplacer la caméra, afficher et masquer des couches, appliquer des filtres et des segments, sélectionner des entités, enregistrer et restaurer des vues) et être informée de ce que fait le lecteur, à la manière de la bibliothèque cliente Power BI Embedded pour les rapports. L'auteur de la carte décide, dans la boîte de dialogue de publication, quels sites peuvent le faire et quels types de commandes ils peuvent utiliser.

Développeurs : consultez l'Embed API. Les pages qui ne peuvent pas exécuter de script peuvent tout de même ouvrir une carte dans un état choisi grâce à un lien profond.

Contrôles de la vue de lecture

Vous décidez quels contrôles la visionneuse intégrée propose : vous pouvez ainsi présenter aussi bien une carte verrouillée à l'allure statique qu'une carte entièrement explorable, avec changement de fond de carte et affichage des couches.

Étapes suivantes