Method: projects.table.computeFeatures
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Tính toán một tập hợp các đặc điểm bằng cách áp dụng một phép tính tuỳ ý cho các đặc điểm trong một hoặc nhiều bảng. Kết quả được trả về dưới dạng danh sách đối tượng đặc điểm GeoJSON.
Yêu cầu HTTP
POST https://earthengine.googleapis.com/v1/{project=projects/*}/table:computeFeatures
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
| Thông số |
project |
string
Mã dự án hoặc số dự án của dự án Google Cloud Platform sẽ được coi là người dùng dịch vụ cho yêu cầu này. Định dạng là projects/{project-id}.
Việc uỷ quyền yêu cầu quyền IAM sau đây trên tài nguyên project đã chỉ định:
earthengine.computations.create
|
Nội dung yêu cầu
Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:
| Biểu diễn dưới dạng JSON |
{
"expression": {
object (Expression)
},
"pageSize": integer,
"pageToken": string,
"workloadTag": string
} |
| Trường |
expression |
object (Expression)
Biểu thức cần tính toán.
|
pageSize |
integer
Số lượng kết quả tối đa trên mỗi trang. Máy chủ có thể trả về ít tính năng hơn so với yêu cầu. Nếu không chỉ định, kích thước trang mặc định là 1000 kết quả trên mỗi trang.
|
pageToken |
string
Mã thông báo xác định trang kết quả mà máy chủ sẽ trả về. Thông thường, đây là giá trị của ComputeFeaturesResponse.next_page_token được trả về từ lệnh gọi trước đó đến phương thức table.computeFeatures.
|
workloadTag |
string
Thẻ do người dùng cung cấp để theo dõi phép tính này.
|
Nội dung phản hồi
Thông báo phản hồi cho EarthEngineService.ComputeFeatures.
Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:
| Biểu diễn dưới dạng JSON |
{
"type": string,
"features": [
{
object (Feature)
}
],
"nextPageToken": string
} |
| Trường |
type |
string
Luôn chứa chuỗi hằng số "FeatureCollection", đánh dấu chuỗi này là đối tượng FeatureCollection GeoJSON.
|
features[] |
object (Feature)
Danh sách các đối tượng phù hợp với truy vấn, dưới dạng danh sách các đối tượng đối tượng GeoJSON (xem RFC 7946) chứa chuỗi "Feature" trong trường có tên "type", hình học trong trường có tên "geometry" và các thuộc tính khoá/giá trị trong trường có tên "properties".
|
nextPageToken |
string
Mã thông báo để truy xuất trang kết quả tiếp theo. Truyền giá trị này trong trường ComputeFeaturesRequest.page_token trong lệnh gọi tiếp theo đến phương thức table.computeFeatures để truy xuất trang kết quả tiếp theo.
|
Phạm vi uỷ quyền
Yêu cầu một trong các phạm vi OAuth sau:
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
Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-25 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-25 UTC."],[[["\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)."]]
