ee.FeatureCollection.limit

AI-generated Key Takeaways

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

Usage	Returns
FeatureCollection.limit(max, property, ascending)	Collection

Argument	Type	Details
this: collection	Collection	The Collection instance.
max	Number	The number to limit the collection to.
property	String, optional	The property to sort by, if sorting.
ascending	Boolean, optional	Whether 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')

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

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

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