ui.Map.onChangeBounds
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Registriert einen Callback, der ausgelöst wird, wenn sich die Kartengrenzen ändern. Dieses Ereignis wird beim Schwenken und Zoomen sowie bei programmatischen Änderungen der Kartengrenzen ausgelöst.
Gibt eine ID zurück, die an „unlisten()“ übergeben werden kann, um den Callback zu deregistrieren.
| Nutzung | Ausgabe |
|---|
Map.onChangeBounds(callback) | String |
| Argument | Typ | Details |
|---|
So gehts: ui.map | ui.Map | Die ui.Map-Instanz. |
callback | Funktion | Der Callback, der ausgelöst wird, wenn sich die Kartenbegrenzungen ändern. Der Callback-Funktion werden zwei Parameter übergeben: ein Objekt mit den Koordinaten des neuen Kartenmittelpunkts (mit den Schlüsseln „lon“, „lat“ und „zoom“) und das Karten-Widget selbst. |
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-26 (UTC).
[null,null,["Zuletzt aktualisiert: 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. |"]]
