Interagir com o mapa
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
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
Nesta seção, 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 responder a ações diretas do usuário dentro do ambiente do mapa 3D. Exemplo.
- 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
gmp-propertychange convencional.
Cada objeto da API de mapeamento 3D expõe um conjunto de eventos nomeados para os quais 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 mostra quais eventos são acionados quando um usuário interage com o mapa:
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-04-29 UTC.
[null,null,["Última atualização 2025-04-29 UTC."],[],[],null,["\u003cbr /\u003e\n\n| This product or feature is in Preview (pre-GA). Pre-GA products and features might have limited support, and changes to pre-GA products and features might not be compatible with other pre-GA versions. Pre-GA Offerings are covered by the [Google\n| Maps Platform Service Specific Terms](https://cloud.google.com/maps-platform/terms/maps-service-terms). For more information, see the [launch stage\n| descriptions](/maps/launch-stages).\n\n\u003cbr /\u003e\n\nThis page describes the user interface events and error events that you can\nlisten for and handle programmatically.\n\nUser Interface Events\n\nThis section outlines the interactive events and state change notifications you\ncan listen for and handle programmatically when working with 3D maps. JavaScript\nwithin the browser is event-driven, meaning it responds to user interactions by\ngenerating events that your program can listen to and execute code accordingly.\n\nThere are two main types of events:\n\n- User interaction events (such as mouse clicks) are propagated from the 3D map viewport to your code. These events allow you to respond to direct user actions within the 3D map environment. [View\n sample](/maps/documentation/javascript/examples/3d/polygon-click-event).\n- State change notifications reflect updates to the underlying 3D map data models and rendering state, using a conventional `gmp-propertychange` naming scheme.\n\nEach 3D mapping API object exposes a set of named events that your program can\nregister event listeners for and execute logic when those events occur using the\nbuilt-in `addEventListener()` function.\n\nThe following sample shows which events are triggered as a user interacts with\nthe map:"]]
