Announcement: All noncommercial projects registered to use Earth Engine before
April 15, 2025 must
verify noncommercial eligibility to maintain Earth Engine access.
ee.FeatureCollection.aggregate_first
Stay organized with collections
Save and categorize content based on your preferences.
Aggregates over a given property of the objects in a collection, calculating the property value of the first object in the collection.
| Usage | Returns | FeatureCollection.aggregate_first(property) | |
| Argument | Type | Details | this: collection | FeatureCollection | The collection to aggregate over. |
property | String | The property to use from each element of the collection. |
Examples
Code Editor (JavaScript)
// FeatureCollection of power plants in Belgium.
var fc = ee.FeatureCollection('WRI/GPPD/power_plants')
.filter('country_lg == "Belgium"');
print('Fuel source for first power plant in the collection',
fc.aggregate_first('fuel1')); // Wind
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('Fuel source for first power plant in the collection:',
fc.aggregate_first('fuel1').getInfo()) # Wind
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2023-10-06 UTC.
[null,null,["Last updated 2023-10-06 UTC."],[[["\u003cp\u003e\u003ccode\u003eaggregate_first()\u003c/code\u003e calculates and returns the value of a specified property from the first feature within a FeatureCollection.\u003c/p\u003e\n"],["\u003cp\u003eThis function is helpful for quickly accessing the property value of an initial element in a collection without iterating through all features.\u003c/p\u003e\n"],["\u003cp\u003eUsage involves specifying the property name as an argument to the \u003ccode\u003eaggregate_first()\u003c/code\u003e function, applied to a FeatureCollection.\u003c/p\u003e\n"]]],[],null,["# ee.FeatureCollection.aggregate_first\n\nAggregates over a given property of the objects in a collection, calculating the property value of the first object in the collection.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|-----------------------------------------------|---------|\n| FeatureCollection.aggregate_first`(property)` | |\n\n| Argument | Type | Details |\n|--------------------|-------------------|----------------------------------------------------------|\n| this: `collection` | FeatureCollection | The collection to aggregate over. |\n| `property` | String | The property to use from each element of the collection. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\n// FeatureCollection of power plants in Belgium.\nvar fc = ee.FeatureCollection('WRI/GPPD/power_plants')\n .filter('country_lg == \"Belgium\"');\n\nprint('Fuel source for first power plant in the collection',\n fc.aggregate_first('fuel1')); // Wind\n```\nPython setup\n\nSee the [Python Environment](/earth-engine/guides/python_install) page for information on the Python API and using\n`geemap` for interactive development. \n\n```python\nimport ee\nimport geemap.core as geemap\n```\n\n### Colab (Python)\n\n```python\n# FeatureCollection of power plants in Belgium.\nfc = ee.FeatureCollection('WRI/GPPD/power_plants').filter(\n 'country_lg == \"Belgium\"')\n\nprint('Fuel source for first power plant in the collection:',\n fc.aggregate_first('fuel1').getInfo()) # Wind\n```"]]