Per informazioni sull'esportazione in altri formati, tra cui immagini, video e tabelle (dati vettoriali), consulta Esportazione dei dati.
Panoramica
Per visualizzare i dati delle immagini (dati raster) su una mappa online, puoi esportare i riquadri della mappa utilizzando Export.map.toCloudStorage(). Questa funzione esporta una piramide di riquadri della mappa in un bucket Cloud Storage, da cui può essere pubblicata pubblicamente o privatamente. È utile quando i dati delle immagini sono troppo grandi per essere sovrapposti come singola immagine. Questi riquadri utilizzano le coordinate dei riquadri di Google Maps e sono adatti per la visualizzazione tramite Google Maps Platform (API di Maps), Google Earth per il web e altre piattaforme di mappatura. Puoi visualizzare facilmente l'anteprima dei riquadri in Google Maps o Earth utilizzando i file HTML forniti nell'ambito dell'esportazione.
Esistono diverse impostazioni e passaggi per l'esportazione, che potrebbero essere necessari o meno, a seconda di come prevedi di utilizzare o pubblicare i tuoi riquadri. Alcune piattaforme di mappatura richiedono che i riquadri siano accessibili pubblicamente, mentre altre funzionano con riquadri privati. Se utilizzi una delle API di Google Maps, probabilmente devi disporre di una chiave API di Google Maps Platform. Se fornisci tile a Google Earth o ad altre piattaforme di mappatura, probabilmente dovrai impostare le opzioni Livello di accesso e Accesso JS (CORS) appropriate, a seconda di come prevedi di utilizzare i tile. Per le impostazioni richieste, consulta la sezione Linee guida specifiche per la piattaforma di seguito.
Esporta i riquadri della mappa in Cloud Storage
L'esempio seguente esporta i riquadri da un'immagine Landsat per un'area della California.
Editor di codice (JavaScript)
// --- Example Export Map Tiles - basic --- // Specify area to clip/export, setup image and preview on map. var exportRegion = ee.Geometry.BBox(-122.9, 37.1, -121.2, 38.2); var landsatImage = ee.Image('LANDSAT/LC09/C02/T1_TOA/LC09_044034_20220111') .select(['B4', 'B3', 'B2']) .visualize({min: 0.02, max: 0.4, gamma: 1.2}) .clip(exportRegion); Map.addLayer(landsatImage, {}, 'landsatImage'); Map.centerObject(exportRegion); // Set up Export task. Export.map.toCloudStorage({ image: landsatImage, description: 'mapTilesForEE', bucket: 'yourBucketName', // replace with your GCS bucket name fileFormat: 'auto', maxZoom: 13, region: exportRegion, writePublicTiles: true });
import ee import geemap.core as geemap
Colab (Python)
# --- Example Export Map Tiles - basic --- # Specify area to clip/export, setup image and preview on map. export_region = ee.Geometry.BBox(-122.9, 37.1, -121.2, 38.2) landsat_image = ( ee.Image('LANDSAT/LC09/C02/T1_TOA/LC09_044034_20220111') .select(['B4', 'B3', 'B2']) .visualize(min=0.02, max=0.4, gamma=1.2) .clip(export_region) ) m = geemap.Map() m.add_layer(landsat_image, {}, 'landsatImage') m.center_object(export_region) display(m) # Set up Export task. task = ee.batch.Export.map.toCloudStorage( image=landsat_image, description='mapTilesForEE', bucket='yourBucketName', # replace with your GCS bucket name fileFormat='auto', maxZoom=13, region=export_region, writePublicTiles=True, ) task.start()
Tieni presente che in questo modo viene creata una nuova directory nel bucket Cloud Storage specificato, denominata in base al parametro description per impostazione predefinita. Puoi modificare il nome della directory o specificare
le sottodirectory con il parametro path. Puoi utilizzare i file index.html ed earth.html nella directory di output per visualizzare l'anteprima dei riquadri in Maps o Earth.
Opzioni ACL e CORS
L'esempio precedente imposta gli ACL (elenco di controllo dell'accesso) dei riquadri in modo da renderli accessibili pubblicamente tramite richiesta diretta, ma non imposta l'accesso JS del bucket (impostazioni CORS) per consentire alle app web di accedervi.
Ciò significa che questi riquadri esportati possono essere visualizzati nelle anteprime di Maps ed Earth, ma non saranno utili per altre piattaforme che richiedono l'accesso JS. Si presume che tu sia il proprietario del bucket di output.
Se sei un writer del bucket di output specificato (ma non il proprietario), imposta writePublicTiles su false per utilizzare l'ACL dell'oggetto predefinito del bucket di output.
Se vuoi rendere i tuoi riquadri accessibili pubblicamente da tutte le app web, aggiungi bucketCorsUris: ['*'] ai parametri dell'attività. Tieni presente che l'accesso JS pubblico completo potrebbe non essere auspicabile se esiste il rischio che terze parti utilizzino i tuoi riquadri e generino costi cloud. Per limitare questo comportamento, puoi limitare l'accesso JS solo alle app web in domini o URL specifici. Tieni presente che le impostazioni di accesso JS (CORS) vengono applicate a livello di intero bucket, non a livello di cartella o oggetto.
Le ACL e CORS possono essere impostate utilizzando rispettivamente i parametri writePublicTiles e bucketCorsUris o dalla finestra di dialogo dell'attività di esportazione, come mostrato di seguito:
Export.map.toCloudStorage().
- Accesso in visualizzazione/download. Se vuoi accedere (ad es. dall'editor di codice o dalle app Earth Engine), devi rendere i riquadri "Accessibili pubblicamente".
- Accesso JS. Il bucket in cui viene esportata la mappa deve consentire la leggibilità se vuoi che l'editor di codice, le app Earth Engine o altre app web abbiano accesso ai riquadri. Queste impostazioni delle richieste multiorigine (CORS) devono essere configurate a livello di bucket. Per comodità, la finestra di dialogo di esportazione di Earth Engine consente di configurare CORS per il bucket al momento dell'esportazione.
- NOTA: le impostazioni di accesso JS/CORS vengono applicate a livello di bucket, NON a livello di cartella o oggetto, pertanto la modifica delle impostazioni le aggiornerà per tutte le cartelle e gli oggetti nel bucket. Scopri di più nella documentazione CORS di Cloud Storage, ad esempio come visualizzare la configurazione CORS corrente per un bucket.
Elenco dei parametri
Di seguito è riportato un elenco di tutti i parametri per un'attività di esportazione di un riquadro della mappa, che mostra il nome del parametro (argomento) nel codice e il campo corrispondente nella finestra di dialogo dell'attività (se applicabile). Tieni presente che alcuni campi si escludono a vicenda (ad es. maxzoom e scale). Per ulteriori dettagli, consulta la documentazione di Export.map.
| Argomento nel codice | Campo nella finestra di dialogo dell'attività | Note |
|---|---|---|
| immagine | n/a | L'immagine da esportare come riquadri. Deve essere un'immagine, non una raccolta di immagini. |
| descrizione | Nome attività | Un nome leggibile per l'attività. Il valore predefinito è "myExportMapTask". Viene utilizzato anche come nome della cartella per i riquadri, se il parametro "path" (prefisso di output) non è specificato. |
| bucket | Nome bucket GCS | Il bucket di destinazione in cui scrivere. |
| fileFormat | Formato file | Il formato file dei riquadri della mappa, uno tra: "auto", "png" o "jpg". Il valore predefinito è "auto", il che significa che i riquadri opachi verranno codificati come "jpg" e i riquadri con trasparenza verranno codificati come "png". |
| percorso | Prefisso output | La stringa utilizzata come percorso dell'output. Il carattere "/" finale è facoltativo. Il valore predefinito è la descrizione dell'attività (Nome attività) |
| writePublicTiles | Visualizza/scarica il livello di accesso | Indica se scrivere tile pubbliche anziché utilizzare l'ACL degli oggetti predefinito del bucket. Il valore predefinito è true e l'invoker deve essere OWNER del bucket. |
| maxZoom | Risoluzione massima e zoom massimo | Il livello di zoom massimo dei riquadri della mappa da esportare. |
| scalabilità | Risoluzione massima e scala massima | La risoluzione massima dell'immagine in metri per pixel, in alternativa a "maxZoom". La scala verrà convertita nel livello di zoom massimo più appropriato all'equatore. |
| minZoom | Risoluzione massima e zoom minimo | Il livello di zoom minimo facoltativo dei riquadri della mappa da esportare. Il valore predefinito è zero. |
| regione | n/a | Un LinearRing, un Polygon o delle coordinate che rappresentano la regione da esportare. Per i dettagli, consulta la documentazione. |
| skipEmptyTiles | n/a | Se il valore è true, ignora la scrittura di tile della mappa vuoti (ovvero completamente trasparenti). Il valore predefinito è false. |
| mapsApiKey | Chiave API di Google Maps | Utilizzata in index.html per inizializzare l'API di Google Maps. In questo modo, il messaggio "Solo per scopi di sviluppo" viene rimosso dalla mappa. |
| bucketCorsUris | Aggiungi l'accesso JS (e il sito web da consentire) | Un elenco di domini (ad es. https://code.earthengine.google.com) autorizzati a recuperare i riquadri esportati tramite JavaScript (CORS). |
Scala e zoom
Nell'esempio precedente, maxZoom è impostato su 13.
I livelli di zoom corrispondono a griglie di pixel di dimensioni diverse con cui visualizzare una mappa globale. Per maggiori dettagli, consulta il riferimento per le coordinate pixel. A causa della curvatura della Terra, la risoluzione dei pixel a un determinato livello di zoom varia in base alla latitudine. In particolare, i metri per pixel diminuiscono di un fattore pari a cos(latitudine). La tabella seguente mostra i metri per pixel, a ogni livello di zoom, all'equatore per la proiezione di Google Mercator:
| Livello di zoom | Dimensioni pixel (all'equatore) | Livello di zoom | Dimensioni pixel (all'equatore) |
|---|---|---|---|
| 0 | 156 km | 10 | 152 m |
| 1 | 78 km | 11 | 76 m |
| 2 | 39 km | 12 | 38 m |
| 3 | 20 km | 13 | 19 m |
| 4 | 10 km | 14 | 9,6 m |
| 5 | 4,9 km | 15 | 4,8 m |
| 6 | 2,4 km | 16 | 2,4 m |
| 7 | 1,2 km | 17 | 1,2 m |
| 8 | 611 m | 18 | 0,6 m |
| 9 | 305 m | 19 | 0,3 m |
| 20 | 0,15 m |
Osserva dalla tabella precedente che il valore maxZoom impostato nell'esempio corrisponde a 19 metri all'equatore, più piccolo alle latitudini più elevate. Questo valore è inferiore alla risoluzione nominale di 30 secondi d'arco per pixel dell'immagine di input. Di conseguenza, la mappa visualizzata nel file di output
index.html
può essere ingrandita fino a quando i pixel nella risoluzione nativa non sono visibili nella mappa.
Per limitare la visualizzazione della mappa alla risoluzione in pixel nativa, imposta maxZoom su un valore corrispondente alla risoluzione nativa o inferiore.
Linee guida specifiche per la piattaforma
Di seguito sono riportate alcune piattaforme in cui potresti voler visualizzare e utilizzare i riquadri della mappa. Ogni sezione indica quali impostazioni sono necessarie per il funzionamento dei riquadri con quella piattaforma e una copia del codice di esempio con i parametri necessari.
Utilizza i riquadri di mappa in Earth Engine (editor di codice o app EE)
Se vuoi esportare i riquadri della mappa solo per riutilizzarli in Google Earth Engine o nelle app EE, imposta "Livello di accesso" su "Accessibile pubblicamente" e "Livello di accesso JS" (nella finestra di dialogo dell'attività) su "Aggiungi accesso a Earth Engine" o "Aggiungi accesso pubblico". In alternativa, puoi impostare questi parametri nel codice:
writePublicTiles: true, bucketCorsUris: ['https://code.earthengine.google.com','https://*.earthengine.app']
Una volta esportati, i riquadri saranno accessibili in Earth Engine.
Editor di codice (JavaScript)
// --- Export Map Tiles for use in EE --- // Use image setup code from example at top of the page. // Set up Export task. Export.map.toCloudStorage({ image: landsatImage, description: 'mapTilesForEE', bucket: 'yourBucketName', // replace with your GCS bucket name fileFormat: 'auto', maxZoom: 13, region: exportRegion, writePublicTiles: true, bucketCorsUris: ['https://code.earthengine.google.com','https://*.earthengine.app'] });
import ee import geemap.core as geemap
Colab (Python)
# --- Export Map Tiles for use in EE --- # Use image setup code from example at top of the page. # Set up Export task. task = ee.batch.Export.map.toCloudStorage( image=landsat_image, description='mapTilesForEE', bucket='yourBucketName', # replace with your GCS bucket name fileFormat='auto', maxZoom=13, region=export_region, writePublicTiles=True, bucketCorsUris=[ 'https://code.earthengine.google.com', 'https://*.earthengine.app', ], ) task.start()
Visualizza un'anteprima di Google Maps
Per visualizzare l'anteprima dei riquadri della mappa su Google Maps, vai alla cartella di output su Google Cloud Storage e apri il file "index.html" nel browser. In questo modo, si aprirà una mappa a pagina intera che mostra i tuoi riquadri su Google Maps utilizzando l'API JavaScript di Google Maps Platform, come questa: index.html. Un'esportazione di base genererà tile della mappa base disattivate e con la filigrana "Solo per scopi di sviluppo". Per evitare questo problema e mostrare i riquadri della mappa base standard di Google, genera una chiave API e includila nelle impostazioni di esportazione.
Se fornisci una chiave API al momento dell'esportazione, questa pagina di anteprima è visibile pubblicamente, può essere incorporata in altre pagine e non richiede che il visualizzatore sia un utente Earth Engine registrato.
Editor di codice (JavaScript)
// --- Export Map Tiles for use with Map Preview --- // Use image setup code from example at top of the page. // Set up Export task. Export.map.toCloudStorage({ image: landsatImage, description: 'mapTilesForMapPreview', bucket: 'yourBucketName', // replace with your GCS bucket name fileFormat: 'auto', maxZoom: 13, region: exportRegion, writePublicTiles: true, mapsApiKey: 'fakeMapsApiKey012345' // replace with a valid API Key });
import ee import geemap.core as geemap
Colab (Python)
# --- Export Map Tiles for use with Map Preview --- # Use image setup code from example at top of the page. # Set up Export task. task = ee.batch.Export.map.toCloudStorage( image=landsat_image, description='mapTilesForMapPreview', bucket='yourBucketName', # replace with your GCS bucket name fileFormat='auto', maxZoom=13, region=export_region, writePublicTiles=True, mapsApiKey='fakeMapsApiKey012345', # replace with a valid API Key ) task.start()
Visualizza un'anteprima di Google Earth
Per visualizzare l'anteprima dei riquadri della mappa in Google Earth sul web, assicurati di esportare i riquadri con il livello di accesso impostato su "Accessibile pubblicamente". Quindi vai alla cartella di output su Google Cloud Storage, apri il file "earth.html" nel browser, come questo: earth.html e fai clic sul pulsante "Apri in Google Earth" visualizzato. In questo modo si aprirà Google Earth e i riquadri verranno visualizzati sulla mappa 3D. È buona norma impostare anche il livello "Accesso JS" su "Accessibile pubblicamente", in modo da poter utilizzare i riquadri in Google Earth senza il file di anteprima (che utilizza un server proxy se i riquadri non hanno le impostazioni di accesso JS/CORS necessarie).
Per scaricare un file KML contenente un link ai tuoi dati, fai clic sul menu con tre puntini in Google Earth e seleziona "Esporta come file KML". Nota: il file KML generato in questo modo NON è compatibile con Google Earth Pro (la versione desktop di Earth).
Editor di codice (JavaScript)
// --- Export Map Tiles for use with Earth Preview --- // Use image setup code from example at top of the page. // Set up Export task. Export.map.toCloudStorage({ image: landsatImage, description: 'mapTilesForEarthPreview', bucket: 'yourBucketName', // replace with your GCS bucket name fileFormat: 'auto', maxZoom: 13, region: exportRegion, writePublicTiles: true, bucketCorsUris: [] // leaving blank is ok for Earth Preview only // for direct use in Earth, set to: ['https://earth.google.com'] // or set to public: ['*'] (risk of misuse) });
import ee import geemap.core as geemap
Colab (Python)
# --- Export Map Tiles for use with Earth Preview --- # Use image setup code from example at top of the page. # Set up Export task. task = ee.batch.Export.map.toCloudStorage( image=landsat_image, description='mapTilesForEarthPreview', bucket='yourBucketName', # replace with your GCS bucket name fileFormat='auto', maxZoom=13, region=export_region, writePublicTiles=True, bucketCorsUris=[], # leaving blank is ok for Earth Preview only # for direct use in Earth, set to: ['https://earth.google.com'] # or set to public: ['*'] (risk of misuse) ) task.start()
Pubblica con Google Maps Platform (API di Google Maps)
Per creare un set di tile di mappa pronti per la pubblicazione tramite Google Maps Platform, devi avere o creare una chiave API e assicurarti che il livello di accesso sia impostato su "Accessibile pubblicamente". A seconda di come l'applicazione API di Google Maps accede ai riquadri, potresti anche dover impostare un "Livello di accesso JS" appropriato per il tuo sito. Dopo aver esportato i riquadri, l'output nella scheda Attività dell'editor di codice fornisce un URL per i riquadri con le variabili appropriate da utilizzare con l'API di Google Maps, ad esempio:
https://storage.googleapis.com/my_bucket/my_test_tiles/{Z}/{X}/{Y}
Editor di codice (JavaScript)
// --- Export Map Tiles for use with Maps Platform APIs --- // Use image setup code from example at top of the page. // Set up Export task. Export.map.toCloudStorage({ image: landsatImage, description: 'mapTilesForMapsPlatform', bucket: 'yourBucketName', // replace with your GCS bucket name fileFormat: 'auto', maxZoom: 13, region: exportRegion, writePublicTiles: true, bucketCorsUris: ['*'], // '*' = All domains = risk of misuse // For better protection, specify the domain(s) where the // tiles will be used, eg: ['https://mysite.mydomain.com'] mapsApiKey: 'fakeMapsApiKey012345' // replace with a valid API Key });
import ee import geemap.core as geemap
Colab (Python)
# --- Export Map Tiles for use with Maps Platform APIs --- # Use image setup code from example at top of the page. # Set up Export task. task = ee.batch.Export.map.toCloudStorage( image=landsat_image, description='mapTilesForMapsPlatform', bucket='yourBucketName', # replace with your GCS bucket name fileFormat='auto', maxZoom=13, region=export_region, writePublicTiles=True, bucketCorsUris=['*'], # '*' = All domains = risk of misuse # For better protection, specify the domain(s) where the # tiles will be used, eg: ['https://mysite.mydomain.com'] mapsApiKey='fakeMapsApiKey012345', # replace with a valid API Key ) task.start()
Pubblica su Google Earth (sul web)
Per creare un insieme di riquadri della mappa da pubblicare pubblicamente tramite Google Earth, devi impostare il livello di accesso su "Accessibile pubblicamente" e il livello di accesso JS in modo da consentire "https://earth.google.com" (o "Accessibile pubblicamente"). Dopo l'esportazione, puoi visualizzarli in anteprima in Google Earth utilizzando il file earth.html nella directory di esportazione (vedi sopra).
Editor di codice (JavaScript)
// --- Export Map Tiles for use with Google Earth web --- // Use image setup code from example at top of the page. // Set up Export task. Export.map.toCloudStorage({ image: landsatImage, description: 'mapTilesForEarthWeb', bucket: 'yourBucketName', // replace with your GCS bucket name fileFormat: 'auto', maxZoom: 13, region: exportRegion, writePublicTiles: true, bucketCorsUris: ['https://earth.google.com'] // ['*'] will also work, but risks misuse });
import ee import geemap.core as geemap
Colab (Python)
# --- Export Map Tiles for use with Google Earth web --- # Use image setup code from example at top of the page. # Set up Export task. task = ee.batch.Export.map.toCloudStorage( image=landsat_image, description='mapTilesForEarthWeb', bucket='yourBucketName', # replace with your GCS bucket name fileFormat='auto', maxZoom=13, region=export_region, writePublicTiles=True, bucketCorsUris=['https://earth.google.com'], # ['*'] will also work, but risks misuse ) task.start()
Una volta esportati i riquadri, puoi aggiungerli a un progetto in Google Earth web. L'output nella scheda Attività dell'editor di codice (mostrata di seguito) fornisce l'URL dei tuoi riquadri con le variabili appropriate da utilizzare in Google Earth, ad esempio:
https://storage.googleapis.com/my_bucket/my_test_tiles/$[level]/$[x]/$[y]
Per utilizzarlo in Earth web, crea una funzionalità Overlay di riquadri e aggiungi questo URL come "URL overlay". Se il tuo set di dati non è globale e vuoi evitare errori di richiesta di riquadri per riquadri inesistenti, assicurati di aprire la sezione "Opzioni di overlay" e di regolare i quattro parametri di copertura dei riquadri in modo che corrispondano alle estensioni dei riquadri esportati.
Pubblicazione su altre piattaforme di mappatura
Quando esporti i riquadri per utilizzarli con altre piattaforme o applicazioni, le impostazioni necessarie dipendono dal modo in cui accedono ai riquadri. Per rendere i riquadri il più accessibili possibile, imposta il livello di accesso su "Accessibile pubblicamente" e il livello di accesso JS su "Accessibile pubblicamente".
Genera una chiave API Google Maps Platform
Se prevedi di utilizzare i tuoi riquadri di mappa con Google Maps Platform o vuoi visualizzarli in anteprima su Maps senza la mappa base limitata per gli sviluppatori, devi disporre o generare una chiave API di Google Maps Platform e includerla nelle impostazioni di esportazione o aggiungerla ai siti in un secondo momento. Questo non è necessario per l'utilizzo con Google Earth.
Quando esporti i riquadri della mappa da Earth Engine, generiamo una pagina HTML di esempio archiviata nella directory di output per consentirti di visualizzare l'anteprima dei riquadri utilizzando l'API JavaScript di Google Maps Platform. Se vuoi, puoi fornire una chiave API di Google Maps Platform al momento dell'esportazione, che verrà utilizzata per le chiamate API del visualizzatore di esempio.
Per generare subito una chiave API Google Maps Platform, segui questi quattro passaggi:
- Fai clic sul pulsante "Crea chiave API di Maps Platform" di seguito.
- Seleziona il progetto Cloud per la tua chiave API e fai clic su AVANTI.
- Fai clic su per copiare la nuova chiave e incollala nella finestra di dialogo Esporta mappa nell'editor di codice.
- (Consigliato) Fai clic sul link della console API sotto la nuova chiave per impostare le limitazioni dei referrer. Per ulteriori dettagli, consulta le restrizioni relative ai referrer e alle applicazioni.
Crea una chiave API di Maps Platform
Aggiungi limitazioni dei referrer a una chiave API
Quando aggiungi una chiave API, le limitazioni dei referrer assicurano che solo le app designate possano utilizzare la tua chiave. Puoi impostare o modificare le restrizioni dei referrer in qualsiasi momento visitando la pagina Credenziali nella console Cloud e seguendo questi passaggi:
- Assicurati che nel menu a discesa nella parte superiore dello schermo sia selezionato il nome del progetto corretto.
- Fai clic sulla chiave API di Maps Platform generata sopra per visualizzarne i dettagli.
-
Seleziona Referrer HTTP (siti web) e specifica il bucket Cloud Storage specificato in
Export.map.toCloudStorageutilizzando il seguente template:https://storage.googleapis.com/{bucket}/* - Fai clic su Salva. Dovrebbe essere visualizzato l'indicatore "Salvataggio in corso…".