Method: projects.assets.listFeatures
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.
Liệt kê các tính năng trong một thành phần bảng. Phương thức này cho phép phương thức gọi áp dụng bộ lọc không gian thời gian và thuộc tính cho một 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
GET https://earthengine.googleapis.com/v1beta/{asset=projects/*/assets/**}:listFeatures
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
| Thông số |
asset |
string
Bắt buộc. Tên của thành phần bảng cần liệt kê. asset có định dạng "projects/*/assets/**" (ví dụ: "projects/earthengine-legacy/assets/users/[USER]/[ASSET]"). Tất cả tài sản do người dùng sở hữu đều thuộc dự án "earthengine-legacy" (ví dụ: "projects/earthengine-legacy/assets/users/foo/bar"). Tất cả các tài sản khác đều thuộc dự án "earthengine-public" (ví dụ: "projects/earthengine-public/assets/LANDSAT").
Việc uỷ quyền yêu cầu quyền IAM sau đây trên tài nguyên asset đã chỉ định:
|
Tham số truy vấn
| Thông số |
pageSize |
integer
Số lượng kết quả tối đa trên mỗi trang. Máy chủ có thể trả về ít thành phần 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 ListFeaturesResponse.next_page_token được trả về từ lệnh gọi trước đó đến phương thức assets.listFeatures.
|
region |
string
Nếu có, một hình học xác định vùng truy vấn, được chỉ định dưới dạng chuỗi hình học GeoJSON (xem RFC 7946).
|
filter |
string
Nếu có, hãy chỉ định các bộ lọc tài sản đơn giản khác.
|
Nội dung yêu cầu
Nội dung yêu cầu phải trống.
Nội dung phản hồi
Thông báo phản hồi cho EarthEngineService.ListFeatures.
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 ListFeaturesRequest.page_token trong lệnh gọi tiếp theo đến phương thức assets.listFeatures để 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\u003eLists features from a specified Earth Engine table asset using the \u003ccode\u003elistFeatures\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering of table data by spatiotemporal and property criteria using query parameters.\u003c/p\u003e\n"],["\u003cp\u003eReturns results as a GeoJSON FeatureCollection containing a list of features and a token for pagination.\u003c/p\u003e\n"],["\u003cp\u003eRequires specific IAM permissions or OAuth scopes for authorization to access and retrieve data.\u003c/p\u003e\n"]]],[],null,["# Method: projects.assets.listFeatures\n\nLists the features in a table asset. This method allows the caller to apply spatiotemporal and property filters to a table. Results are returned as a list of GeoJSON feature objects.\n\n### HTTP request\n\n`GET https://earthengine.googleapis.com/v1beta/{asset=projects/*/assets/**}:listFeatures`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|---------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `asset` | `string` Required. The name of the table asset to list. `asset` is of the format \"projects/\\*/assets/\\*\\*\" (e.g., \"projects/earthengine-legacy/assets/users/\\[USER\\]/\\[ASSET\\]\"). All user-owned assets are under the project \"earthengine-legacy\" (e.g., \"projects/earthengine-legacy/assets/users/foo/bar\"). All other assets are under the project \"earthengine-public\" (e.g., \"projects/earthengine-public/assets/LANDSAT\"). Authorization requires the following [IAM](https://cloud.google.com/iam/docs/) permission on the specified resource `asset`: - `earthengine.assets.get` |\n\n### Query parameters\n\n| Parameters ||\n|-------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` The maximum number of results per page. The server may return fewer assets 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 [ListFeaturesResponse.next_page_token](/earth-engine/reference/rest/v1beta/projects.assets/listFeatures#body.ListFeaturesResponse.FIELDS.next_page_token) returned from the previous call to the `assets.listFeatures` method. |\n| `region` | `string` If present, a geometry defining a query region, specified as a GeoJSON geometry string (see RFC 7946). |\n| `filter` | `string` If present, specifies additional simple property filters. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse message for EarthEngineService.ListFeatures.\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/v1beta/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/v1beta/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 [ListFeaturesRequest.page_token](/earth-engine/reference/rest/v1beta/projects.assets/listFeatures#body.QUERY_PARAMETERS.page_token) field in the subsequent call to the `assets.listFeatures` 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)."]]
