公告:所有在
2025 年 4 月 15 日之前注册使用 Earth Engine 的非商业项目都必须
验证是否符合非商业性质的资格条件,才能继续使用 Earth Engine。
Method: projects.assets.listFeatures
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
列出表格素材资源中的地图项。借助此方法,调用方可以将时空和属性过滤条件应用于表格。结果将作为 GeoJSON 地图项对象的列表返回。
HTTP 请求
GET https://earthengine.googleapis.com/v1beta/{asset=projects/*/assets/**}:listFeatures
网址采用 gRPC 转码语法。
路径参数
参数 |
asset |
string
必需。要列出的表格资产的名称。asset 的格式为“projects/*/assets/**”(例如“projects/earthengine-legacy/assets/users/[USER]/[ASSET]”)。所有用户拥有的资产都位于项目“earthengine-legacy”下(例如,“projects/earthengine-legacy/assets/users/foo/bar”)。所有其他资产均位于项目“earthengine-public”下(例如"projects/earthengine-public/assets/LANDSAT").
必须对指定的资源 asset 具有以下 IAM 权限才能进行授权:
|
查询参数
参数 |
pageSize |
integer
每页的结果数上限。服务器返回的素材资源数量可能少于请求的数量。如果未指定,则默认每页显示 1, 000 条结果。
|
pageToken |
string
标识服务器应返回的结果页面的令牌。 通常,这是上次调用 assets.listFeatures 方法返回的 ListFeaturesResponse.next_page_token 值。
|
region |
string
用于定义查询区域的几何图形(如果有),以 GeoJSON 几何图形字符串的形式指定(请参阅 RFC 7946)。
|
filter |
string
如果存在,则指定其他简单的媒体资源过滤条件。
|
响应正文
EarthEngineService.ListFeatures 的响应消息。
如果成功,响应正文将包含结构如下的数据:
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
用于检索下一页结果的令牌。在对 assets.listFeatures 方法的后续调用中,将此值传入 ListFeaturesRequest.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。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-25。
[null,null,["最后更新时间 (UTC):2025-07-25。"],[[["\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)."]]