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.Filter.bounds

Page Summary

ee.Filter.bounds creates a filter that passes if an object's geometry intersects the specified geometry.
Providing a large or complex collection for the geometry argument can negatively impact performance.
The ee.Filter.bounds method takes a geometry (which can be a ComputedObject, FeatureCollection, or Geometry) and an optional errorMargin argument.

Creates a filter that passes if the object's geometry intersects the given geometry.

Returns the constructed filter.

Usage	Returns
`ee.Filter.bounds(geometry, errorMargin )`	Filter

Argument	Type	Details
`geometry`	ComputedObject\|FeatureCollection\|Geometry	The geometry, feature or collection to intersect with.
`errorMargin`	ComputedObject\|Number, optional	An optional error margin. If a number, interpreted as sphere surface meters.

Examples

Code Editor (JavaScript)

 // collection.filterBounds() is preferred. 
 // A Sentinel-2 surface reflectance image collection for 3 months in 2021. 
 var 
  
 ic 
  
 = 
  
 ee 
 . 
 ImageCollection 
 ( 
 'COPERNICUS/S2_SR' 
 ) 
  
 . 
 filterDate 
 ( 
 '2021-07-01' 
 , 
  
 '2021-10-01' 
 ); 
 // A point geometry for the peak of Mount Shasta, California, USA. 
 var 
  
 geom 
  
 = 
  
 ee 
 . 
 Geometry 
 . 
 Point 
 ( 
 - 
 122.196 
 , 
  
 41.411 
 ); 
 print 
 ( 
 'Images intersecting point geometry' 
 , 
  
 ic 
 . 
 filter 
 ( 
 ee 
 . 
 Filter 
 . 
 bounds 
 ( 
 geom 
 ))); 
 // A feature collection of point geometries for mountain peaks. 
 var 
  
 fc 
  
 = 
  
 ee 
 . 
 FeatureCollection 
 ([ 
  
 ee 
 . 
 Feature 
 ( 
 ee 
 . 
 Geometry 
 . 
 Point 
 ( 
 - 
 122.196 
 , 
  
 41.411 
 ), 
  
 { 
 mountain 
 : 
  
 'Mount Shasta' 
 }), 
  
 ee 
 . 
 Feature 
 ( 
 ee 
 . 
 Geometry 
 . 
 Point 
 ( 
 - 
 121.697 
 , 
  
 45.374 
 ), 
  
 { 
 mountain 
 : 
  
 'Mount Hood' 
 }) 
 ]); 
 print 
 ( 
 'Images intersecting feature collection' 
 , 
  
 ic 
 . 
 filter 
 ( 
 ee 
 . 
 Filter 
 . 
 bounds 
 ( 
 fc 
 )));

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)

 # collection.filterBounds() is preferred. 
 # A Sentinel-2 surface reflectance image collection for 3 months in 2021. 
 ic 
 = 
 ee 
 . 
 ImageCollection 
 ( 
 'COPERNICUS/S2_SR' 
 ) 
 . 
 filterDate 
 ( 
 '2021-07-01' 
 , 
 '2021-10-01' 
 ) 
 # A point geometry for the peak of Mount Shasta, California, USA. 
 geom 
 = 
 ee 
 . 
 Geometry 
 . 
 Point 
 ( 
 - 
 122.196 
 , 
 41.411 
 ) 
 display 
 ( 
 'Images intersecting point geometry:' 
 , 
 ic 
 . 
 filter 
 ( 
 ee 
 . 
 Filter 
 . 
 bounds 
 ( 
 geom 
 ))) 
 # A feature collection of point geometries for mountain peaks. 
 fc 
 = 
 ee 
 . 
 FeatureCollection 
 ([ 
 ee 
 . 
 Feature 
 ( 
 ee 
 . 
 Geometry 
 . 
 Point 
 ( 
 - 
 122.196 
 , 
 41.411 
 ), 
 { 
 'mountain' 
 : 
 'Mount Shasta' 
 }), 
 ee 
 . 
 Feature 
 ( 
 ee 
 . 
 Geometry 
 . 
 Point 
 ( 
 - 
 121.697 
 , 
 45.374 
 ), 
 { 
 'mountain' 
 : 
 'Mount Hood' 
 }) 
 ]) 
 display 
 ( 
 'Images intersecting feature collection:' 
 , 
 ic 
 . 
 filter 
 ( 
 ee 
 . 
 Filter 
 . 
 bounds 
 ( 
 fc 
 )))