ee.ImageCollection.filterBounds

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 the geometry 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.

Usage	Returns
ImageCollection.filterBounds(geometry)	Collection

Argument	Type	Details
this: collection	Collection	The Collection instance.
geometry	ComputedObject|FeatureCollection|Geometry	The geometry, feature or collection to intersect with.

Examples

Code Editor (JavaScript)

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

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