Anúncio: todos os projetos não comerciais registrados para usar o Earth Engine antes de
15 de abril de 2025 precisam
verificar a qualificação não comercial para manter o acesso ao Earth Engine.
Method: projects.assets.listFeatures
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Lista os recursos em um recurso de tabela. Esse método permite que o autor da chamada aplique filtros espaciais e temporais e de propriedade a uma tabela. Os resultados são retornados como uma lista de objetos de elemento GeoJSON.
Solicitação HTTP
GET https://earthengine.googleapis.com/v1beta/{asset=projects/*/assets/**}:listFeatures
O URL usa a sintaxe de transcodificação gRPC.
Parâmetros de caminho
| Parâmetros |
asset |
string
Obrigatório. O nome do recurso de tabela a ser listado. asset tem o formato "projects/*/assets/**" (por exemplo, "projects/earthengine-legacy/assets/users/[USER]/[ASSET]"). Todos os recursos de propriedade do usuário estão no projeto "earthengine-legacy" (por exemplo, "projects/earthengine-legacy/assets/users/foo/bar"). Todos os outros recursos estão no projeto "earthengine-public" (por exemplo, "projects/earthengine-public/assets/LANDSAT").
A autorização requer a seguinte permissão do IAM no recurso especificado asset:
|
Parâmetros de consulta
| Parâmetros |
pageSize |
integer
O número máximo de resultados por página. O servidor pode retornar menos recursos do que o solicitado. Se não for especificado, o tamanho padrão da página será 1.000 resultados por página.
|
pageToken |
string
Um token que identifica a página de resultados que o servidor retornará. Normalmente, esse é o valor de ListFeaturesResponse.next_page_token retornado da chamada anterior para o método assets.listFeatures.
|
region |
string
Se presente, uma geometria que define uma região de consulta, especificada como uma string de geometria GeoJSON (consulte RFC 7946).
|
filter |
string
Se presente, especifica outros filtros de propriedade simples.
|
Corpo da solicitação
O corpo da solicitação precisa estar vazio.
Corpo da resposta
Mensagem de resposta para EarthEngineService.ListFeatures.
Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:
| Representação JSON |
{
"type": string,
"features": [
{
object (Feature)
}
],
"nextPageToken": string
} |
| Campos |
type |
string
Sempre contém a string constante "FeatureCollection", marcando-a como um objeto FeatureCollection do GeoJSON.
|
features[] |
object (Feature)
A lista de elementos que correspondem à consulta, como uma lista de objetos de elementos GeoJSON (consulte a RFC 7946) que contém a string "Feature" em um campo chamado "type", a geometria em um campo chamado "geometry" e as propriedades chave/valor em um campo chamado "properties".
|
nextPageToken |
string
Um token para recuperar a próxima página de resultados. Transmita esse valor no campo ListFeaturesRequest.page_token na chamada subsequente para o método assets.listFeatures para recuperar a próxima página de resultados.
|
Escopos de autorização
Requer um dos seguintes escopos do 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
Para mais informações, consulte OAuth 2.0 Overview.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-25 UTC.
[null,null,["Última atualização 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)."]]
