Announcement : On
November 13, 2024 , all users will need to
use a Cloud project in order to access Earth Engine. After this date, continued individual access without a Cloud project will require
an exception .
Send feedback
ee.ImageCollection.filterBounds
Stay organized with collections
Save and categorize content based on your preferences.
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 ())
Send feedback
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"
}]
Need to tell us more?
{"lastModified": "Last updated 2023-10-06 UTC."}
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2023-10-06 UTC."]]