Announcement: All noncommercial projects registered to use Earth Engine before
April 15, 2025 must
verify noncommercial eligibility to maintain Earth Engine access.
ee.FeatureCollection.bounds
Stay organized with collections
Save and categorize content based on your preferences.
Constructs a bounding box around the geometries in a collection.
| Usage | Returns | FeatureCollection.bounds(maxError, proj) | Geometry |
| Argument | Type | Details | this: collection | FeatureCollection | The collection whose bounds will be constructed. |
maxError | ErrorMargin, optional | The maximum amount of error tolerated when performing any necessary reprojection. |
proj | Projection, optional | If specified, the result will be in this projection. Otherwise it will be in EPSG:4326. |
Examples
Code Editor (JavaScript)
// FeatureCollection of power plants in Belgium.
var fc = ee.FeatureCollection('WRI/GPPD/power_plants')
.filter('country_lg == "Belgium"');
print('Bounds of Belgium power plants:', fc.bounds()); // ee.Geometry
Python setup
See the
Python Environment page for information on the Python API and using
geemap for interactive development.
import ee
import geemap.core as geemap
Colab (Python)
# FeatureCollection of power plants in Belgium.
fc = ee.FeatureCollection('WRI/GPPD/power_plants').filter(
'country_lg == "Belgium"')
print('Bounds of Belgium power plants:', fc.bounds().getInfo()) # ee.Geometry
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 2024-12-23 UTC.
[null,null,["Last updated 2024-12-23 UTC."],[[["\u003cp\u003eThe \u003ccode\u003ebounds()\u003c/code\u003e method calculates the bounding box of all geometries within a FeatureCollection.\u003c/p\u003e\n"],["\u003cp\u003eYou can optionally specify a \u003ccode\u003emaxError\u003c/code\u003e to control reprojection accuracy, and a \u003ccode\u003eproj\u003c/code\u003e to determine the projection of the resulting bounding box.\u003c/p\u003e\n"],["\u003cp\u003eThe resulting bounding box is returned as a Geometry object.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eFeatureCollection.bounds()\u003c/code\u003e method can be called directly on a feature collection instance to determine the area encompassed by all the included features.\u003c/p\u003e\n"]]],[],null,["# ee.FeatureCollection.bounds\n\nConstructs a bounding box around the geometries in a collection.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|-----------------------------------------------------|----------|\n| FeatureCollection.bounds`(`*maxError* `, `*proj*`)` | Geometry |\n\n| Argument | Type | Details |\n|--------------------|-----------------------|-----------------------------------------------------------------------------------------|\n| this: `collection` | FeatureCollection | The collection whose bounds will be constructed. |\n| `maxError` | ErrorMargin, optional | The maximum amount of error tolerated when performing any necessary reprojection. |\n| `proj` | Projection, optional | If specified, the result will be in this projection. Otherwise it will be in EPSG:4326. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\n// FeatureCollection of power plants in Belgium.\nvar fc = ee.FeatureCollection('WRI/GPPD/power_plants')\n .filter('country_lg == \"Belgium\"');\n\nprint('Bounds of Belgium power plants:', fc.bounds()); // ee.Geometry\n```\nPython setup\n\nSee the [Python Environment](/earth-engine/guides/python_install) page for information on the Python API and using\n`geemap` for interactive development. \n\n```python\nimport ee\nimport geemap.core as geemap\n```\n\n### Colab (Python)\n\n```python\n# FeatureCollection of power plants in Belgium.\nfc = ee.FeatureCollection('WRI/GPPD/power_plants').filter(\n 'country_lg == \"Belgium\"')\n\nprint('Bounds of Belgium power plants:', fc.bounds().getInfo()) # ee.Geometry\n```"]]