Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Halaman ini menjelaskan peristiwa antarmuka pengguna dan peristiwa error yang dapat Anda proses dan tangani secara terprogram.
Peristiwa Antarmuka Pengguna
Bagian ini menguraikan peristiwa interaktif dan notifikasi perubahan status yang dapat Anda proses dan tangani secara terprogram saat menggunakan peta 3D. JavaScript dalam browser berbasis peristiwa, yang berarti JavaScript merespons interaksi pengguna dengan menghasilkan peristiwa yang dapat dideteksi dan dijalankan oleh program Anda.
Ada dua jenis peristiwa utama:
Peristiwa interaksi pengguna (seperti klik mouse) disebarkan dari area tampilan peta 3D ke kode Anda. Peristiwa ini memungkinkan Anda merespons tindakan pengguna langsung dalam lingkungan peta 3D. Lihat
contoh.
Notifikasi perubahan status mencerminkan pembaruan pada model data peta 3D dan status rendering yang mendasarinya, yang menggunakan skema penamaan gmp-propertychange konvensional.
Setiap objek API pemetaan 3D mengekspos sekumpulan peristiwa bernama yang dapat didaftarkan
oleh pemroses peristiwa dan mengeksekusi logika saat peristiwa tersebut terjadi menggunakan
fungsi addEventListener() bawaan.
Contoh berikut menampilkan peristiwa yang dipicu saat pengguna berinteraksi dengan peta:
[null,null,["Terakhir diperbarui pada 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:"]]
