Interagir com o mapa

Eventos da interface do usuário

Nesta página, descrevemos os eventos interativos e as notificações de mudança de estado que você pode detectar e processar programaticamente ao trabalhar com mapas 3D. O JavaScript no navegador é orientado por eventos, o que significa que ele responde às interações do usuário gerando eventos que o programa pode detectar e executar o código adequadamente.

Há dois tipos principais de eventos:

  • Os eventos de interação do usuário (como cliques do mouse) são propagados da janela de visualização do mapa 3D para seu código. Esses eventos permitem que você responda a ações diretas do usuário no ambiente do mapa 3D.
  • As notificações de mudança de estado refletem as atualizações dos modelos de dados do mapa 3D e do estado de renderização, usando um esquema de nomenclatura property_changed convencional.

Cada objeto da API de mapeamento 3D expõe um conjunto de eventos nomeados que o programa pode registrar listeners de eventos e executar a lógica quando esses eventos ocorrerem, usando a função addEventListener() integrada. O exemplo a seguir ilustra eventos comuns acionados quando um usuário interage com um mapa 3D.

O exemplo a seguir mostra quais eventos são acionados quando um usuário interage com o mapa:

Restrições da câmera

Pode ser desejável controlar a movimentação e a altitude máxima da câmera ou criar limites de latitude/longitude que restrinjam o movimento do usuário em um determinado mapa. Para fazer isso, use as restrições da câmera.

Para ver um exemplo de como as restrições de câmera funcionam e são implementadas, confira a demonstração.