ee.FeatureCollection.limit

  • The limit method on a Collection instance limits the collection to a specified number of elements.

  • You can optionally sort the collection by a property before limiting, and specify ascending or descending order.

  • The method returns the limited collection.

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