Manipular eventos de mapa

Este artigo mostra como usar a classe de eventos de mapa. A propriedade destaca eventos no mapa e em diferentes camadas do mapa. Você também pode destacar eventos ao interagir com um marcador HTML.

Interaja com o mapa

O exemplo de Eventos do Mapa destaca o nome dos eventos que são disparados à medida que você interage com o mapa. Para obter o código-fonte deste exemplo, consulte Mapear código-fonte de eventos.

Interagir com camadas de mapa

O exemplo de Eventos de Camada destaca o nome dos eventos que são disparados à medida que você interage com a Camada de Símbolos. O símbolo, a bolha, a linha e a camada de polígono suportam o mesmo conjunto de eventos. O mapa de calor e as camadas de mosaico não suportam nenhum destes eventos. Para obter o código-fonte deste exemplo, consulte Código-fonte de eventos de camada.

Interagir com marcador HTML

O exemplo de eventos de camada de marcador HTML destaca o nome dos eventos que são disparados à medida que você interage com a camada de marcador HTML. Para obter o código-fonte deste exemplo, consulte Código-fonte de eventos da camada de marcador HTML.

A tabela a seguir lista todos os eventos de classe de mapa suportados.

Evento	Descrição
boxzoomend	Acionado quando uma interação de "zoom de caixa" termina.
boxzoomstart	Acionado quando uma interação de "zoom de caixa" é iniciada.
click	Disparado quando um dispositivo apontador é pressionado e liberado no mesmo ponto do mapa.
close	Acionado quando o pop-up é fechado manualmente ou programaticamente.
contextmenu	Disparado quando o botão direito do mouse é clicado.
data	Acionado quando os dados do mapa são carregados ou alterados.
dataadded	Disparado DataSourcequando formas são adicionadas ao .
dataremoved	Disparado quando as formas são removidas do DataSource.
datasourceupdated	Disparado quando o DataSource objeto é atualizado.
dblclick	Disparado quando um dispositivo apontador é clicado duas vezes no mesmo ponto do mapa.
drag	Disparado repetidamente durante uma interação "arrastar para mover" 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 ocorre um erro.
idle	Disparado após o último quadro renderizado antes que o mapa entre em um estado "ocioso": Nenhuma transição de câmera está em andamento. Todos os blocos solicitados atualmente foram carregados. Todas as animações de desvanecimento/transição foram concluídas.
keydown	Disparado quando uma tecla é pressionada.
keypress	Acionado quando uma tecla que produz um caractere digitável (uma tecla ANSI) é pressionada.
keyup	Disparado quando uma chave é liberada.
layeradded	Disparado quando uma camada é adicionada ao mapa.
layerremoved	Disparado quando uma camada é removida do mapa.
load	Acionado imediatamente após todos os recursos necessários terem sido baixados e a primeira renderização visualmente completa do mapa ter ocorrido.
mousedown	Disparado quando um dispositivo apontador é pressionado dentro do mapa ou quando em cima de um elemento.
mouseenter	Acionado quando um dispositivo apontador é inicialmente movido sobre o mapa ou um elemento.
mouseleave	Disparado quando um dispositivo apontador é movido para fora do mapa ou de um elemento.
mousemove	Disparado quando um dispositivo apontador é movido dentro do mapa ou de um elemento.
mouseout	Disparado quando um dispositivo de ponto sai da tela do mapa, nosso deixa um elemento.
mouseover	Acionado quando um dispositivo apontador é movido sobre o mapa ou um elemento.
mouseup	Disparado quando um dispositivo apontador é liberado dentro do mapa ou quando em cima de um elemento.
move	Disparado repetidamente durante uma transição animada de uma visão para outra, como resultado da interação do usuário ou métodos.
moveend	Disparado logo após o mapa concluir uma transição de uma visualização para outra, como resultado da interação do usuário ou métodos.
movestart	Disparado pouco antes do mapa começar uma transição de uma visualização para outra, como resultado da interação do usuário ou métodos.
open	Disparado quando o pop-up é aberto manualmente ou programaticamente.
pitch	Disparado sempre que o pitch (tilt) do mapa muda como resultado da interação do usuário ou métodos.
pitchend	Disparado imediatamente após o pitch (tilt) do mapa terminar de mudar como resultado da interação do usuário ou métodos.
pitchstart	Disparado sempre que o pitch (tilt) do mapa começa uma mudança como resultado da interação do usuário ou métodos.
ready	Acionado quando os recursos mínimos de mapa necessários são carregados antes que o mapa esteja pronto para ser interagido programaticamente.
render	Disparado sempre que o mapa é desenhado para a tela, como resultado de: Uma alteração na posição, zoom, inclinação ou rolamento do mapa. Uma alteração no estilo do mapa. Uma alteração a uma DataSource fonte. O carregamento de um bloco vetorial, arquivo GeoJSON, glifo ou sprite.
resize	Disparado imediatamente após o mapa ter sido redimensionado.
rotate	Disparado repetidamente durante uma interação de "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 forma é alterada.
sourcedata	Acionado quando uma das fontes do mapa é carregada ou alterada, inclusive se um bloco pertencente a uma fonte é carregado ou alterado.
sourceadded	Disparado quando um DataSource ou VectorTileSource é adicionado ao mapa.
sourceremoved	Disparado quando um DataSource ou VectorTileSource é removido do mapa.
styledata	Acionado quando o estilo do mapa carrega ou muda.
styleimagemissing	Acionado quando uma camada tenta carregar uma imagem do sprite de imagem que não existe
tokenacquired	Acionado quando um token de acesso do Microsoft Entra é obtido.
touchcancel	Disparado quando ocorre um touchcancel evento no mapa.
touchend	Disparado quando ocorre um touchend evento no mapa.
touchmove	Disparado quando ocorre um touchmove evento no mapa.
touchstart	Disparado quando ocorre um touchstart evento no mapa.
wheel	Disparado quando ocorre um evento de roda do mouse dentro do mapa.
zoom	Disparado repetidamente durante uma transição animada de um nível de zoom para outro, como resultado da interação do usuário ou métodos.
zoomend	Disparado logo após o mapa concluir uma transição de um nível de zoom para outro, como resultado da interação do usuário ou métodos.
zoomstart	Disparado pouco antes do mapa começar uma transição de um nível de zoom para outro, como resultado da interação do usuário ou métodos.

Próximos passos

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

Usando o módulo Serviços do Azure Maps

Amostras de código