Method: projects.video.export

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

Richiesta HTTP

POST https://earthengine.googleapis.com/v1/{project=projects/*}/video: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,
  "videoOptions": {
    object (VideoOptions)
  },
  "fileExportOptions": {
    object (VideoFileExportOptions)
  },
  "requestId": string,
  "workloadTag": string,
  "priority": integer
}
Campi
expression

object (Expression)

Un'espressione che restituisce il video da calcolare ed esportare, rappresentato come una raccolta di immagini.

description

string

Un nome leggibile dell'attività.

videoOptions

object (VideoOptions)

Opzioni di base che descrivono il video da generare.

fileExportOptions

object (VideoFileExportOptions)

Opzioni per la posizione e il formato di esportazione del video.

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 '-'. 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.

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.

VideoFileExportOptions

Opzioni per l'esportazione di video come file al di fuori di Earth Engine.

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

  // 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 (VideoFileFormat)

Il formato di file in cui esportare i video. Al momento è supportato solo MP4.

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:
driveDestination

object (DriveDestination)

Se specificato, configura l'esportazione su Google Drive.

cloudStorageDestination

object (CloudStorageDestination)

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

Fine dei campi che si escludono a vicenda.