ee.FeatureCollection.geometry

AI-generated Key Takeaways

• 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)

from pprint import pprint

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

print("Point FeatureCollection's geometry:")
pprint(fc.geometry().getInfo())