تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\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```"]]
