Annuncio: tutti i progetti non commerciali registrati per l'utilizzo di Earth Engine prima del 15 aprile 2025 devono verificare l'idoneità non commerciale per mantenere l'accesso a Earth Engine.
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Scorciatoia per filtrare una raccolta in base all'intersezione con la geometria. Gli elementi della raccolta con un footprint che non interseca la geometria specificata verranno esclusi.
Equivale a this.filter(ee.Filter.bounds(...)).
Restituisce la raccolta filtrata.
Utilizzo
Resi
ImageCollection.filterBounds(geometry)
Raccolta
Argomento
Tipo
Dettagli
questo: collection
Raccolta
L'istanza della raccolta.
geometry
ComputedObject|FeatureCollection|Geometry
La geometria, la funzionalità o la raccolta con cui eseguire l'intersezione.
[null,null,["Ultimo aggiornamento 2025-07-26 UTC."],[[["\u003cp\u003e\u003ccode\u003efilterBounds()\u003c/code\u003e filters an ImageCollection, returning only images that intersect a specified geometry, Feature, or FeatureCollection.\u003c/p\u003e\n"],["\u003cp\u003eThis method effectively removes images with footprints that do not overlap the provided geometry.\u003c/p\u003e\n"],["\u003cp\u003eUsing a large or complex geometry for filtering can significantly impact performance and should be minimized for efficiency.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003efilterBounds()\u003c/code\u003e provides a spatial filter similar to using \u003ccode\u003efilter(ee.Filter.bounds(...))\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# ee.ImageCollection.filterBounds\n\n\u003cbr /\u003e\n\nShortcut 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.\n\n\u003cbr /\u003e\n\nThis is equivalent to this.filter(ee.Filter.bounds(...)).\n| **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.\n\nReturns the filtered collection.\n\n| Usage | Returns |\n|------------------------------------------|------------|\n| ImageCollection.filterBounds`(geometry)` | Collection |\n\n| Argument | Type | Details |\n|--------------------|---------------------------------------------|--------------------------------------------------------|\n| this: `collection` | Collection | The Collection instance. |\n| `geometry` | ComputedObject\\|FeatureCollection\\|Geometry | The geometry, feature or collection to intersect with. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\n// A Sentinel-2 surface reflectance image collection for 3 months in 2021.\nvar ic = ee.ImageCollection('COPERNICUS/S2_SR')\n .filterDate('2021-07-01', '2021-10-01');\n\n// A point geometry for the peak of Mount Shasta, California, USA.\nvar geom = ee.Geometry.Point(-122.196, 41.411);\nprint('Images intersecting point geometry', ic.filterBounds(geom));\n\n// A feature collection of point geometries for mountain peaks.\nvar fc = ee.FeatureCollection([\n ee.Feature(ee.Geometry.Point(-122.196, 41.411), {mountain: 'Mount Shasta'}),\n ee.Feature(ee.Geometry.Point(-121.697, 45.374), {mountain: 'Mount Hood'})\n]);\nprint('Images intersecting feature collection', ic.filterBounds(fc));\n```\nPython setup\n\nSee the [Python Environment](/earth-engine/guides/python_install) page for information on the Python API and using\n`geemap` for interactive development. \n\n```python\nimport ee\nimport geemap.core as geemap\n```\n\n### Colab (Python)\n\n```python\n# A Sentinel-2 surface reflectance image collection for 3 months in 2021.\nic = ee.ImageCollection('COPERNICUS/S2_SR').filterDate(\n '2021-07-01', '2021-10-01'\n)\n\n# A point geometry for the peak of Mount Shasta, California, USA.\ngeom = ee.Geometry.Point(-122.196, 41.411)\nprint('Images intersecting point geometry:', ic.filterBounds(geom).getInfo())\n\n# A feature collection of point geometries for mountain peaks.\nfc = ee.FeatureCollection([\n ee.Feature(ee.Geometry.Point(-122.196, 41.411),\n {'mountain': 'Mount Shasta'}),\n ee.Feature(ee.Geometry.Point(-121.697, 45.374),\n {'mountain': 'Mount Hood'})\n])\nprint('Images intersecting feature collection:', ic.filterBounds(fc).getInfo())\n```"]]
