Harita ile etkileşim
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Bu sayfada, programlama yoluyla dinleyebileceğiniz ve işleyebileceğiniz kullanıcı arayüzü etkinlikleri ve hata etkinlikleri açıklanmaktadır.
Kullanıcı Arayüzü Etkinlikleri
Bu bölümde, 3D haritalarla çalışırken dinleyebileceğiniz ve programatik olarak işleyebileceğiniz etkileşimli etkinlikler ve durum değişikliği bildirimleri özetlenmektedir. Tarayıcıdaki JavaScript olay odaklıdır, yani programınızın dinleyip kodu buna uygun şekilde yürütebileceği etkinlikler oluşturarak kullanıcı etkileşimlerine yanıt verir.
İki temel etkinlik türü vardır:
- Kullanıcı etkileşimi etkinlikleri (fare tıklamaları gibi), 3D harita görüntü alanından kodunuza yayılır. Bu etkinlikler, 3D harita ortamındaki
doğrudan kullanıcı işlemlerine yanıt vermenize olanak tanır. Örneği görüntüleyin.
- Durum değişikliği bildirimleri, geleneksel bir
gmp-propertychange
adlandırma şeması kullanılarak temel 3D harita veri modelleri ve oluşturma durumunda yapılan güncellemeleri yansıtır.
Her 3D eşleme API'si nesnesi, programınızın yerleşik addEventListener()
işlevini kullanarak etkinlik işleyicileri kaydedip mantığı yürütebileceği bir dizi adlandırılmış etkinlik gösterir.
Aşağıdaki örnekte, kullanıcı haritayla etkileşimde bulunurken hangi etkinliklerin tetiklendiği gösterilmektedir:
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-04-29 UTC.
[null,null,["Son güncelleme tarihi: 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:"]]