Method: projects.image.export

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

Richiesta HTTP

POST https://earthengine.googleapis.com/v1alpha/{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 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,
  "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.
}
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 un'opzione di sicurezza che ti impedisce di avviare accidentalmente un'esportazione più grande del previsto. Il valore predefinito è 1e8 pixel, ma puoi impostarlo esplicitamente 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, l'immagine completa calcolata viene restituita 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 lungo termine. requestId può contenere i caratteri a-z, A-Z, 0-9 o "-". requestId può avere una lunghezza massima di 60 caratteri.

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 (ImageFileExportOptions)

Se specificato, configura l'esportazione come file.

assetExportOptions

object (ImageAssetExportOptions)

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

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.

ImageAssetExportOptions

Opzioni per salvare le immagini come asset Earth Engine.

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

enum (PyramidingPolicy)

Il criterio di piramidizzazione da applicare per impostazione predefinita a tutte le fasce.

pyramidingPolicyOverrides

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

Sostituzioni specifiche dei criteri della piramide per fascia.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

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.