Method: projects.imageCollection.computeImages
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Calcule un ensemble d'éléments géographiques en appliquant un calcul arbitraire aux éléments géographiques d'une ou de plusieurs tables. Les résultats sont renvoyés sous la forme d'une liste d'images.
Requête HTTP
POST https://earthengine.googleapis.com/v1alpha/{project=projects/*}/imageCollection:computeImages
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
| Paramètres |
project |
string
ID ou numéro du projet Google Cloud Platform à traiter comme client du service pour cette requête. Format : projects/{project-id}
L'autorisation IAM suivante est requise pour la ressource project indiquée :
earthengine.computations.create
|
Corps de la requête
Le corps de la requête contient des données présentant la structure suivante :
| Représentation JSON |
{
"expression": {
object (Expression)
},
"pageSize": integer,
"pageToken": string,
"workloadTag": string
} |
| Champs |
expression |
object (Expression)
Expression à calculer.
|
pageSize |
integer
Nombre maximal de résultats par page. Le serveur peut renvoyer moins d'images que demandé. Si cette option n'est pas spécifiée, la taille de page par défaut est de 1 000 résultats par page.
|
pageToken |
string
Jeton identifiant une page de résultats que le serveur doit renvoyer. Il s'agit généralement de la valeur de ComputeImagesResponse.next_page_token renvoyée par l'appel précédent à la méthode imageCollection.computeImages.
|
workloadTag |
string
Balise fournie par l'utilisateur pour suivre ce calcul.
|
Corps de la réponse
Message de réponse pour EarthEngineService.ComputeImages.
Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :
| Représentation JSON |
{
"images": [
{
object (EarthEngineAsset)
}
],
"nextPageToken": string
} |
| Champs |
images[] |
object (EarthEngineAsset)
Liste des images correspondant à la requête.
|
nextPageToken |
string
Jeton permettant de récupérer la page de résultats suivante. Transmettez cette valeur dans le champ ComputeImagesRequest.page_token de l'appel suivant de la méthode imageCollection.computeImages pour récupérer la page de résultats suivante.
|
Champs d'application des autorisations
Nécessite l'un des champs d'application OAuth suivants :
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
Pour en savoir plus, consultez OAuth 2.0 Overview.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/25 (UTC).
[null,null,["Dernière mise à jour le 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)."]]
