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.imageCollection.computeImages
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Calcula um conjunto de elementos aplicando uma operação arbitrária a elementos em uma ou mais tabelas. Os resultados são retornados como uma lista de imagens.
Solicitação HTTP
POST https://earthengine.googleapis.com/v1alpha/{project=projects/*}/imageCollection:computeImages
O URL usa a sintaxe de transcodificação gRPC.
Parâmetros de caminho
| Parâmetros |
project |
string
O ID ou número do projeto do Google Cloud Platform que será tratado como o consumidor de serviço para essa solicitação. O formato é projects/{project-id}.
A autorização requer a seguinte permissão do IAM no recurso especificado project:
earthengine.computations.create
|
Corpo da solicitação
O corpo da solicitação contém dados com a seguinte estrutura:
| Representação JSON |
{
"expression": {
object (Expression)
},
"pageSize": integer,
"pageToken": string,
"workloadTag": string
} |
| Campos |
expression |
object (Expression)
A expressão a ser calculada.
|
pageSize |
integer
O número máximo de resultados por página. O servidor pode retornar menos imagens 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 ComputeImagesResponse.next_page_token retornado da chamada anterior para o método imageCollection.computeImages.
|
workloadTag |
string
Tag fornecida pelo usuário para acompanhar esse cálculo.
|
Corpo da resposta
Mensagem de resposta para EarthEngineService.ComputeImages.
Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:
| Representação JSON |
{
"images": [
{
object (EarthEngineAsset)
}
],
"nextPageToken": string
} |
| Campos |
images[] |
object (EarthEngineAsset)
A lista de imagens que correspondem à consulta.
|
nextPageToken |
string
Um token para recuperar a próxima página de resultados. Transmita esse valor no campo ComputeImagesRequest.page_token na chamada subsequente para o método imageCollection.computeImages 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\u003eComputes features by applying computations to features in tables and returns results as a list of images.\u003c/p\u003e\n"],["\u003cp\u003eAccepts an expression, page size, page token, and workload tag to define the computation.\u003c/p\u003e\n"],["\u003cp\u003eReturns a list of images and a token for retrieving subsequent pages of results.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with specific OAuth scopes for access.\u003c/p\u003e\n"],["\u003cp\u003eUses a POST request to the \u003ccode\u003eearthengine.googleapis.com\u003c/code\u003e endpoint for execution.\u003c/p\u003e\n"]]],[],null,["# Method: projects.imageCollection.computeImages\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 images.\n\n### HTTP request\n\n`POST https://earthengine.googleapis.com/v1alpha/{project=projects/*}/imageCollection:computeImages`\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/v1alpha/Expression) }, \"pageSize\": integer, \"pageToken\": string, \"workloadTag\": string } ``` |\n\n| Fields ||\n|---------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `expression` | `object (`[Expression](/earth-engine/reference/rest/v1alpha/Expression)`)` The expression to compute. |\n| `pageSize` | `integer` The maximum number of results per page. The server may return fewer images 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 [ComputeImagesResponse.next_page_token](/earth-engine/reference/rest/v1alpha/projects.imageCollection/computeImages#body.ComputeImagesResponse.FIELDS.next_page_token) returned from the previous call to the `imageCollection.computeImages` method. |\n| `workloadTag` | `string` User supplied tag to track this computation. |\n\n### Response body\n\nResponse message for EarthEngineService.ComputeImages.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"images\": [ { object (/earth-engine/reference/rest/v1alpha/projects.assets#EarthEngineAsset) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `images[]` | `object (`[EarthEngineAsset](/earth-engine/reference/rest/v1alpha/projects.assets#EarthEngineAsset)`)` The list of images matching the query. |\n| `nextPageToken` | `string` A token to retrieve the next page of results. Pass this value in the [ComputeImagesRequest.page_token](/earth-engine/reference/rest/v1alpha/projects.imageCollection/computeImages#body.request_body.FIELDS.page_token) field in the subsequent call to the `imageCollection.computeImages` 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)."]]
