Method: projects.image.export

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

Requête HTTP

POST https://earthengine.googleapis.com/v1beta/{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 à 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.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,

  // Union field export_options can be only one of the following:
  "fileExportOptions": {
    object (ImageFileExportOptions)
  },
  "assetExportOptions": {
    object (ImageAssetExportOptions)
  }
  // End of list of possible types for union field export_options.
}
Champs
expression

object (Expression)

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

string

Nom lisible de la tâche.
maxPixels

string (Int64Value format)

Nombre maximal de pixels à calculer et à exporter. Il s'agit d'une mesure de sécurité qui vous empêche de lancer accidentellement une exportation plus importante que celle que vous aviez prévue. La valeur par défaut est de 1 e8 pixels, mais vous pouvez définir la valeur 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 rognée. Si cet argument n'est pas présent, 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 le même utilisateur effectue plusieurs requêtes avec le même requestId non vide, seule l'une d'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 ne doit pas dépasser 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é plus élevée sont planifiées plus tôt. Il doit s'agir d'un entier compris entre 0 et 9 999. Si cette valeur n'est pas définie, elle est définie par défaut sur 100.
Champ d'union export_options. Options indiquant où et comment stocker les résultats. export_options ne peut être qu'un des éléments suivants :
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.

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 champs d'application OAuth suivants :

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

Pour en savoir plus, consultez OAuth 2.0 Overview.

ImageAssetExportOptions

Options d'enregistrement d'images en tant qu'éléments Earth Engine.

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

  // Union field destination can be only one of the following:
  "earthEngineDestination": {
    object (EarthEngineDestination)
  }
  // End of list of possible types for union field destination.
}
Champs
pyramidingPolicy

enum (PyramidingPolicy)

Stratégie de pyramidage à appliquer par défaut à toutes les bandes.
pyramidingPolicyOverrides

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

Remplacements spécifiques des règles de pyramide par bande.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.
Champ d'union destination. Emplacement où écrire les résultats. destination ne peut être qu'un des éléments suivants :
earthEngineDestination

object (EarthEngineDestination)

Si elle est spécifiée, configure l'exportation vers Earth Engine.