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_count
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 number of non-null values of the property.
| Usage | Returns | FeatureCollection.aggregate_count(property) | Number |
| 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('Number of non-null values for the fuel1 property',
fc.aggregate_count('fuel1')); // 66
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('Number of non-null values for the fuel1 property:',
fc.aggregate_count('fuel1').getInfo()) # 66
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_count\u003c/code\u003e calculates the number of features in a collection with a non-null value for a specified property.\u003c/p\u003e\n"],["\u003cp\u003eIt takes a FeatureCollection and the property name as input.\u003c/p\u003e\n"],["\u003cp\u003eThe result is a single number representing the count of non-null values.\u003c/p\u003e\n"],["\u003cp\u003eThis function is useful for understanding data completeness and distribution for specific properties within a collection.\u003c/p\u003e\n"]]],[],null,["# ee.FeatureCollection.aggregate_count\n\nAggregates over a given property of the objects in a collection, calculating the number of non-null values of the property.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|-----------------------------------------------|---------|\n| FeatureCollection.aggregate_count`(property)` | Number |\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('Number of non-null values for the fuel1 property',\n fc.aggregate_count('fuel1')); // 66\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('Number of non-null values for the fuel1 property:',\n fc.aggregate_count('fuel1').getInfo()) # 66\n```"]]