ee.Filter.bounds

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 
 ) 
 print 
 ( 
 'Images intersecting point geometry:' 
 , 
 ic 
 . 
 filter 
 ( 
 ee 
 . 
 Filter 
 . 
 bounds 
 ( 
 geom 
 )) 
 . 
 getInfo 
 ()) 
 # 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' 
 }) 
 ]) 
 print 
 ( 
 'Images intersecting feature collection:' 
 , 
 ic 
 . 
 filter 
 ( 
 ee 
 . 
 Filter 
 . 
 bounds 
 ( 
 fc 
 )) 
 . 
 getInfo 
 ()) 
Create a Mobile Website
View Site in Mobile | Classic
Share by: