Interagire con la mappa

Eventi dell'interfaccia utente

Questa pagina descrive gli eventi interattivi e le notifiche di modifica dello stato che puoi ascoltare e gestire in modo programmatico quando utilizzi le mappe 3D. JavaScript all'interno del browser è basato su eventi, ovvero risponde alle interazioni degli utenti generando eventi che il programma può ascoltare ed eseguire il codice di conseguenza.

Esistono due tipi principali di eventi:

  • Gli eventi di interazione dell'utente, ad esempio i clic del mouse, vengono propagati dall'area visibile della mappa 3D al codice. Questi eventi ti consentono di rispondere alle azioni dirette degli utenti nell'ambiente delle mappe 3D.
  • Le notifiche di modifica dello stato riflettono gli aggiornamenti ai modelli dei dati delle mappe 3D sottostanti e allo stato del rendering, utilizzando uno schema di denominazione property_changed convenzionale.

Ogni oggetto dell'API di mappatura 3D espone un insieme di eventi denominati per i quali il programma può registrare listener di eventi ed eseguire la logica quando si verificano questi eventi utilizzando la funzione addEventListener() integrata. L'esempio seguente illustra gli eventi comuni che si verificano durante l'interazione di un utente con una mappa 3D.

L'esempio seguente mostra quali eventi vengono attivati quando un utente interagisce con la mappa:

Limitazioni relative alla fotocamera

Potrebbe essere auspicabile controllare la panoramica e l'altitudine massima della videocamera oppure creare limiti latitudine/longitudine che limitino il movimento dell'utente in una determinata mappa. Puoi farlo utilizzando le restrizioni della fotocamera.

Per un esempio di come funzionano e come vengono implementate le limitazioni della fotocamera, guarda la demo.