Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
En esta página, se describen los eventos de interfaz de usuario y de error que puedes escuchar y gestionar de forma programática.
Eventos de interfaz de usuario
En esta sección, se describen los eventos interactivos y las notificaciones de cambio de estado que puedes escuchar y controlar de forma programática cuando trabajas con mapas 3D. Dentro del navegador, JavaScript se basa en eventos, lo que significa que responde a las interacciones del usuario mediante la generación de eventos que tu programa puede escuchar y ejecutar código según corresponda.
Hay dos tipos principales de eventos:
Los eventos de interacción del usuario (como los clics del mouse) se propagan desde el viewport del mapa 3D a tu código. Estos eventos te permiten responder a acciones directas del usuario en el entorno del mapa 3D. Ver muestra.
Las notificaciones de cambio de estado reflejan las actualizaciones de los modelos de datos de mapas 3D subyacentes y el estado de renderización, mediante un esquema de nombres gmp-propertychange convencional.
Cada objeto de la API de asignación en 3D expone un conjunto de eventos con nombre para los que tu programa puede registrar objetos de escucha de eventos y ejecutar lógica cuando esos eventos ocurren mediante la función addEventListener() integrada.
En el siguiente ejemplo, se muestra qué eventos se activan cuando un usuario interactúa con el mapa:
[null,null,["Última actualización: 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:"]]
