Interagir com o mapa

Este produto ou recurso está em pré-lançamento (pré-GA). Os produtos e recursos em pré-GA têm suporte limitado, e é possível que as mudanças neles não sejam compatíveis com versões anteriores. Todos os itens em pré-GA são cobertos pelos Termos de Serviço da Plataforma Google Maps. Para mais detalhes, consulte as descrições da fase de lançamento.

Esta página descreve os eventos da interface do usuário e eventos de erro que você pode detectar e tratar de maneira programática.

Eventos da interface do usuário

Esta seção descreve os eventos interativos e as notificações de mudança de estado que você pode detectar e processar de forma programática ao trabalhar com mapas 3D. O JavaScript no navegador é orientado a eventos, ou seja, ele responde às interações do usuário gerando eventos que seu programa pode detectar e executar o código de acordo.

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. Com eles, é possível responder a ações diretas do usuário no ambiente do mapa 3D. Ver exemplo.
• As notificações de mudança de estado refletem atualizações nos modelos de dados de mapa 3D e no estado de renderização, usando um esquema de nomenclatura gmp-propertychange convencional.

Cada objeto da API 3D Mapping expõe um conjunto de eventos nomeados que seu programa pode registrar listeners de eventos e executar a lógica quando esses eventos ocorrem usando a função addEventListener() integrada.

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