Maps SDK — URL/Embed

Acrescentar parâmetros na URL permite carregar o mapa de acordo com as suas necessidades.

Adicione essas condições no final da URL, após um sinal de &.


Layout

Utilize um dos seguintes parâmetros, ou uma combinação deles, para poder alterar o que será mostrado no mapa:

Parâmetro Valor Efeito
bottomNavigation false Retira a barra inferior
appBar false Retira a barra superior
displayZoomButton false Retira os botões de zoom
displayFloorsButton false Retira o botão para troca de andares
search false Retira o campo de busca (em telas grandes)
splash false Retira a splash screen
navBar false Retira a barra de navegação
poiDetails false Retira a opção de ver detalhes de um ponto no mapa
embed true Retira todas as opções de interface
enableMicSearch true | false Habilita ou desabilita a busca por voz
Busca por voz

No WebView do iOS ou Android, use enableMicSearch=true e verifique as permissões em Setup. No modo Web a busca por áudio vem habilitada; use enableMicSearch=false para desabilitar.

Exemplo utilizando embed=true:

URL
https://app.zapt.tech/#/map?placeId={MapId}&embed={true}

Exemplo utilizando bottomNavigation, appBar e search:

URL
https://app.zapt.tech/#/map?placeId={MapId}&bottomNavigation={false}&appBar={true}&search={true}
Campo de busca

O campo de busca somente aparece no modo de exibição TV. Em celular e tablet a barra superior é encarregada pela busca. Veja os modos de exibição.


Iniciar Mapa em um Andar

Para abrir o mapa em um andar específico utilize o parâmetro floorId com o valor do identificador do mapa do andar. Consulte esse ID no Zapt Portal.

Andar Inicial: floorId=numeroDoAndar

Exemplo utilizando floorId=2:

URL
https://app.zapt.tech/#/map?placeId={MapId}&floorId={2}

Observação: Também é possível trocar o andar utilizando o ID do mapa, que contém o ID do andar: https://app.zapt.tech/#/map?placeId=MapId-floor2


Centralizar

Em um Ponto de Interesse

Para abrir o mapa centralizado em um Ponto de Interesse (PoI) é necessário passar o seu id como parâmetro da seguinte maneira:

Centralizar em um PoI: poi=IdDoPoi

Exemplo:

URL
https://app.zapt.tech/#/map?placeId={MapId}&poi={PoiId}

Em uma coordenada

Para abrir o mapa centralizado em uma coordenada é necessário passar as coordenadas horizontal (x) e vertical (y) como parâmetro da seguinte maneira:

Centralizar em uma coordenada: centerX=x, centerY=y

Exemplo:

URL
https://app.zapt.tech/#/map?placeId={MapId}&centerX={x}&centerY={y}

Traçar rotas

Com Pontos de Interesse

Uma rota pode ser traçada entre dois Pontos de Interesse (PoI) através de parâmetros na URL:

Parâmetro de ponto de origem: fromPoi=IdPoiOrigem

Parâmetro de ponto de destino: toPoi=IdPoiDestino

Exemplo:

URL
https://app.zapt.tech/#/map?placeId={MapId}&fromPoi={OriginPoiId}&toPoi={DestinationPoiId}
https://app.zapt.tech/#/map?placeId={MapId}&toPoi={DestinationPoiId}

É possível adicionar somente o parâmetro do ponto de destino. Nesse caso a rota será traçada a partir da entrada principal, se houver. Se apenas o ponto de partida estiver inserido, nada acontecerá.

Com coordenadas

Uma rota pode ser traçada entre duas posições passando as coordenadas horizontal (x) e vertical (y) e altura (z) como parâmetro da seguinte maneira:

Parâmetro de ponto de origem: fromCoordinateX=x, fromCoordinateY=y, fromCoordinateZ=z

Parâmetro de ponto de destino: toCoordinateX=x, toCoordinateY=y, toCoordinateZ=z

Exemplo:

URL
https://app.zapt.tech/#/map?placeId={MapId}&fromCoordinateX={originX}&fromCoordinateY={originY}&fromCoordinateZ={originZ}&toCoordinateX={destinationX}&toCoordinateY={destinationY}&toCoordinateZ={destinationZ}

https://app.zapt.tech/#/map?placeId={MapId}&toCoordinateX={destinationX}&toCoordinateY={destinationY}&toCoordinateZ={destinationZ}

É possível adicionar somente o parâmetro do ponto de destino. Nesse caso a rota será traçada a partir da entrada principal, se houver. Se apenas o ponto de partida estiver inserido, nada acontecerá.


Definir zoom

Pode-se definir o zoom do mapa passando um valor na URL:

Definir zoom: zoom=x, mínimo ≤ x ≤ máximo, onde o mínimo e o máximo são definidos na configuração do mapa.

Exemplo:

URL
https://app.zapt.tech/#/map?placeId={MapId}&zoom={-1}

Rotacionar mapa

Pode-se rotacionar o mapa passando o ângulo em graus na URL:

Rotacionar mapa: rotation=x, 0 ≤ x ≤ 360.

Exemplo:

URL
https://app.zapt.tech/#/map?placeId={MapId}&rotation={60}

Desenhar marcador

Pode-se aplicar um marcador do tipo gota no mapa passando as coordenadas na URL:

Parâmetros das coordenadas: markerX=1000, markerY=1000, markerZ=1

Exemplo:

URL
https://app.zapt.tech/#/map?placeId={MapId}&markerX={1000}&markerY={1000}&markerZ={1}

Customização do "Ver Mais"

No mapa e na lista é possível customizar a ação do botão "Ver Mais". Essa customização é interessante para casos como direcionar a página de detalhes de PoI para seu site ou seu App.

Para alterar a URL padrão do botão "Ver mais" utilize o parâmetro de URL seeMoreCallback. Conforme abaixo:

URL
https://app.zapt.tech/#/map?placeId=-ltvysf4acgzdxdhf81y&seeMoreCallback=www.zapt.tech/:poiId/:poiExternalId

O aplicativo irá substituir a palavra-chave :poiId pelo Id. do Ponto de Interesse e :poiExternalId pelo Id. Externo cadastrado no Ponto de Interesse, e redirecionar para URL resultante, conforme exemplo abaixo:

Parâmetros Disponíveis

Atributo Descrição
:poiId Id. do Ponto de Interesse
:spaceId Id. do Espaço
:poiExternalId Id Externo do Ponto de Interesse
:spaceExternalId Id Externo do Espaço

Comportamento Padrão

Caso algum dos parâmetros não seja informado, ele será adicionado ao final da URL do Ver mais, como parâmetro de pesquisa, caso exista, conforme abaixo:

URL
https://app.zapt.tech/#/map?placeId=-nzsg4lxxn8h8vjsfi-c&seeMoreCallback=www.zapt.tech?poi=12&poiId=12&spaceId=12&spaceExternalId=12&poiExternalId=12