Ankündigung: Alle nicht kommerziellen Projekte, die vor dem 15. April 2025 für die Nutzung der Earth Engine registriert wurden, müssen die Berechtigung zur nicht kommerziellen Nutzung bestätigen, um weiterhin auf die Earth Engine zugreifen zu können.
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Zentriert die Kartenansicht auf ein bestimmtes Objekt.
Gibt die Karte zurück.
Nutzung
Ausgabe
Map.centerObject(object, zoom, onComplete)
ui.Map
Argument
Typ
Details
object
Element|Geometrie
Ein Objekt, auf das zentriert werden soll – eine Geometrie, ein Bild oder ein Feature.
zoom
Nummer, optional
Die Zoomstufe, von 0 bis 24. Wenn nicht angegeben, wird der Wert anhand des umgebenden Rechtecks des Objekts berechnet.
onComplete
Funktion (optional)
Ein Callback, der ausgelöst wird, nachdem die Neuzentrierung erfolgreich abgeschlossen wurde. Wenn Sie diesen Parameter übergeben, wird der Vorgang `centerObject` asynchron ausgeführt.
[null,null,["Zuletzt aktualisiert: 2025-07-26 (UTC)."],[[["\u003cp\u003e\u003ccode\u003eMap.centerObject()\u003c/code\u003e centers the map view on a specified object (geometry, image, or feature).\u003c/p\u003e\n"],["\u003cp\u003eYou can optionally set a specific zoom level or provide an \u003ccode\u003eonComplete\u003c/code\u003e callback function.\u003c/p\u003e\n"],["\u003cp\u003eProviding very large or complex objects may impact performance.\u003c/p\u003e\n"],["\u003cp\u003eUse \u003ccode\u003eMap.getBounds()\u003c/code\u003e, \u003ccode\u003eMap.getCenter()\u003c/code\u003e, \u003ccode\u003eMap.getZoom()\u003c/code\u003e, and \u003ccode\u003eMap.getScale()\u003c/code\u003e to retrieve map extent, center, zoom level, and scale respectively.\u003c/p\u003e\n"]]],[],null,["# Map.centerObject\n\n\u003cbr /\u003e\n\nCenters the map view on a given object.\n\n\u003cbr /\u003e\n\n| **Caution:** providing a large or complex collection as input can result in poor performance. Collating the geometry of collections does not scale well; use the smallest collection (or geometry) that is required to achieve the desired outcome.\n\nReturns the map.\n\n| Usage | Returns |\n|-------------------------------------------------------|---------|\n| `Map.centerObject(object, `*zoom* `, `*onComplete*`)` | ui.Map |\n\n| Argument | Type | Details |\n|--------------|--------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `object` | Element\\|Geometry | An object to center on - a geometry, image or feature. |\n| `zoom` | Number, optional | The zoom level, from 0 to 24. If unspecified, computed based on the object's bounding box. |\n| `onComplete` | Function, optional | A callback which is triggered after the recentering completes successfully. Passing this parameter causes the \\`centerObject\\` operation to run asynchronously. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\n// The default map in the Code Editor is a built-in ui.Map object called \"Map\".\n// Let's refer to it as \"defaultMap\" for clarity.\nvar defaultMap = Map;\n\n// ui.Map objects can be constructed. Here, a new map is declared.\nvar newMap = ui.Map({\n center: {lat: 0, lon: 0, zoom: 1},\n style: {position: 'bottom-right', width: '400px'}\n});\n\n// Add the newMap to the defaultMap.\ndefaultMap.add(newMap);\n\n// You can set the viewport of a ui.Map to be centered on an object.\n// Here, the defaultMap is centered on a point with a selected zoom level.\nvar geom = ee.Geometry.Point(-122.0841, 37.4223);\ndefaultMap.centerObject(geom, 18);\ndefaultMap.addLayer(geom, {color: 'orange'}, 'Googleplex');\n\n// Map extent can be fetched using the ui.Map.getBounds method.\nprint('defaultMap bounds as a list',\n defaultMap.getBounds());\nprint('defaultMap bounds as a dictionary',\n ee.Dictionary.fromLists(['w', 's', 'e', 'n'], defaultMap.getBounds()));\nprint('defaultMap bounds as GeoJSON',\n defaultMap.getBounds({asGeoJSON: true}));\n\n// Map center point can be fetched using the ui.Map.getCenter method.\nprint('defaultMap center as a Point geometry', defaultMap.getCenter());\n\n// Map zoom level can be fetched using the ui.Map.getZoom method.\nprint('defaultMap zoom level', defaultMap.getZoom());\n\n// Map scale can be fetched using the ui.Map.getScale method.\nprint('defaultMap approximate pixel scale', defaultMap.getScale());\n```"]]