ee.FeatureCollection.filterBounds

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 input 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.

UsageReturns
FeatureCollection.filterBounds(geometry)Collection
ArgumentTypeDetails
this: collectionCollection

The Collection instance.

geometryComputedObject|FeatureCollection|Geometry

The geometry, feature or collection to intersect with.

Examples

Code Editor (JavaScript)

// FeatureCollection of global power plants.
var powerPlants = ee.FeatureCollection('WRI/GPPD/power_plants');

// FeatureCollection of counties in Oregon, USA.
var oregonCounties = ee.FeatureCollection('TIGER/2018/States')
                         .filter('STATEFP == "41"');

// Filter global power plants to those that intersect Oregon counties.
var oregonPowerPlants = powerPlants.filterBounds(oregonCounties.geometry());

// Display Oregon power plants on the map.
Map.setCenter(-120.492, 44.109, 6);
Map.addLayer(oregonPowerPlants);