公告：凡是在
2025 年 4 月 15 日前註冊使用 Earth Engine 的非商業專案，都必須
驗證非商業用途資格，才能繼續存取 Earth Engine。
ee.FeatureCollection.aggregate_first
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
會彙整集合中物件的指定屬性，並計算集合中第一個物件的屬性值。
| 用量 | 傳回 |
|---|
FeatureCollection.aggregate_first(property) | |
| 引數 | 類型 | 詳細資料 |
|---|
這個：collection | FeatureCollection | 要匯總的集合。 |
property | 字串 | 要從集合的每個元素使用的屬性。 |
範例
程式碼編輯器 (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 設定
請參閱
Python 環境頁面，瞭解 Python API 和如何使用 geemap 進行互動式開發。
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
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-07-26 (世界標準時間)。
[null,null,["上次更新時間：2025-07-26 (世界標準時間)。"],[[["\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```"]]
