Announcement: On November 13, 2024, all users will need to use a Cloud project in order to access Earth Engine. After this date, continued individual access without a Cloud project will require an exception.

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(...)).

Returns the filtered collection.

Usage	Returns
`FeatureCollection.filterBounds(geometry)`	Collection

Argument	Type	Details
this: `collection`	Collection	The Collection instance.
`geometry`	ComputedObject\|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);

Python setup

See the Python Environment page for information on the Python API and using geemap for interactive development.

import ee
import geemap.core as geemap

Colab (Python)

# FeatureCollection of global power plants.
power_plants = ee.FeatureCollection('WRI/GPPD/power_plants')

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

# Filter global power plants to those that intersect Oregon counties.
oregon_power_plants = power_plants.filterBounds(oregon_counties.geometry())

# Display Oregon power plants on the map.
m = geemap.Map()
m.set_center(-120.492, 44.109, 6)
m.add_layer(oregon_power_plants)
m