ee.Filter.bounds
Stay organized with collections
Save and categorize content based on your preferences.
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())
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2023-10-06 UTC.
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"Missing the information I need"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"Too complicated / too many steps"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"Out of date"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"Samples / code issue"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"Other"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"Easy to understand"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"Solved my problem"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"Other"
}]