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.ImageCollection.filterBounds

  • filterBounds filters a collection to include only items whose footprint intersects the provided geometry.

  • This function is a shortcut equivalent to usingfilter(ee.Filter.bounds(...)).

  • Using a large or complex collection as the geometry argument can negatively impact performance.

  • The function returns the filtered collection.

  • Thegeometry argument can be aComputedObject,FeatureCollection, orGeometry.

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

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 filtered collection.

UsageReturns
ImageCollection.filterBounds(geometry)Collection
ArgumentTypeDetails
this:collectionCollectionThe Collection instance.
geometryComputedObject|FeatureCollection|GeometryThe geometry, feature or collection to intersect with.

Examples

Code Editor (JavaScript)

// 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.filterBounds(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.filterBounds(fc));

Python setup

See the Python Environment page for information on the Python API and usinggeemap for interactive development.

importeeimportgeemap.coreasgeemap

Colab (Python)

# 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.filterBounds(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.filterBounds(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.