Annuncio: tutti i progetti non commerciali registrati per l'utilizzo di Earth Engine prima del 15 aprile 2025 devono verificare l'idoneità non commerciale per mantenere l'accesso a Earth Engine.

Questa pagina è stata tradotta dall'API Cloud Translation.

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/v1beta/{project=projects/*}/map:export

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri

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`

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

Rappresentazione JSON
{ "expression": { object (`Expression`) }, "description": string, "tileOptions": { object (`TileOptions`) }, "tileExportOptions": { object (`ImageFileExportOptions`) }, "requestId": string, "workloadTag": string, "priority": integer }

{
  "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 visualizzare. 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 scegliere dove ed in quale formato esportare i riquadri della mappa. Cloud Storage è attualmente l'unica destinazione supportata per le esportazioni delle 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 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.

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.

TileOptions

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

Rappresentazione JSON

Rappresentazione JSON
{ "startZoom": integer, "skipEmpty": boolean, "mapsApiKey": string, "dimensions": { object (`GridDimensions`) }, "stride": integer, "zoomSubset": { object (`ZoomSubset`) }, // Union field `end_zoom_or_scale` can be only one of the following: "endZoom": integer, "scale": number // End of list of possible types for union field `end_zoom_or_scale`. }

{
  "startZoom": integer,
  "skipEmpty": boolean,
  "mapsApiKey": string,
  "dimensions": {
    object (GridDimensions)
  },
  "stride": integer,
  "zoomSubset": {
    object (ZoomSubset)
  },

  // Union field end_zoom_or_scale can be only one of the following:
  "endZoom": integer,
  "scale": number
  // End of list of possible types for union field end_zoom_or_scale.
}

Campi
`startZoom`	`integer` Il livello di zoom per iniziare a generare riquadri della mappa da esportare. Il valore predefinito è zero.
`skipEmpty`	`boolean` Se true, salta la scrittura di riquadri della mappa vuoti (ovvero completamente trasparenti).
`mapsApiKey`	`string` (Facoltativo) Chiave API Google Maps Platform per il visualizzatore di riquadri della mappa generati.
`dimensions`	`object (GridDimensions)` La larghezza e l'altezza dei riquadri video di output, utilizzati solo per l'esportazione di piramidi video a riquadri (ExportVideoMap).
`stride`	`integer` Passaggio di righe e colonne dei riquadri. (ExportVideoMap) Imposta il valore 4 per i riquadri sparsi (solo WebGL) o 1 (valore predefinito) per la massima compatibilità.
`zoomSubset`	`object (ZoomSubset)` Un sottoinsieme di livelli di zoom per i quali generare riquadri. Può essere specificato solo in una chiamata a `ExportVideoMap`.
Campo unione `end_zoom_or_scale`. Il livello di zoom o la scala a cui interrompere la generazione di riquadri della mappa. È necessario specificare uno di questi valori. `end_zoom_or_scale` può essere solo uno dei seguenti:
`endZoom`	`integer` Il livello di zoom per cui interrompere la generazione di tessere 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.

ZoomSubset

Un sottoinsieme di livelli di zoom per i quali generare riquadri (ExportVideoMap), i sottoinsiemi iniziale e finale sono valori a doppia precisione, che ti consentono di eseguire il rendering di un livello o 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 visualizzare i livelli 0-11 e il primo 10% del livello 12: startZoom=0, endZoom=12, subset = {min=0, max=12.1 } Per visualizzare il 10% successivo del livello 12: startZoom=0, endZoom=12, subset = {min=12.1, max=12.2 } Per visualizzare l'80% rimanente del livello 12: startZoom=0, endZoom=12, subset = {min=12.2, max=13 } Tieni inoltre presente che tutti i frammenti di esportazione devono avere la stessa dimensione della piramide (completa) in start/endZoom.

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

Campi

Campi
`start`	`number` Sottoinsieme del livello di zoom iniziale per cui generare i riquadri (ExportVideoMap) Qui, 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 con lo zoom 12 in un ordine non specificato, ma deterministico.
`end`	`number` Sottoinsieme di livello di zoom finale per cui generare 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.

start

number

Sottoinsieme del livello di zoom iniziale per cui generare i riquadri (ExportVideoMap) Qui, 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 con lo zoom 12 in un ordine non specificato, ma deterministico.

end