Method: projects.image.export

Lance un processus par lot qui calcule une image et écrit le résultat dans l'une des nombreuses destinations.

Requête HTTP

POST https://earthengine.googleapis.com/v1/{project=projects/*}/image:export

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 qui doit être traité comme le consommateur de services pour cette requête. Le format est projects/{project-id}.

L'autorisation IAM suivante est requise pour la ressource indiquée project :

  • earthengine.exports.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)
  },
  "description": string,
  "maxPixels": string,
  "grid": {
    object (PixelGrid)
  },
  "requestId": string,
  "workloadTag": string,
  "priority": integer,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "fileExportOptions": {
    object (ImageFileExportOptions)
  },
  "assetExportOptions": {
    object (ImageAssetExportOptions)
  }
  // End of mutually exclusive fields.
}
Champs
expression

object (Expression)

Expression qui correspond à l'image à calculer et à exporter.
description

string

Nom de la tâche lisible par l'humain.
maxPixels

string (Int64Value format)

Nombre maximal de pixels à calculer et à exporter. Il s'agit d'une mesure de sécurité pour vous éviter de lancer accidentellement une exportation plus importante que prévu. La valeur par défaut est de 1e8 pixels, mais vous pouvez la définir explicitement pour augmenter ou réduire cette limite.
grid

object (PixelGrid)

Paramètres décrivant comment l'image calculée par expression doit être reprojetée et découpée. Si elle n'est pas présente, l'image calculée complète est renvoyée dans sa projection native.
requestId

string

Chaîne unique utilisée pour détecter les requêtes dupliquées. Si plusieurs requêtes sont effectuées par le même utilisateur avec le même requestId non vide, une seule d'entre elles peut démarrer une opération de longue durée. requestId peut contenir les caractères a..z, A..Z, 0-9 ou '-'. requestId Sa longueur maximale est de 60 caractères.
workloadTag

string

Libellé fourni par l'utilisateur pour suivre ce calcul.
priority

integer

Facultatif. Priorité de la tâche d'exportation dans le projet. Les tâches à priorité élevée sont planifiées plus tôt. Doit être un entier compris entre 0 et 9999. Si cette clause n'est pas définie, la valeur par défaut est 100.
Options décrivant où et comment stocker les résultats. Voici une liste de champs mutuellement exclusifs. Au maximum, un seul de ces champs sera défini dans une réponse :
fileExportOptions

object (ImageFileExportOptions)

Si spécifié, configure l'exportation en tant que fichier.
assetExportOptions

object (ImageAssetExportOptions)

Si spécifié, configure l'exportation en tant qu'élément Earth Engine.
Fin des champs mutuellement exclusifs.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de Operation.

Champs d'application des autorisations

Nécessite l'un des niveaux d'accès OAuth suivants :

  • https://www.googleapis.com/auth/earthengine
  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/devstorage.full_control

Pour plus d'informations, consultez la OAuth 2.0 Overview.

ImageAssetExportOptions

Options permettant d'enregistrer des images en tant qu'éléments Earth Engine.

Représentation JSON 
{
  "pyramidingPolicy": enum (PyramidingPolicy),
  "pyramidingPolicyOverrides": {
    string: enum (PyramidingPolicy),
    ...
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "earthEngineDestination": {
    object (EarthEngineDestination)
  }
  // End of mutually exclusive fields.
}
Champs
pyramidingPolicy

enum (PyramidingPolicy)

Règle de pyramidation à appliquer par défaut à toutes les bandes.
pyramidingPolicyOverrides

map (key: string, value: enum (PyramidingPolicy))

Remplacements spécifiques de la règle de pyramidation par bande.

Objet contenant une liste de "key": value paires. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.
Emplacement où écrire les résultats. Voici une liste de champs mutuellement exclusifs. Au maximum, un seul de ces champs sera défini dans une réponse :
earthEngineDestination

object (EarthEngineDestination)

Si spécifié, configure l'exportation vers Earth Engine.
Fin des champs mutuellement exclusifs.