Interagire con la mappa
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
In questa pagina vengono descritti gli eventi dell'interfaccia utente e gli eventi di errore che puoi ascoltare e gestire in modo programmatico.
Eventi dell'interfaccia utente
Questa sezione illustra 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, vale a dire che 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
all'interno dell'ambiente delle mappe 3D. Visualizza
esempio.
- 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
gmp-propertychange convenzionale.
Ogni oggetto 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.
Il seguente esempio mostra quali eventi vengono attivati quando un utente interagisce con
la mappa:
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-04-29 UTC.
[null,null,["Ultimo aggiornamento 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:"]]
