Method: projects.map.export

Avvia un processo batch che calcola una mappa a riquadri e scrive il risultato in Google Cloud Storage.

Richiesta HTTP

POST https://earthengine.googleapis.com/v1alpha/{project=projects/*}/map: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, "tileOptions": { object (TileOptions) }, "tileExportOptions": { object (ImageFileExportOptions) }, "requestId": string, "workloadTag": string, "priority": integer }

Campi
expression	object (Expression) Un'espressione che restituisce l'immagine da calcolare ed esportare. I limiti dell'immagine verranno utilizzati per determinare l'insieme di riquadri della mappa da eseguire il rendering. Per controllare la regione esportata, ritaglia l'immagine prima dell'esportazione.
description	string Un nome leggibile dell'attività.
tileOptions	object (TileOptions) Opzioni che descrivono i riquadri della mappa da generare.
tileExportOptions	object (ImageFileExportOptions) Opzioni per la posizione e il formato di esportazione dei riquadri della mappa. Al momento, Cloud Storage è l'unica destinazione supportata per le esportazioni di mappe.
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 è 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.

TileOptions

Opzioni che descrivono i riquadri della mappa di immagini o video da esportare.

Rappresentazione JSON

{ "startZoom": integer, "minZoom": integer, "skipEmpty": boolean, "skipEmptyTiles": boolean, "mapsApiKey": string, "dimensions": { object (GridDimensions) }, "tileDimensions": { object (GridDimensions) }, "stride": integer, "zoomSubset": { object (ZoomSubset) }, // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "endZoom": integer, "maxZoom": integer, "scale": number // End of mutually exclusive fields. }

Campi
startZoom	integer Il livello di zoom per cui iniziare a generare i riquadri della mappa per l'esportazione. Il valore predefinito è zero.
minZoom (deprecated)	integer Questo elemento è obsoleto. Il livello di zoom per cui iniziare a generare i riquadri della mappa per l'esportazione. Il valore predefinito è zero.
skipEmpty	boolean Se il valore è true, salta la scrittura dei riquadri della mappa vuoti (ovvero completamente trasparenti).
skipEmptyTiles (deprecated)	boolean Questo elemento è obsoleto. Se il valore è true, salta la scrittura dei riquadri della mappa vuoti (ovvero completamente trasparenti).
mapsApiKey	string Chiave API di Google Maps Platform facoltativa per il visualizzatore di riquadri della mappa generato.
dimensions	object (GridDimensions) La larghezza e l'altezza dei riquadri video di output, utilizzate solo per l'esportazione di piramidi video a riquadri (ExportVideoMap).
tileDimensions (deprecated)	object (GridDimensions) Questo elemento è obsoleto. La larghezza e l'altezza dei riquadri video di output, utilizzate solo per l'esportazione di piramidi video a riquadri (ExportVideoMap).
stride	integer Passo di riga e colonna del riquadro. (ExportVideoMap) Imposta su 4 per i riquadri sparsi (solo WebGL) o su 1 (valore predefinito) per la massima compatibilità.
zoomSubset	object (ZoomSubset) Un sottoinsieme di livelli di zoom per cui generare i riquadri. Può essere specificato solo in una chiamata a ExportVideoMap.
Il livello di zoom o la scala in cui interrompere la generazione dei riquadri della mappa. È necessario specificare uno dei due. Di seguito è riportato un elenco di campi che si escludono a vicenda. Nella risposta verrà impostato al massimo uno dei campi:
endZoom	integer Il livello di zoom per cui interrompere la generazione dei riquadri della mappa.
maxZoom (deprecated)	integer Questo elemento è obsoleto. Il livello di zoom per cui interrompere la generazione dei riquadri della mappa.
scale	number La risoluzione massima dell'immagine in metri per pixel. La scala verrà convertita nel livello di zoom massimo più appropriato all'equatore.
Fine dei campi che si escludono a vicenda.

ZoomSubset

Un sottoinsieme di livelli di zoom per cui generare i riquadri (ExportVideoMap). I sottoinsiemi di inizio e fine sono valori a doppia precisione, che consentono di eseguire il rendering di un livello o di più livelli di zoom in modo incrementale. Per eseguire il rendering di un'intera piramide con uno zoom iniziale di 12: startZoom=0, endZoom=12, non impostare questo messaggio. Per eseguire il rendering dei livelli 0-11 e del primo 10% del livello 12: startZoom=0, endZoom=12, subset = {min=0, max=12.1 } Per eseguire il rendering del successivo 10% del livello 12: startZoom=0, endZoom=12, subset = {min=12.1, max=12.2 } Per eseguire il rendering del restante 80% del livello 12: startZoom=0, endZoom=12, subset = {min=12.2, max=13 } Tieni presente inoltre che tutti gli shard di esportazione devono avere le stesse dimensioni della piramide (completa) in start/endZoom.

Rappresentazione JSON
{ "start": number, "end": number, "min": number, "max": number }

Campi
start	number Il sottoinsieme del livello di zoom iniziale per cui generare i riquadri (ExportVideoMap). In questo caso, il sottoinsieme è un valore a doppia precisione, che consente di eseguire il rendering di un livello di zoom in modo incrementale, quindi 12.1, ad esempio, è il primo 10% dei riquadri nello zoom 12 in un ordine non specificato ma deterministico.
end	number Il sottoinsieme del livello di zoom finale per cui generare i riquadri (ExportVideoMap), che consente di eseguire il rendering di un livello di zoom in modo incrementale, fino al sottoinsieme massimo (se fornito) in un ordine non specificato ma deterministico.
min (deprecated)	number Questo elemento è obsoleto. Il sottoinsieme del livello di zoom iniziale per cui generare i riquadri (ExportVideoMap). In questo caso, il sottoinsieme è un valore a doppia precisione, che consente di eseguire il rendering di un livello di zoom in modo incrementale, quindi 12.1, ad esempio, è il primo 10% dei riquadri nello zoom 12 in un ordine non specificato ma deterministico.
max (deprecated)	number Questo elemento è obsoleto. Il sottoinsieme del livello di zoom finale per cui generare i riquadri (ExportVideoMap), che consente di eseguire il rendering di un livello di zoom in modo incrementale, fino al sottoinsieme massimo (se fornito) in un ordine non specificato ma deterministico.