تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003e\u003ccode\u003efilterBounds()\u003c/code\u003e filters a collection, keeping only items that intersect a specified geometry.\u003c/p\u003e\n"],["\u003cp\u003eUsing large or complex geometries for filtering can impact performance, so use the smallest necessary geometry.\u003c/p\u003e\n"],["\u003cp\u003eThis method is functionally similar to using \u003ccode\u003efilter()\u003c/code\u003e with \u003ccode\u003eee.Filter.bounds(...)\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003efilterBounds()\u003c/code\u003e is applicable to \u003ccode\u003eFeatureCollection\u003c/code\u003e objects and accepts various geometry types as input.\u003c/p\u003e\n"]]],[],null,["# ee.FeatureCollection.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| FeatureCollection.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// FeatureCollection of global power plants.\nvar powerPlants = ee.FeatureCollection('WRI/GPPD/power_plants');\n\n// FeatureCollection of counties in Oregon, USA.\nvar oregonCounties = ee.FeatureCollection('TIGER/2018/States')\n .filter('STATEFP == \"41\"');\n\n// Filter global power plants to those that intersect Oregon counties.\nvar oregonPowerPlants = powerPlants.filterBounds(oregonCounties.geometry());\n\n// Display Oregon power plants on the map.\nMap.setCenter(-120.492, 44.109, 6);\nMap.addLayer(oregonPowerPlants);\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# FeatureCollection of global power plants.\npower_plants = ee.FeatureCollection('WRI/GPPD/power_plants')\n\n# FeatureCollection of counties in Oregon, USA.\noregon_counties = ee.FeatureCollection('TIGER/2018/States').filter(\n 'STATEFP == \"41\"'\n)\n\n# Filter global power plants to those that intersect Oregon counties.\noregon_power_plants = power_plants.filterBounds(oregon_counties.geometry())\n\n# Display Oregon power plants on the map.\nm = geemap.Map()\nm.set_center(-120.492, 44.109, 6)\nm.add_layer(oregon_power_plants)\nm\n```"]]
