公告：凡是在
2025 年 4 月 15 日前註冊使用 Earth Engine 的非商業專案，都必須
驗證非商業用途資格，才能繼續存取 Earth Engine。
ee.FeatureCollection.evaluate
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
從伺服器非同步擷取這個物件的值，並傳遞至提供的回呼函式。
| 用量 | 傳回 |
|---|
FeatureCollection.evaluate(callback) | |
| 引數 | 類型 | 詳細資料 |
|---|
這個：computedobject | ComputedObject | ComputedObject 例項。 |
callback | 函式 | 伺服器傳回答案時呼叫的函式，格式為 function(success, failure)。如果要求成功，success 引數會包含評估結果。如果要求失敗，失敗引數會包含錯誤訊息。 |
範例
程式碼編輯器 (JavaScript)
/**
* WARNING: this function transfers data from Earth Engine servers to the
* client. Doing so can negatively affect request processing and client
* performance. Server-side options should be used whenever possible.
* Learn more about the distinction between server and client:
* https://developers.google.com/earth-engine/guides/client_server
*/
// FeatureCollection of power plants in Belgium.
var fcServer = ee.FeatureCollection('WRI/GPPD/power_plants')
.filter('country_lg == "Belgium"');
fcServer.evaluate(function(fcClient) {
print('Client-side feature collection is an object', typeof fcClient);
print('Feature collection object keys', Object.keys(fcClient));
print('Array of features', fcClient.features);
print('Properties for first feature', fcClient.features[0].properties);
});
Python 設定
請參閱
Python 環境頁面，瞭解 Python API 和如何使用 geemap 進行互動式開發。
import ee
import geemap.core as geemap
Colab (Python)
# The Earth Engine Python client library does not have an evaluate method for
# asynchronous evaluation of ee.FeatureCollection objects.
# Use ee.FeatureCollection.getInfo() instead.
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-07-26 (世界標準時間)。
[null,null,["上次更新時間：2025-07-26 (世界標準時間)。"],[[["\u003cp\u003e\u003ccode\u003eevaluate()\u003c/code\u003e retrieves the value of a ComputedObject (like a FeatureCollection) from the Earth Engine server and passes it to a callback function.\u003c/p\u003e\n"],["\u003cp\u003eThe callback function is structured as \u003ccode\u003efunction(success, failure)\u003c/code\u003e where \u003ccode\u003esuccess\u003c/code\u003e contains the result if the request succeeds, and \u003ccode\u003efailure\u003c/code\u003e contains an error message if it fails.\u003c/p\u003e\n"],["\u003cp\u003eThis method transfers data from the server to the client, potentially impacting performance; server-side options are generally preferred.\u003c/p\u003e\n"],["\u003cp\u003eFor asynchronous evaluation of \u003ccode\u003eee.FeatureCollection\u003c/code\u003e in the Earth Engine Python client library, use \u003ccode\u003egetInfo()\u003c/code\u003e instead of \u003ccode\u003eevaluate()\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# ee.FeatureCollection.evaluate\n\n\u003cbr /\u003e\n\nAsynchronously retrieves the value of this object from the server and passes it to the provided callback function.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|----------------------------------------|---------|\n| FeatureCollection.evaluate`(callback)` | |\n\n| Argument | Type | Details |\n|------------------------|----------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| this: `computedobject` | ComputedObject | The ComputedObject instance. |\n| `callback` | Function | A function of the form function(success, failure), called when the server returns an answer. If the request succeeded, the success argument contains the evaluated result. If the request failed, the failure argument will contains an error message. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\n/**\n * WARNING: this function transfers data from Earth Engine servers to the\n * client. Doing so can negatively affect request processing and client\n * performance. Server-side options should be used whenever possible.\n * Learn more about the distinction between server and client:\n * https://developers.google.com/earth-engine/guides/client_server\n */\n\n// FeatureCollection of power plants in Belgium.\nvar fcServer = ee.FeatureCollection('WRI/GPPD/power_plants')\n .filter('country_lg == \"Belgium\"');\n\nfcServer.evaluate(function(fcClient) {\n print('Client-side feature collection is an object', typeof fcClient);\n print('Feature collection object keys', Object.keys(fcClient));\n print('Array of features', fcClient.features);\n print('Properties for first feature', fcClient.features[0].properties);\n});\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# The Earth Engine Python client library does not have an evaluate method for\n# asynchronous evaluation of ee.FeatureCollection objects.\n# Use ee.FeatureCollection.getInfo() instead.\n```"]]
