Method: projects.table.export

Avvia un processo batch che calcola una tabella e scrive il risultato in una delle varie 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 Google Cloud che deve essere considerato il consumer di servizi per questa richiesta. Il formato è projects/{project-id}.

L'autorizzazione richiede il seguente permesso IAM per la risorsa project specificata:

  • 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,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "fileExportOptions": {
    object (TableFileExportOptions)
  },
  "assetExportOptions": {
    object (TableAssetExportOptions)
  },
  "featureViewExportOptions": {
    object (FeatureViewAssetExportOptions)
  },
  "bigqueryExportOptions": {
    object (BigQueryExportOptions)
  }
  // End of mutually exclusive fields.
}
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ù di una richiesta con lo stesso requestId non vuoto, solo una di queste richieste può avviare correttamente un'operazione a lunga esecuzione. requestId può contenere i caratteri a-z, A-Z, 0-9 o "-". requestId può contenere al massimo 60 caratteri.

maxErrorMeters

number

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

maxVertices

integer

Numero massimo di vertici non tagliati per geometria; le geometrie con più vertici verranno suddivise in parti più piccole di questa dimensione.

workloadTag

string

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ù alta vengono pianificate prima. Deve essere un numero intero compreso tra 0 e 9999. Se non impostato, il valore predefinito è 100.

Opzioni che descrivono dove e come archiviare i risultati. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
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 tabellari in BigQuery.

Fine dei campi che si escludono a vicenda.

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 saperne di più, consulta la OAuth 2.0 Overview.

TableFileExportOptions

Opzioni per esportare le tabelle come file al di fuori di Earth Engine.

Rappresentazione JSON
{
  "fileFormat": enum (TableFileFormat),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "driveDestination": {
    object (DriveDestination)
  },
  "cloudStorageDestination": {
    object (CloudStorageDestination)
  }
  // End of mutually exclusive fields.
}
Campi
fileFormat

enum (TableFileFormat)

Il formato del file in cui esportare le tabelle.

Dove scrivere i risultati. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
driveDestination

object (DriveDestination)

Se specificato, configura l'esportazione su Google Drive.

cloudStorageDestination

object (CloudStorageDestination)

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

Fine dei campi che si escludono a vicenda.

TableAssetExportOptions

Opzioni per salvare le tabelle come asset Earth Engine.

Rappresentazione JSON
{

  // 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.
}
Campi
Dove scrivere i risultati. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
earthEngineDestination

object (EarthEngineDestination)

Se specificato, configura l'esportazione in Earth Engine.

Fine dei campi che si escludono a vicenda.

FeatureViewAssetExportOptions

Opzioni per salvare tabelle o FeatureCollection come mappe FeatureView.

Rappresentazione JSON
{
  "ingestionTimeParameters": {
    object (FeatureViewIngestionTimeParameters)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "featureViewDestination": {
    object (FeatureViewDestination)
  }
  // End of mutually exclusive fields.
}
Campi
ingestionTimeParameters

object (FeatureViewIngestionTimeParameters)

I parametri relativi al tempo di importazione di FeatureView. Questi parametri devono essere specificati al momento dell'importazione e non possono essere aggiornati al volo.

Dove scrivere i risultati. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
featureViewDestination

object (FeatureViewDestination)

Se specificato, configura l'esportazione in FeatureViews.

Fine dei campi che si escludono a vicenda.

FeatureViewDestination

Configurazione per una destinazione FeatureView di Earth Engine.

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

string

Obbligatorio. L'ID asset FeatureView. Il server genera un nome della mappa dall'ID.

assetVersion

integer

La versione dell'asset FeatureView da creare. Utilizzato per l'assegnazione di alias alle versioni con asset. Se non viene impostato, verrà utilizzato 0.

BigQueryExportOptions

Opzioni per l'esportazione di dati tabulari in BigQuery.

Rappresentazione JSON
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "bigqueryDestination": {
    object (BigQueryDestination)
  }
  // End of mutually exclusive fields.
}
Campi
Dove scrivere i dati. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
bigqueryDestination

object (BigQueryDestination)

Se specificato, configura l'esportazione in BigQuery.

Fine dei campi che si escludono a vicenda.

BigQueryDestination

Configurazione per una destinazione in BigQuery.

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

string

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

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

Se la risorsa a cui viene fatto riferimento esiste e ha uno schema compatibile, uno dei parametri "overwrite" e "append" deve essere true, altrimenti l'attività non verrà completata.

Se la risorsa a cui viene fatto riferimento esiste e lo schema non è compatibile con quello esistente, anche l'attività non verrà completata.

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.