ee.FeatureCollection.limit

  • limit() reduces a FeatureCollection to a specified number of elements.

  • Optionally, the collection can be sorted by a property before limiting.

  • max sets the maximum number of elements to retain in the limited collection.

  • property and ascending parameters allow for sorting before limiting.

Limit a collection to the specified number of elements, optionally sorting them by a specified property first.

Returns the limited collection.

UsageReturns
FeatureCollection.limit(max, property, ascending)Collection
ArgumentTypeDetails
this: collectionCollectionThe Collection instance.
maxNumberThe number to limit the collection to.
propertyString, optionalThe property to sort by, if sorting.
ascendingBoolean, optionalWhether to sort in ascending or descending order. The default is true (ascending).

Examples

Code Editor (JavaScript)

// FeatureCollection of global power plants.
var fc = ee.FeatureCollection('WRI/GPPD/power_plants');

print('First 5 features (power plants)', fc.limit(5));

print('Smallest 5 power plants by capacity in ascending order',
      fc.limit({max: 5, property: 'capacitymw'}));

print('Largest 5 power plants by capacity in descending order',
      fc.limit({max: 5, property: 'capacitymw', ascending: false}));

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.
fc = ee.FeatureCollection('WRI/GPPD/power_plants')

print('First 5 features (power plants):', fc.limit(5).getInfo())

print('Smallest 5 power plants by capacity in ascending order:',
      fc.limit(**{'maximum': 5, 'opt_property': 'capacitymw'}).getInfo())

print('Largest 5 power plants by capacity in descending order:',
      fc.limit(**{'maximum': 5, 'opt_property': 'capacitymw',
                  'opt_ascending': False}).getInfo())