ee.FeatureCollection.filter

  • filter() returns a filtered version of the original Earth Engine FeatureCollection based on the provided filter criteria.

  • The filter can be specified using a string expression (e.g., "ADM2_NAME == 'Denver'") or an ee.Filter object (e.g., ee.Filter.eq('ADM2_NAME', 'Denver')).

  • This method allows for the selection of specific features within a collection based on their properties.

  • The examples demonstrate how to filter a FeatureCollection to obtain a specific feature's geometry (Denver county) and display it on a map.

Apply a filter to this collection.

Returns the filtered collection.

UsageReturns
FeatureCollection.filter(filter)Collection
ArgumentTypeDetails
this: collectionCollectionThe Collection instance.
filterFilterA filter to apply to this collection.

Examples

Code Editor (JavaScript)

// Get Denver county polygon.
var denver = ee.FeatureCollection('FAO/GAUL_SIMPLIFIED_500m/2015/level2')
    .filter("ADM2_NAME == 'Denver'")
    .filter(ee.Filter.eq('ADM2_NAME', 'Denver'))  // Exactly the same as above.
    .first()
    .geometry();

Map.centerObject(denver, 9);
Map.addLayer(denver, null, 'Denver');

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)

# Get Denver county polygon.
denver = (
    ee.FeatureCollection('FAO/GAUL_SIMPLIFIED_500m/2015/level2')
    .filter("ADM2_NAME == 'Denver'")
    .filter(ee.Filter.eq('ADM2_NAME', 'Denver'))  # Exactly the same as above.
    .first()
    .geometry()
)

m = geemap.Map()
m.center_object(denver, 9)
m.add_layer(denver, None, 'Denver')
m