Method: projects.table.export

Avvia un processo batch che calcola una tabella e scrive il risultato in una di diverse destinazioni.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
project

string

L'ID o il numero del progetto della piattaforma Google Cloud che deve essere considerato il consumatore di servizi per questa richiesta. Il formato è projects/{project-id}.

L'autorizzazione richiede la seguente autorizzazione IAM sulla risorsa specificata project:

  • earthengine.exports.create

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione 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.
}
Campi
expression

object (Expression)

Un'espressione che restituisce la tabella da calcolare ed esportare.
description

string

Un nome leggibile dell'attività.
selectors[]

string

Un elenco esplicito di colonne da includere nel risultato.
requestId

string

Una stringa univoca utilizzata per rilevare le richieste duplicate. Se lo stesso utente effettua più richieste con lo stesso requestId non vuoto, solo una di queste richieste può avviare correttamente un'operazione a lungo termine. requestId può contenere i caratteri a-z, A-Z, 0-9 o "-". requestId può avere una lunghezza massima di 60 caratteri.
maxErrorMeters

number

L'errore massimo consentito in metri durante la trasformazione della geometria tra sistemi di coordinate. Se non viene specificato, l'errore massimo è 1 metro per impostazione predefinita.
maxVertices

integer

Numero massimo di vertici non tagliati per geometria. Le geometrie con più vertici verranno tagliate in pezzi più piccoli di queste dimensioni.
workloadTag

string

L'etichetta fornita dall'utente per monitorare questo calcolo.
priority

integer

Facoltativo. La priorità dell'attività di esportazione all'interno del progetto. Le attività con priorità più elevata vengono pianificate prima. Deve essere un numero intero compreso tra 0 e 9999. Se non impostato, il valore predefinito è 100.
Campo unione export_options. Opzioni che descrivono dove e come archiviare i risultati. export_options può essere solo uno dei seguenti:
fileExportOptions

object (TableFileExportOptions)

Se specificato, configura l'esportazione come file.
assetExportOptions

object (TableAssetExportOptions)

Se specificato, configura l'esportazione come asset Earth Engine.
featureViewExportOptions

object (FeatureViewAssetExportOptions)

Se specificato, configura l'esportazione come mappa FeatureView.
bigqueryExportOptions

object (BigQueryExportOptions)

Se specificato, configura l'esportazione dei dati tabulari in BigQuery.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Operation.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.

TableFileExportOptions

Opzioni per esportare le tabelle come file esterni a Earth Engine.

Rappresentazione 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.
}
Campi
fileFormat

enum (TableFileFormat)

Il formato del file in cui esportare le tabelle.
Campo unione destination. Dove scrivere i risultati. destination può essere solo uno dei seguenti:
driveDestination

object (DriveDestination)

Se specificato, configura l'esportazione su Google Drive.
cloudStorageDestination

object (CloudStorageDestination)

Se specificato, configura l'esportazione in Google Cloud Storage.

TableAssetExportOptions

Opzioni per salvare le tabelle come asset Earth Engine.

Rappresentazione JSON 
{

  // Union field destination can be only one of the following:
  "earthEngineDestination": {
    object (EarthEngineDestination)
  }
  // End of list of possible types for union field destination.
}
Campi
Campo unione destination. Dove scrivere i risultati. destination può essere solo uno dei seguenti:
earthEngineDestination

object (EarthEngineDestination)

Se specificato, configura l'esportazione in Earth Engine.

FeatureViewAssetExportOptions

Opzioni per salvare tabelle o raccolte di elementi come mappe di FeatureView.

Rappresentazione 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.
}
Campi
ingestionTimeParameters

object (FeatureViewIngestionTimeParameters)

I parametri relativi al momento dell'importazione di FeatureView. Questi parametri devono essere specificati al momento dell'importazione e non possono essere aggiornati dinamicamente.
Campo unione destination. Dove scrivere i risultati. destination può essere solo uno dei seguenti:
featureViewDestination

object (FeatureViewDestination)

Se specificato, configura l'esportazione in FeatureViews.

FeatureViewDestination

Configurazione per una destinazione FeatureView di Earth Engine.

Rappresentazione JSON 
{
  "name": string,
  "assetVersion": integer
}
Campi
name

string

Obbligatorio. L'ID risorsa FeatureView. Il server genera un nome mappa dall'ID.
assetVersion

integer

La versione della risorsa FeatureView da creare. Utilizzato per l'alias delle versioni con asset. Se non viene impostato, verrà utilizzato 0.

BigQueryExportOptions

Opzioni per l'esportazione dei dati tabulari in BigQuery.

Rappresentazione JSON 
{

  // Union field destination can be only one of the following:
  "bigqueryDestination": {
    object (BigQueryDestination)
  }
  // End of list of possible types for union field destination.
}
Campi
Campo unione destination. Dove scrivere i dati. destination può essere solo uno dei seguenti:
bigqueryDestination

object (BigQueryDestination)

Se specificato, configura l'esportazione in BigQuery.

BigQueryDestination

Configurazione di una destinazione in BigQuery.

Rappresentazione JSON 
{
  "table": string,
  "overwrite": boolean,
  "append": boolean
}
Campi
table

string

Obbligatorio. Il riferimento alla tabella di destinazione BigQuery nel seguente formato: "projectId.dataset_id.table_id".

Se la risorsa a cui si fa riferimento non esiste, verrà creata una nuova tabella. Questo vale anche se i parametri "append" e "overwrite" sono entrambi falsi.

Se la risorsa a cui si fa riferimento esiste e ha uno schema compatibile, uno dei parametri "overwrite" e "append" deve essere true, altrimenti l'attività non andrà a buon fine.

Se la risorsa a cui viene fatto riferimento esiste e lo schema non è compatibile con quello esistente, l'attività non andrà a buon fine.
overwrite

boolean

Specifica se i dati della tabella devono essere sovrascritti se la tabella esiste già e ha uno schema compatibile.

I parametri overwrite e append non possono essere true contemporaneamente.
append

boolean

Specifica se i dati della tabella devono essere aggiunti se la tabella esiste già e ha uno schema compatibile.

I parametri overwrite e append non possono essere true contemporaneamente.