Announcement: All noncommercial projects registered to use Earth Engine before April 15, 2025 must verify noncommercial eligibility to maintain Earth Engine access.
Stay organized with collections
Save and categorize content based on your preferences.
Shortcut to filter a collection by intersection with geometry. Items in the collection with a footprint that fails to intersect the given geometry will be excluded.
This is equivalent to this.filter(ee.Filter.bounds(...)).
Returns the filtered collection.
Usage
Returns
FeatureCollection.filterBounds(geometry)
Collection
Argument
Type
Details
this: collection
Collection
The Collection instance.
geometry
ComputedObject|FeatureCollection|Geometry
The geometry, feature or collection to intersect with.
[null,null,["Last updated 2023-10-06 UTC."],[[["\u003cp\u003e\u003ccode\u003efilterBounds()\u003c/code\u003e filters a collection, keeping only items that intersect a specified geometry.\u003c/p\u003e\n"],["\u003cp\u003eUsing large or complex geometries for filtering can impact performance, so use the smallest necessary geometry.\u003c/p\u003e\n"],["\u003cp\u003eThis method is functionally similar to using \u003ccode\u003efilter()\u003c/code\u003e with \u003ccode\u003eee.Filter.bounds(...)\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003efilterBounds()\u003c/code\u003e is applicable to \u003ccode\u003eFeatureCollection\u003c/code\u003e objects and accepts various geometry types as input.\u003c/p\u003e\n"]]],[],null,["# ee.FeatureCollection.filterBounds\n\n\u003cbr /\u003e\n\nShortcut to filter a collection by intersection with geometry. Items in the collection with a footprint that fails to intersect the given geometry will be excluded.\n\n\u003cbr /\u003e\n\nThis is equivalent to this.filter(ee.Filter.bounds(...)).\n| **Caution:** providing a large or complex collection as the `geometry` argument 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 filtered collection.\n\n| Usage | Returns |\n|--------------------------------------------|------------|\n| FeatureCollection.filterBounds`(geometry)` | Collection |\n\n| Argument | Type | Details |\n|--------------------|---------------------------------------------|--------------------------------------------------------|\n| this: `collection` | Collection | The Collection instance. |\n| `geometry` | ComputedObject\\|FeatureCollection\\|Geometry | The geometry, feature or collection to intersect with. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\n// FeatureCollection of global power plants.\nvar powerPlants = ee.FeatureCollection('WRI/GPPD/power_plants');\n\n// FeatureCollection of counties in Oregon, USA.\nvar oregonCounties = ee.FeatureCollection('TIGER/2018/States')\n .filter('STATEFP == \"41\"');\n\n// Filter global power plants to those that intersect Oregon counties.\nvar oregonPowerPlants = powerPlants.filterBounds(oregonCounties.geometry());\n\n// Display Oregon power plants on the map.\nMap.setCenter(-120.492, 44.109, 6);\nMap.addLayer(oregonPowerPlants);\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 global power plants.\npower_plants = ee.FeatureCollection('WRI/GPPD/power_plants')\n\n# FeatureCollection of counties in Oregon, USA.\noregon_counties = ee.FeatureCollection('TIGER/2018/States').filter(\n 'STATEFP == \"41\"'\n)\n\n# Filter global power plants to those that intersect Oregon counties.\noregon_power_plants = power_plants.filterBounds(oregon_counties.geometry())\n\n# Display Oregon power plants on the map.\nm = geemap.Map()\nm.set_center(-120.492, 44.109, 6)\nm.add_layer(oregon_power_plants)\nm\n```"]]