ee.FeatureCollection.toList

AI-generated Key Takeaways

• toList() converts an Earth Engine FeatureCollection into an Earth Engine List, enabling easier manipulation and analysis of its features.

• This function can optionally limit the number of features fetched using the count parameter and skip initial features using the offset parameter.

• toList() retrieves and displays the list of features from an input feature collection, offering flexibility for data extraction within a specific range or subset.

Returns the elements of a collection as a list.

Usage	Returns
FeatureCollection.toList(count, offset)	List

Argument	Type	Details
this: collection	FeatureCollection	The input collection to fetch.
count	Integer	The maximum number of elements to fetch.
offset	Integer, default: 0	The number of elements to discard from the start. If set, (offset + count) elements will be fetched and the first offset elements will be discarded.

Examples

Code Editor (JavaScript)

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

print('First 5 features to an ee.List', fc.toList(5));

print('Second 5 features to an ee.List', fc.toList(5, 5));

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"')

print('First 5 features to an ee.List:', fc.toList(5).getInfo())

print('Second 5 features to an ee.List:', fc.toList(5, 5).getInfo())