ee.Filter.bounds

  • Creates a filter that selects objects whose geometry intersects a specified geometry or feature collection.

  • Accepts a geometry, feature, or feature collection as input for the intersection.

  • Includes an optional errorMargin parameter for adjusting the intersection boundary.

  • Large or complex geometries provided as input may result in slower performance.

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

Returns the constructed filter.

UsageReturns
ee.Filter.bounds(geometry, errorMargin)Filter
ArgumentTypeDetails
geometryComputedObject|FeatureCollection|GeometryThe geometry, feature or collection to intersect with.
errorMarginComputedObject|Number, optionalAn 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())