公告：凡是在
2025 年 4 月 15 日前註冊使用 Earth Engine 的非商業專案，都必須
驗證非商業用途資格，才能繼續存取 Earth Engine。
Method: projects.table.computeFeatures
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
將任意運算套用至一或多個資料表中的特徵，藉此計算一組特徵。結果會以 GeoJSON 地圖項目物件清單的形式傳回。
HTTP 要求
POST https://earthengine.googleapis.com/v1/{project=projects/*}/table:computeFeatures
這個網址使用 gRPC 轉碼語法。
路徑參數
| 參數 |
project |
string
應視為此要求服務用戶的 Google Cloud Platform 專案專案 ID 或專案編號。格式為 projects/{project-id}。
授權需要指定資源 project 的下列 IAM 權限：
earthengine.computations.create
|
要求主體
要求主體的資料會採用以下結構：
| JSON 表示法 |
{
"expression": {
object (Expression)
},
"pageSize": integer,
"pageToken": string,
"workloadTag": string
} |
| 欄位 |
expression |
object (Expression)
要計算的運算式。
|
pageSize |
integer
每頁的結果數量上限。伺服器傳回的功能可能少於要求的功能。如果未指定，則每頁的預設頁面大小為 1000 個結果。
|
pageToken |
string
這個符記可識別伺服器應傳回的結果頁面。通常，這是先前對 table.computeFeatures 方法的呼叫傳回的 ComputeFeaturesResponse.next_page_token 值。
|
workloadTag |
string
使用者提供的用於追蹤這項運算的代碼。
|
回應主體
EarthEngineService.ComputeFeatures 的回應訊息。
如果成功，回應主體會含有以下結構的資料：
| JSON 表示法 |
{
"type": string,
"features": [
{
object (Feature)
}
],
"nextPageToken": string
} |
| 欄位 |
type |
string
一律包含常數字串「FeatureCollection」，標示為 GeoJSON FeatureCollection 物件。
|
features[] |
object (Feature)
符合查詢的地圖項目清單，以 GeoJSON 地圖項目物件清單的形式呈現 (請參閱 RFC 7946)，其中包含名為「type」的欄位中的「Feature」字串、名為「geometry」的欄位中的幾何圖形，以及名為「properties」的欄位中的鍵/值屬性。
|
nextPageToken |
string
用來擷取下一頁結果的符記。在後續對 table.computeFeatures 方法的呼叫中，將這個值傳遞至 ComputeFeaturesRequest.page_token 欄位，即可擷取下一頁的結果。
|
授權範圍
需要下列其中一種 OAuth 範圍：
https://www.googleapis.com/auth/earthengine
https://www.googleapis.com/auth/earthengine.readonly
https://www.googleapis.com/auth/cloud-platform
https://www.googleapis.com/auth/cloud-platform.read-only
詳情請參閱 OAuth 2.0 Overview。
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-07-25 (世界標準時間)。
[null,null,["上次更新時間：2025-07-25 (世界標準時間)。"],[[["\u003cp\u003eComputes features by applying a given computation to features within tables, returning results as GeoJSON feature objects.\u003c/p\u003e\n"],["\u003cp\u003eRequires an \u003ccode\u003eexpression\u003c/code\u003e to define the computation, and allows pagination using \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e parameters.\u003c/p\u003e\n"],["\u003cp\u003eResponses are formatted as GeoJSON FeatureCollections, including a list of features and a token for retrieving further pages.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization necessitates specific OAuth scopes, including \u003ccode\u003eearthengine\u003c/code\u003e, \u003ccode\u003ecloud-platform\u003c/code\u003e, or their read-only counterparts.\u003c/p\u003e\n"],["\u003cp\u003eUsers can tag computations with a custom \u003ccode\u003eworkloadTag\u003c/code\u003e for tracking purposes.\u003c/p\u003e\n"]]],[],null,["# Method: projects.table.computeFeatures\n\nComputes a set of features by applying an arbitrary computation to features in one or more tables. Results are returned as a list of GeoJSON feature objects.\n\n### HTTP request\n\n`POST https://earthengine.googleapis.com/v1/{project=projects/*}/table:computeFeatures`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `project` | `string` The project id or project number of the Google Cloud Platform project that should be treated as the service consumer for this request. Format is `projects/{project-id}`. Authorization requires the following [IAM](https://cloud.google.com/iam/docs/) permission on the specified resource `project`: - `earthengine.computations.create` |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"expression\": { object (/earth-engine/reference/rest/v1/Expression) }, \"pageSize\": integer, \"pageToken\": string, \"workloadTag\": string } ``` |\n\n| Fields ||\n|---------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `expression` | `object (`[Expression](/earth-engine/reference/rest/v1/Expression)`)` The expression to compute. |\n| `pageSize` | `integer` The maximum number of results per page. The server may return fewer features than requested. If unspecified, the page size default is 1000 results per page. |\n| `pageToken` | `string` A token identifying a page of results the server should return. Typically, this is the value of [ComputeFeaturesResponse.next_page_token](/earth-engine/reference/rest/v1/projects.table/computeFeatures#body.ComputeFeaturesResponse.FIELDS.next_page_token) returned from the previous call to the `table.computeFeatures` method. |\n| `workloadTag` | `string` User supplied tag to track this computation. |\n\n### Response body\n\nResponse message for EarthEngineService.ComputeFeatures.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"type\": string, \"features\": [ { object (/earth-engine/reference/rest/v1/Feature) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `type` | `string` Always contains the constant string \"FeatureCollection\", marking this as a GeoJSON FeatureCollection object. |\n| `features[]` | `object (`[Feature](/earth-engine/reference/rest/v1/Feature)`)` The list of features matching the query, as a list of GeoJSON feature objects (see RFC 7946) containing the string \"Feature\" in a field named \"type\", the geometry in a field named \"geometry\", and key/value properties in a field named \"properties\". |\n| `nextPageToken` | `string` A token to retrieve the next page of results. Pass this value in the [ComputeFeaturesRequest.page_token](/earth-engine/reference/rest/v1/projects.table/computeFeatures#body.request_body.FIELDS.page_token) field in the subsequent call to the `table.computeFeatures` method to retrieve the next page of results. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/earthengine`\n- `\n https://www.googleapis.com/auth/earthengine.readonly`\n- `\n https://www.googleapis.com/auth/cloud-platform`\n- `\n https://www.googleapis.com/auth/cloud-platform.read-only`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]
