Announcement : All noncommercial projects registered to use Earth Engine before April 15, 2025 must verify noncommercial eligibility to maintain access. If you have not verified by September 26, 2025, your access may be on hold.

ee.FeatureCollection.filterBounds

AI-generated Key Takeaways

The filterBounds method filters a collection to include only items whose footprint intersects with a given geometry.
This method is equivalent to using this.filter(ee.Filter.bounds(...)) .
Using a large or complex collection as the geometry argument can lead to poor performance.

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.

Examples

Code Editor (JavaScript)

 // FeatureCollection of global power plants. 
 var 
  
 powerPlants 
  
 = 
  
 ee 
 . 
 FeatureCollection 
 ( 
 'WRI/GPPD/power_plants' 
 ); 
 // FeatureCollection of counties in Oregon, USA. 
 var 
  
 oregonCounties 
  
 = 
  
 ee 
 . 
 FeatureCollection 
 ( 
 'TIGER/2018/States' 
 ) 
  
 . 
 filter 
 ( 
 'STATEFP == "41"' 
 ); 
 // Filter global power plants to those that intersect Oregon counties. 
 var 
  
 oregonPowerPlants 
  
 = 
  
 powerPlants 
 . 
 filterBounds 
 ( 
 oregonCounties 
 . 
 geometry 
 ()); 
 // Display Oregon power plants on the map. 
 Map 
 . 
 setCenter 
 ( 
 - 
 120.492 
 , 
  
 44.109 
 , 
  
 6 
 ); 
 Map 
 . 
 addLayer 
 ( 
 oregonPowerPlants 
 );

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 global power plants. 
 power_plants 
 = 
 ee 
 . 
 FeatureCollection 
 ( 
 'WRI/GPPD/power_plants' 
 ) 
 # FeatureCollection of counties in Oregon, USA. 
 oregon_counties 
 = 
 ee 
 . 
 FeatureCollection 
 ( 
 'TIGER/2018/States' 
 ) 
 . 
 filter 
 ( 
 'STATEFP == "41"' 
 ) 
 # Filter global power plants to those that intersect Oregon counties. 
 oregon_power_plants 
 = 
 power_plants 
 . 
 filterBounds 
 ( 
 oregon_counties 
 . 
 geometry 
 ()) 
 # Display Oregon power plants on the map. 
 m 
 = 
 geemap 
 . 
 Map 
 () 
 m 
 . 
 set_center 
 ( 
 - 
 120.492 
 , 
 44.109 
 , 
 6 
 ) 
 m 
 . 
 add_layer 
 ( 
 oregon_power_plants 
 ) 
 m