Manipular eventos de mapa

Este artigo mostra como usar a classe de evento de mapa. A propriedade realça os eventos no mapa e em camadas diferentes do mapa. Você também pode realçar eventos quando interage com um marcador HTML.

Interagir com o mapa

O exemplo de Eventos de Mapa destaca o nome dos eventos que estão disparando à medida que você interage com o mapa. Para obter o código-fonte deste exemplo, confira Código-fonte dos eventos de mapa.

Interagir com as camadas do mapa

O exemplo de Eventos de Camada destaca o nome dos eventos que estão disparando à medida que você interage com a Camada de Símbolos. A camada de polígono, bolha, linha e símbolo dão suporte ao mesmo conjunto de eventos. As camadas de mapa de calor e bloco não dão suporte a nenhum desses eventos. Para obter o código-fonte deste exemplo, confira Código-fonte dos eventos de camada.

Interagir com o marcador HTML

O exemplo de Eventos de camada do marcador HTML destaca o nome dos eventos que estão disparando à medida que você interage com a camada do marcador HTML. Para obter o código-fonte deste exemplo, confira Código-fonte de eventos de camada do marcador HTML.

A tabela a seguir lista todos eventos de classe de mapa compatíveis.

Evento	Descrição
boxzoomend	Acionado quando uma interação de "zoom da caixa de diálogo" termina.
boxzoomstart	Acionado quando uma interação de "zoom da caixa de diálogo" começa.
click	Acionado quando um dispositivo apontador é pressionado e liberado no mesmo ponto no mapa.
close	Acionado quando o popup é fechado manualmente ou programaticamente.
contextmenu	Acionado quando o botão direito do mouse é clicado.
data	Acionado quando os dados do mapa são carregados ou alterados.
dataadded	Acionado quando formas são adicionadas à DataSource.
dataremoved	Acionado quando formas são removidas da DataSource.
datasourceupdated	Acionado quando o objeto DataSource é atualizado.
dblclick	Acionado quando um dispositivo apontador é clicado duas vezes no mesmo ponto no mapa.
drag	Acionado repetidamente durante uma interação "arrastar para panorâmica" no mapa, pop-up ou marcador HTML.
dragend	Acionado quando uma interação "arrastar para panorâmica" termina no mapa, pop-up ou marcador HTML.
dragstart	Acionado quando uma interação "arrastar para panorâmica" começa no mapa, pop-up ou marcador HTML.
error	Acionado quando um erro ocorre.
idle	Acionado após o último quadro renderizado antes do mapa entrar em um estado "ocioso": Nenhuma transição de câmera está em andamento. Todos os blocos atualmente solicitados foram carregados. Todas as animações de esmaecimento/transição foram concluídas.
keydown	Acionado quando uma tecla é pressionada.
keypress	Acionado quando uma tecla que produz um caractere digitável (uma tecla ANSI) é pressionada.
keyup	Acionado quando uma tecla é solta.
layeradded	Acionado quando uma camada é adicionada ao mapa.
layerremoved	Acionado quando uma camada é removida do mapa.
load	Acionado imediatamente depois que todos os recursos necessários tiverem sido baixados e a primeira renderização visualmente completa do mapa tiver ocorrido.
mousedown	Acionado quando um dispositivo apontador é pressionado no mapa ou sobre um elemento.
mouseenter	Acionado quando um dispositivo apontador é movido inicialmente sobre o mapa ou sobre um elemento.
mouseleave	Acionado quando um dispositivo apontador é movido para fora do mapa ou de um elemento.
mousemove	Acionado quando um dispositivo apontador é movido no mapa ou em um elemento.
mouseout	Acionado quando um dispositivo apontador deixa a tela do mapa ou deixa um elemento.
mouseover	Acionado quando um dispositivo apontador é movido sobre o mapa ou sobre um elemento.
mouseup	Acionado quando um dispositivo apontador é liberado no mapa ou na parte superior de um elemento.
move	Acionado repetidamente durante uma transição animada de uma exibição para outra, como resultado de métodos ou de interação do usuário.
moveend	Acionado logo após o mapa concluir uma transição de uma exibição para outra, como resultado de métodos ou de interação do usuário.
movestart	Acionado imediatamente antes de o mapa começar uma transição de uma exibição para outra, como resultado de métodos ou de interação do usuário.
open	Acionado quando o popup é aberto manualmente ou programaticamente.
pitch	Acionado sempre que a inclinação do mapa (declive) muda como resultado de métodos ou de interação do usuário.
pitchend	Acionado imediatamente após a inclinação do mapa (declive) terminar de ser alterada como resultado de métodos ou de interação do usuário.
pitchstart	Acionado sempre que a inclinação do mapa (declive) inicia uma alteração como resultado de métodos ou de interação do usuário.
ready	Acionado quando os recursos de mapa mínimos necessários são carregados antes que o mapa esteja pronto para interação programática.
render	Acionado sempre que o mapa é desenhado na tela, como resultado de: Uma alteração na posição, no zoom, na inclinação ou no rumo do mapa. Uma alteração no estilo do mapa. Uma alteração em uma fonte DataSource. O carregamento de um bloco de vetor, arquivo GeoJSON, glifo ou sprite.
resize	Acionado imediatamente após o mapa ter sido redimensionado.
rotate	Acionado repetidamente durante uma interação "arrastar para girar".
rotateend	Acionado quando uma interação "arrastar para girar" termina.
rotatestart	Acionado quando uma interação "arrastar para girar" é iniciada.
shapechanged	Acionado quando uma propriedade de objeto de conformação é alterada.
sourcedata	Acionado quando uma das origens do mapa é carregada ou alterada, incluindo quando um bloco pertencente a uma origem é carregado ou alterado.
sourceadded	Acionado quando uma DataSource ou VectorTileSource é adicionada ao mapa.
sourceremoved	Acionado quando uma DataSource ou VectorTileSource é removida do mapa.
styledata	Acionado quando o estilo do mapa é carregado ou alterado.
styleimagemissing	Acionado quando uma camada tenta carregar, de um sprite de imagens, uma imagem que não existe
tokenacquired	Acionado quando um token de acesso do Microsoft Entra é obtido.
touchcancel	Acionado quando um evento touchcancel ocorre dentro do mapa.
touchend	Acionado quando um evento touchend ocorre dentro do mapa.
touchmove	Acionado quando um evento touchmove ocorre dentro do mapa.
touchstart	Acionado quando um evento touchstart ocorre dentro do mapa.
wheel	Acionado quando um evento de roda do mouse ocorre dentro do mapa.
zoom	Acionado repetidamente durante uma transição animada de um nível de zoom para outro, como resultado de métodos ou de interação do usuário.
zoomend	Acionado logo após o mapa concluir uma transição de um nível de zoom para outro, como resultado de métodos ou de interação do usuário.
zoomstart	Acionado imediatamente antes de o mapa começar uma transição de um nível de zoom para outro, como resultado de métodos ou de interação do usuário.

Próximas etapas

Consulte os seguintes artigos para obter exemplos de código completo:

Como usar o módulo de Serviços do Azure Mapas

Exemplos de código