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 |
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:
https://app.zapt.tech/#/map?placeId={MapId}&embed={true}
Exemplo utilizando bottomNavigation, appBar e search:
https://app.zapt.tech/#/map?placeId={MapId}&bottomNavigation={false}&appBar={true}&search={true}
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:
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:
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:
https://app.zapt.tech/#/map?placeId={MapId}¢erX={x}¢erY={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:
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:
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:
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:
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:
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:
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:
https://app.zapt.tech/#/map?placeId=-nzsg4lxxn8h8vjsfi-c&seeMoreCallback=www.zapt.tech?poi=12&poiId=12&spaceId=12&spaceExternalId=12&poiExternalId=12