ee.FeatureCollection.geometry

Page Summary

• The geometry() method extracts and merges the geometries of a collection, requiring all geometries to share the same projection and edge interpretation.

• Using a large or complex collection can negatively impact performance.

• For just a bounding box of the collection, consider using Collection.bounds instead of geometry().

Extracts and merges the geometries of a collection. Requires that all the geometries in the collection share the projection and edge interpretation.

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 that is required to achieve the desired outcome.

Note: If only a bounding box around the collection is needed, consider using Collection.bounds instead.

Usage	Returns
FeatureCollection.geometry(maxError)	Geometry

Argument	Type	Details
this: collection	FeatureCollection	The collection whose geometries will be extracted.
maxError	ErrorMargin, optional	An error margin to use when merging geometries.

Examples

Code Editor (JavaScript)

// FeatureCollection of power plants in Belgium.
var fc = ee.FeatureCollection('WRI/GPPD/power_plants')
            .filter('country_lg == "Belgium"');

print("Point FeatureCollection's geometry", fc.geometry());

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 power plants in Belgium.
fc = ee.FeatureCollection('WRI/GPPD/power_plants').filter(
    'country_lg == "Belgium"')

display("Point FeatureCollection's geometry:", fc.geometry())