Insertar mapas

Una vez que publica un mapa, queda disponible como un visor insertado de solo lectura que puede colocar en su propio sitio web, aplicación o portal.

Esta página trata la inserción de un mapa publicado para usuarios que no tienen acceso a Fabric: un sitio público, un portal de clientes. Si, en cambio, va a insertarlo en su propia aplicación interna, donde cada usuario inicia sesión con su propia cuenta profesional y solo debe ver sus propios datos, consulte Inserción para su organización. Ese modo funciona en vivo en lugar de publicado, y aplica la seguridad de nivel de fila de Fabric a cada usuario.

Cómo funciona

Un mapa publicado se sirve desde una URL como https://embed.iconmap.ai/v/pub_XXXX. Coloque esa URL en un <iframe> de su página y el mapa aparecerá integrado: totalmente interactivo para desplazarse y hacer zoom, además de los controles que haya habilitado (navegación, escala, proyección, cambio de mapa base, activación de capas), pero de solo lectura: los usuarios no pueden cambiar el mapa ni acceder a la experiencia de creación.

Datos y acceso

  • El mapa insertado solo lee los archivos publicados congelados de su OneLake; los datos y el elemento de Fabric subyacentes nunca se exponen.
  • El acceso se rige por la configuración de publicación: vínculo anónimo, tokens firmados y una lista de orígenes permitidos.
  • Para servir los archivos publicados se usa una identidad lectora dedicada; su administrador la configura una sola vez (consulte Seguridad y permisos).
  • Como el mapa insertado solo lee esos archivos publicados, no se muestran las imágenes de los modelos 3D que proceden de rutas de OneLake de sus datos. Use en su lugar URL web o SVG en los datos; consulte Texto e imágenes en modelos 3D.

Controlar el mapa desde su página

La página que hospeda el mapa puede controlarlo desde JavaScript (mover la cámara, mostrar y ocultar capas, aplicar filtros y segmentaciones, seleccionar entidades, guardar y restaurar vistas) y recibir información sobre lo que hace el lector, de forma muy parecida a lo que hace la biblioteca cliente de Power BI Embedded con los informes. El autor del mapa decide, en el cuadro de diálogo de publicación, qué sitios pueden hacerlo y qué tipos de comandos pueden usar.

Desarrolladores: consulten la Embed API. Las páginas que no pueden ejecutar scripts pueden abrir igualmente un mapa en un estado concreto con un vínculo profundo.

Controles de la vista de lectura

Usted decide qué controles ofrece el visor insertado, de modo que puede presentar desde un mapa bloqueado de aspecto estático hasta uno totalmente explorable, con cambio de mapa base y activación de capas.

Pasos siguientes