ui.Map.onChangeBounds
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Rejestruje wywołanie zwrotne, które jest wywoływane, gdy zmieniają się granice mapy. Jest wywoływane podczas przesuwania i powiększania mapy oraz gdy jej granice są zmieniane programowo.
Zwraca identyfikator, który można przekazać do funkcji unlisten(), aby wyrejestrować wywołanie zwrotne.
| Wykorzystanie | Zwroty |
|---|
Map.onChangeBounds(callback) | Ciąg znaków |
| Argument | Typ | Szczegóły |
|---|
to: ui.map | ui.Map | Instancja ui.Map. |
callback | Funkcja | Funkcja wywołania zwrotnego, która ma zostać wywołana po zmianie granic mapy. Funkcja wywołania zwrotnego otrzymuje 2 parametry: obiekt zawierający współrzędne nowego środka mapy (z kluczami lon, lat i zoom) oraz sam widżet mapy. |
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-26 UTC.
[null,null,["Ostatnia aktualizacja: 2025-07-26 UTC."],[[["\u003cp\u003eRegisters a callback function that is triggered whenever the map's boundaries are modified, including panning, zooming, and programmatic changes.\u003c/p\u003e\n"],["\u003cp\u003eProvides a unique ID that can be used with the \u003ccode\u003eunlisten()\u003c/code\u003e function to remove the registered callback.\u003c/p\u003e\n"],["\u003cp\u003eThe callback function receives the new map center coordinates (longitude, latitude, and zoom level) and the map widget instance as arguments.\u003c/p\u003e\n"]]],["The `onChangeBounds` function registers a callback to be executed whenever the map's bounds change due to panning, zooming, or programmatic updates. It returns a unique string ID for the callback. The callback function receives two parameters: an object with the new map center's longitude, latitude, and zoom level, and the map widget. The returned ID can be used with `unlisten()` to remove the registered callback.\n"],null,["# ui.Map.onChangeBounds\n\n\u003cbr /\u003e\n\nRegisters a callback that's fired when the map bounds change. This is fired during pan, zoom, and when the map's bounds are changed programmatically.\n\n\u003cbr /\u003e\n\nReturns an ID which can be passed to unlisten() to unregister the callback.\n\n| Usage | Returns |\n|--------------------------------|---------|\n| Map.onChangeBounds`(callback)` | String |\n\n| Argument | Type | Details |\n|----------------|----------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| this: `ui.map` | ui.Map | The ui.Map instance. |\n| `callback` | Function | The callback to fire when the map bounds change. The callback is passed two parameters: an object containing the coordinates of the new map center (with keys lon, lat, and zoom) and the map widget itself. |"]]
