Method: projects.table.export

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

Requête HTTP

POST https://earthengine.googleapis.com/v1/{project=projects/*}/table: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,
  "selectors": [
    string
  ],
  "requestId": string,
  "maxErrorMeters": number,
  "maxVertices": integer,
  "workloadTag": string,
  "priority": integer,

  // Union field export_options can be only one of the following:
  "fileExportOptions": {
    object (TableFileExportOptions)
  },
  "assetExportOptions": {
    object (TableAssetExportOptions)
  },
  "featureViewExportOptions": {
    object (FeatureViewAssetExportOptions)
  },
  "bigqueryExportOptions": {
    object (BigQueryExportOptions)
  }
  // End of list of possible types for union field export_options.
}
Champs
expression

object (Expression)

Expression qui renvoie la table à calculer et à exporter.
description

string

Nom lisible de la tâche.
selectors[]

string

Liste explicite des colonnes à inclure dans le résultat.
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.
maxErrorMeters

number

Erreur maximale autorisée en mètres lors de la transformation de la géométrie entre les systèmes de coordonnées. Si ce champ est vide, l'erreur maximale est de 1 mètre par défaut.
maxVertices

integer

Nombre maximal de sommets non coupés par géométrie. Les géométries comportant plus de sommets seront découpées en morceaux de taille inférieure.
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 (TableFileExportOptions)

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

object (TableAssetExportOptions)

Si spécifié, configure l'exportation en tant qu'élément Earth Engine.
featureViewExportOptions

object (FeatureViewAssetExportOptions)

Si elle est spécifiée, configure l'exportation en tant que carte FeatureView.
bigqueryExportOptions

object (BigQueryExportOptions)

Si elle est spécifiée, configure l'exportation de données tabulaires vers BigQuery.

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.

TableFileExportOptions

Options d'exportation de tableaux au format de fichier en dehors d'Earth Engine.

Représentation JSON 
{
  "fileFormat": enum (TableFileFormat),

  // Union field destination can be only one of the following:
  "driveDestination": {
    object (DriveDestination)
  },
  "cloudStorageDestination": {
    object (CloudStorageDestination)
  }
  // End of list of possible types for union field destination.
}
Champs
fileFormat

enum (TableFileFormat)

Format de fichier dans lequel exporter la ou les tables.
Champ d'union destination. Emplacement où écrire les résultats. destination ne peut être qu'un des éléments suivants :
driveDestination

object (DriveDestination)

Si spécifié, configure l'exportation vers Google Drive.
cloudStorageDestination

object (CloudStorageDestination)

Si spécifié, configure l'exportation vers Google Cloud Storage.

TableAssetExportOptions

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

Représentation JSON 
{

  // Union field destination can be only one of the following:
  "earthEngineDestination": {
    object (EarthEngineDestination)
  }
  // End of list of possible types for union field destination.
}
Champs
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.

FeatureViewAssetExportOptions

Options d'enregistrement de tableaux ou de FeatureCollections en tant que cartes FeatureView.

Représentation JSON 
{
  "ingestionTimeParameters": {
    object (FeatureViewIngestionTimeParameters)
  },

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

object (FeatureViewIngestionTimeParameters)

Paramètres de l'heure d'ingestion des FeatureView. Ces paramètres doivent être spécifiés au moment de l'ingestion et ne peuvent pas être mis à jour instantanément.
Champ d'union destination. Emplacement où écrire les résultats. destination ne peut être qu'un des éléments suivants :
featureViewDestination

object (FeatureViewDestination)

Si spécifié, configure l'exportation vers FeatureViews.

FeatureViewDestination

Configuration d'une destination FeatureView Earth Engine.

Représentation JSON 
{
  "name": string,
  "assetVersion": integer
}
Champs
name

string

Obligatoire. ID de l'élément FeatureView. Le serveur génère un nom de carte à partir de l'ID.
assetVersion

integer

Version de l'élément FeatureView à créer. Utilisé pour créer des alias de versions avec des composants. Si ce paramètre n'est pas défini, la valeur 0 est utilisée.

BigQueryExportOptions

Options d'exportation de données tabulaires vers BigQuery.

Représentation JSON 
{

  // Union field destination can be only one of the following:
  "bigqueryDestination": {
    object (BigQueryDestination)
  }
  // End of list of possible types for union field destination.
}
Champs
Champ d'union destination. Emplacement où écrire les données. destination ne peut être qu'un des éléments suivants :
bigqueryDestination

object (BigQueryDestination)

Si spécifié, configure l'exportation vers BigQuery.

BigQueryDestination

Configuration d'une destination dans BigQuery.

Représentation JSON 
{
  "table": string,
  "overwrite": boolean,
  "append": boolean
}
Champs
table

string

Obligatoire. Référence de la table de destination BigQuery au format suivant: "projectId.dataset_id.table_id".

Si la ressource référencée n'existe pas, une table est créée. Cela s'applique également si les paramètres "append" et "overwrite" sont tous deux définis sur "false".

Si la ressource référencée existe et possède un schéma compatible, l'un des paramètres "overwrite" (écraser) et "append" (ajouter) doit être défini sur "true", sinon la tâche échouera.

Si la ressource référencée existe et que le schéma n'est pas compatible avec celui existant, la tâche échoue également.
overwrite

boolean

Indique si les données de la table doivent être écrasées si la table existe déjà et possède un schéma compatible.

Les paramètres overwrite et append ne peuvent pas être true simultanément.
append

boolean

Indique si les données de la table doivent être ajoutées si la table existe déjà et possède un schéma compatible.

Les paramètres overwrite et append ne peuvent pas être true simultanément.