Interagir avec la carte
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Cette page décrit les événements de l'interface utilisateur et les événements d'erreur que vous pouvez écouter et traiter programmatiquement.
Événements de l'interface utilisateur
Cette section décrit les événements interactifs et les notifications de changement d'état que vous pouvez écouter et gérer de manière programmatique lorsque vous utilisez des cartes 3D. Le code JavaScript du navigateur est basé sur des événements, ce qui signifie qu'il répond aux interactions des utilisateurs en générant des événements que votre programme peut écouter et exécuter du code en conséquence.
Il existe deux principaux types d'événements:
- Les événements d'interaction utilisateur (tels que les clics de souris) sont propagés de la fenêtre d'affichage de la carte 3D vers votre code. Ces événements vous permettent de répondre aux actions directes de l'utilisateur dans l'environnement de carte 3D. Consultez un exemple.
- Les notifications de changement d'état reflètent les mises à jour des modèles de données de carte 3D sous-jacents et de l'état du rendu, à l'aide d'un schéma de dénomination
gmp-propertychange traditionnel.
Chaque objet d'API de cartographie 3D expose un ensemble d'événements nommés pour lesquels votre programme peut enregistrer des écouteurs d'événements et exécuter une logique lorsque ces événements se produisent à l'aide de la fonction addEventListener() intégrée.
L'exemple suivant montre les événements déclenchés lorsqu'un utilisateur interagit avec la carte:
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/04/29 (UTC).
[null,null,["Dernière mise à jour le 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:"]]
