Idioma
Português

Incorporar mapas

Depois que você publica um mapa, ele fica disponível como um visualizador incorporado somente para visualização, que você pode colocar no seu próprio site, aplicativo ou portal.

Esta página trata da incorporação de um mapa publicado para visualizadores que não têm acesso ao Fabric: um site público, um portal de clientes. Se, em vez disso, você estiver incorporando o mapa no seu próprio aplicativo interno, em que cada visualizador entra com a própria conta corporativa e deve ver somente os próprios dados, consulte Incorporar para sua organização. Esse modo é ao vivo, e não publicado, e aplica a segurança em nível de linha do Fabric a cada visualizador.

Como funciona

Um mapa publicado é servido a partir de uma URL como https://embed.iconmap.ai/v/pub_XXXX. Você coloca essa URL em um <iframe> na sua página, e o mapa aparece incorporado: totalmente interativo para deslocar e aplicar zoom, com os controles que você ativou (navegação, escala, projeção, seletor de mapa base, ativação de camadas), mas somente para visualização: os visualizadores não podem alterar o mapa nem chegar à experiência de criação.

Dados e acesso

  • O mapa incorporado lê apenas os arquivos publicados congelados do seu OneLake; os dados e o item subjacentes do Fabric nunca ficam expostos.
  • O acesso é governado pelas configurações de publicação: link anônimo, tokens assinados e uma lista de origens permitidas.
  • Uma identidade de leitura dedicada é usada para servir os arquivos publicados; seu administrador a configura uma única vez (consulte Segurança e permissões).
  • Como o mapa incorporado lê apenas esses arquivos publicados, as imagens em modelos 3D que vêm de caminhos do OneLake nos seus dados não são exibidas. Use URLs da Web ou SVG nos dados; consulte Texto e imagens em modelos 3D.

Controlar o mapa a partir da sua página

A página que hospeda o mapa pode comandá-lo com JavaScript (mover a câmera, mostrar e ocultar camadas, aplicar filtros e segmentações, selecionar feições, salvar e restaurar vistas) e ser informada do que o leitor faz, de forma semelhante ao que a biblioteca de cliente do Power BI Embedded faz para relatórios. O autor do mapa decide, na caixa de diálogo de publicação, quais sites podem fazer isso e quais tipos de comando podem usar.

Desenvolvedores: consultem a Embed API. Páginas que não podem executar scripts ainda podem abrir um mapa em um estado escolhido com um link direto.

Controles do modo de leitura

Você decide quais controles o visualizador incorporado oferece, então pode apresentar desde um mapa bloqueado com aparência estática até um mapa totalmente explorável, com troca de mapa base e ativação de camadas.

Próximas etapas