Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Na tej stronie opisujemy zdarzenia interfejsu i błędy, które możesz wykrywać i obsługiwać automatycznie.
Zdarzenia w interfejsie
W tej sekcji przedstawiamy interaktywne zdarzenia i powiadomienia o zmianach stanu, które możesz nasłuchiwać i obsługiwać automatycznie podczas pracy z mapami 3D. Kod JavaScript w przeglądarce jest oparty na zdarzeniach, co oznacza, że reaguje na interakcje użytkownika, generując zdarzenia, na które nasz program może nasłuchiwać i odpowiednio wykonywać kod.
Wyróżniamy 2 główne typy zdarzeń:
Zdarzenia interakcji użytkownika (np. kliknięcia myszy) są przekazywane z widocznego obszaru mapy 3D do kodu. Zdarzenia te pozwalają reagować na bezpośrednie działania użytkowników w środowisku mapy 3D. Zobacz przykład
Powiadomienia o zmianach stanu odzwierciedlają aktualizacje bazowych modeli danych map 3D i stanu renderowania przy użyciu konwencjonalnego schematu nazewnictwa gmp-propertychange.
Każdy obiekt interfejsu API mapowania 3D udostępnia zbiór nazwanych zdarzeń, dla których Twój program może zarejestrować detektory zdarzeń i wykonywać logikę, gdy te zdarzenia wystąpią, przy użyciu wbudowanej funkcji addEventListener().
Poniższy przykład pokazuje, które zdarzenia są wywoływane, gdy użytkownik wchodzi w interakcję z mapą:
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 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:"]]
