Announcement: All noncommercial projects registered to use Earth Engine before
April 15, 2025 must
verify noncommercial eligibility to maintain Earth Engine access.
ui.Map.setCenter
Stay organized with collections
Save and categorize content based on your preferences.
Centers the map view at the given coordinates with the given zoom level. If no zoom level is provided, it uses the most recent zoom level on the map.
Returns this ui.Map.
| Usage | Returns | Map.setCenter(lon, lat, zoom) | ui.Map |
| Argument | Type | Details | this: ui.map | ui.Map | The ui.Map instance. |
lon | Number | The longitude of the center, in degrees. |
lat | Number | The latitude of the center, in degrees. |
zoom | Number, optional | The zoom level, from 0 to 24. |
Examples
Code Editor (JavaScript)
// Define a ui.Map widget.
var map = ui.Map();
// Set the position and optional zoom level of the map. Latitude must be
// within [-85, 85].
map.setCenter({lon: -123.6, lat: 47.7, zoom: 9});
print(map);
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2023-10-06 UTC.
[null,null,["Last updated 2023-10-06 UTC."],[[["\u003cp\u003eCenters the map view on the specified longitude and latitude coordinates.\u003c/p\u003e\n"],["\u003cp\u003eOptionally allows setting the zoom level, otherwise uses the current zoom level.\u003c/p\u003e\n"],["\u003cp\u003eReturns the ui.Map object, allowing for method chaining.\u003c/p\u003e\n"],["\u003cp\u003eLatitude must be within the range of -85 to 85 degrees.\u003c/p\u003e\n"]]],["The `Map.setCenter` function sets the map's center point using longitude (`lon`) and latitude (`lat`) coordinates. An optional `zoom` level, ranging from 0 to 24, can also be specified; otherwise, the map's current zoom is retained. The function requires a `ui.Map` instance, and the `lon` and `lat` are numerical degrees. Upon execution, it returns the modified `ui.Map` instance, updating the map's view.\n"],null,["# ui.Map.setCenter\n\n\u003cbr /\u003e\n\nCenters the map view at the given coordinates with the given zoom level. If no zoom level is provided, it uses the most recent zoom level on the map.\n\n\u003cbr /\u003e\n\nReturns this ui.Map.\n\n| Usage | Returns |\n|-------------------------------------|---------|\n| Map.setCenter`(lon, lat, `*zoom*`)` | ui.Map |\n\n| Argument | Type | Details |\n|----------------|------------------|------------------------------------------|\n| this: `ui.map` | ui.Map | The ui.Map instance. |\n| `lon` | Number | The longitude of the center, in degrees. |\n| `lat` | Number | The latitude of the center, in degrees. |\n| `zoom` | Number, optional | The zoom level, from 0 to 24. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\n// Define a ui.Map widget.\nvar map = ui.Map();\n\n// Set the position and optional zoom level of the map. Latitude must be\n// within [-85, 85].\nmap.setCenter({lon: -123.6, lat: 47.7, zoom: 9});\nprint(map);\n```"]]