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

ee.Filter.bounds

  • ee.Filter.bounds creates a filter that passes if an object's geometry intersects the specified geometry.

  • Providing a large or complex collection for thegeometry argument can negatively impact performance.

  • Theee.Filter.bounds method takes ageometry (which can be a ComputedObject, FeatureCollection, or Geometry) and an optionalerrorMargin argument.

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

Caution: providing a large or complex collection as thegeometry 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.

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.varic=ee.ImageCollection('COPERNICUS/S2_SR').filterDate('2021-07-01','2021-10-01');// A point geometry for the peak of Mount Shasta, California, USA.vargeom=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.varfc=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 usinggeemap for interactive development.

importeeimportgeemap.coreasgeemap

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)))

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2023-10-06 UTC.