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