Cómo interactuar con el mapa

Eventos de interfaz de usuario

En esta página, se describen los eventos interactivos y las notificaciones de cambio de estado que puedes escuchar y gestionar de forma programática cuando trabajas con mapas 3D. Dentro del navegador, JavaScript se basa en eventos, es decir, 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.
  • 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 property_changed 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 muestran los eventos comunes que se activan cuando un usuario interactúa con un mapa 3D.

En el siguiente ejemplo, se muestran los eventos que se activan cuando un usuario interactúa con el mapa:

Restricciones de la cámara

Es posible que quieras controlar el desplazamiento lateral de la cámara y la altitud máxima, o bien crear límites de latitud y longitud que restrinjan el movimiento de un usuario en un mapa determinado. Puedes hacerlo con las restricciones de la cámara.

Para ver un ejemplo de cómo funcionan y se implementan las restricciones de la cámara, consulta la demostración.