Annonce : Tous les projets non commerciaux enregistrés pour utiliser Earth Engine avant le 15 avril 2025 doivent vérifier leur éligibilité non commerciale pour conserver leur accès à Earth Engine.
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Raccourci permettant de filtrer une collection par intersection avec une géométrie. Les éléments de la collection dont l'empreinte ne croise pas la géométrie donnée seront exclus.
Cela équivaut à this.filter(ee.Filter.bounds(...)).
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/26 (UTC).
[null,null,["Dernière mise à jour le 2025/07/26 (UTC)."],[[["\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```"]]