Method: projects.image.export

Avvia un processo batch che calcola un'immagine e scrive il risultato in una delle diverse destinazioni.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
project

string

L'ID o il numero del progetto Google Cloud Platform che deve essere trattato come consumer di servizi per questa richiesta. Il formato è projects/{project-id}.

L'autorizzazione richiede il seguente permesso IAM per la 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,
  "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.
}
Campi
expression

object (Expression)

Un'espressione che restituisce l'immagine da calcolare ed esportare.
description

string

Un nome leggibile dell'attività.
maxPixels

string (Int64Value format)

Il numero massimo di pixel da calcolare ed esportare. Si tratta di una misura di sicurezza per evitare di avviare accidentalmente un'esportazione più grande di quella prevista. Il valore predefinito è 1e8 pixel, ma puoi impostare il valore in modo esplicito per aumentare o diminuire questo limite.
grid

object (PixelGrid)

Parametri che descrivono come l'immagine calcolata da expression deve essere riproiettata e ritagliata. Se non è presente, viene restituita l'immagine calcolata completa nella sua proiezione nativa.
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 lunga esecuzione. requestId può contenere i caratteri a..z, A..Z, 0-9 o '-'. La lunghezza massima di requestId è di 60 caratteri.
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 viene 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. Nella risposta verrà impostato al massimo uno dei campi seguenti:
fileExportOptions

object (ImageFileExportOptions)

Se specificato, configura l'esportazione come file.
assetExportOptions

object (ImageAssetExportOptions)

Se specificato, configura l'esportazione come asset Earth Engine.
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.

ImageAssetExportOptions

Opzioni per il salvataggio delle immagini come asset Earth Engine.

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

enum (PyramidingPolicy)

Il criterio di piramidalizzazione da applicare per impostazione predefinita a tutte le bande.
pyramidingPolicyOverrides

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

Override specifici dei criteri di piramidalizzazione per banda.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
Dove scrivere i risultati. Di seguito è riportato un elenco di campi che si escludono a vicenda. Nella risposta verrà impostato al massimo uno dei campi seguenti:
earthEngineDestination

object (EarthEngineDestination)

Se specificato, configura l'esportazione in Earth Engine.
Fine dei campi che si escludono a vicenda.