Map.getBounds
Returns the bounds of the current map view, as a list in the format [west, south, east, north] in degrees.
Usage | Returns |
---|
Map.getBounds(asGeoJSON) | GeoJSONGeometry|List|String |
Argument | Type | Details |
---|
asGeoJSON | Boolean, optional | If true, returns map bounds as GeoJSON. |
Examples
// The default map in the Code Editor is a built-in ui.Map object called "Map".
// Let's refer to it as "defaultMap" for clarity.
var defaultMap = Map;
// ui.Map objects can be constructed. Here, a new map is declared.
var newMap = ui.Map({
center: {lat: 0, lon: 0, zoom: 1},
style: {position: 'bottom-right', width: '400px'}
});
// Add the newMap to the defaultMap.
defaultMap.add(newMap);
// You can set the viewport of a ui.Map to be centered on an object.
// Here, the defaultMap is centered on a point with a selected zoom level.
var geom = ee.Geometry.Point(-122.0841, 37.4223);
defaultMap.centerObject(geom, 18);
defaultMap.addLayer(geom, {color: 'orange'}, 'Googleplex');
// Map extent can be fetched using the ui.Map.getBounds method.
print('defaultMap bounds as a list',
defaultMap.getBounds());
print('defaultMap bounds as a dictionary',
ee.Dictionary.fromLists(['w', 's', 'e', 'n'], defaultMap.getBounds()));
print('defaultMap bounds as GeoJSON',
defaultMap.getBounds({asGeoJSON: true}));
// Map center point can be fetched using the ui.Map.getCenter method.
print('defaultMap center as a Point geometry', defaultMap.getCenter());
// Map zoom level can be fetched using the ui.Map.getZoom method.
print('defaultMap zoom level', defaultMap.getZoom());
// Map scale can be fetched using the ui.Map.getScale method.
print('defaultMap approximate pixel scale', defaultMap.getScale());
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."],[[["`Map.getBounds()` returns the current map view's boundaries in degrees as a list: `[west, south, east, north]`."],["The optional `asGeoJSON` argument allows retrieval of bounds in GeoJSON format."],["This function is used to programmatically access and utilize the current map view extent within your code."]]],["The `Map.getBounds()` method retrieves the current map view's boundaries. It returns a list in the format \\[west, south, east, north] by default. If the optional `asGeoJSON` argument is set to true, it returns the bounds as GeoJSON. The code shows examples of using `getBounds()` with both list and GeoJSON outputs, and also how to retrieve other information such as map center, zoom level, and pixel scale.\n"]]