Puoi utilizzare Asset Manager o l'interfaccia a riga di comando (CLI) per caricare immagini o altri set di dati raster georeferenziati in formato GeoTIFF o TFRecord. Per informazioni dettagliate sull'importazione di vettori utilizzando l'editor di codice, consulta Importazione di dati vettoriali.
Caricamento degli asset immagine in corso…
GeoTIFF
Nell'editor di codice, puoi caricare file immagine GeoTIFF di dimensioni fino a 10 GB nella cartella utente di Earth Engine. (Per i file più grandi, utilizza l'opzione di caricamento da riga di comando).
Per caricare un GeoTIFF utilizzando l'editor di codice,
seleziona la scheda Asset nell'angolo in alto a sinistra,
fai clic sul pulsante 
, quindi seleziona Caricamento
immagine. Earth Engine presenta una finestra di dialogo di caricamento simile alla Figura 1. Fai clic sul pulsante SELEZIONA e vai a un GeoTIFF nel file system locale.
Assegna all'immagine un ID asset appropriato (che non esiste già) nella tua cartella utente. Se vuoi caricare l'immagine in una cartella o raccolta esistente, anteponi all'ID asset l'ID cartella o raccolta, ad esempio projects/myproject/folder-or-collection-id/new-asset.
Fai clic su CARICA per avviare il caricamento.
Una volta avviato il caricamento, nella scheda Attività sul lato destro dell'editor di codice viene visualizzata un'attività "Importazione asset". Se passi il mouse sopra l'attività nel Task Manager, viene visualizzato un simbolo ? che puoi utilizzare per controllare lo stato del caricamento. Per annullare un caricamento, fai clic sull'icona rotante 
accanto all'attività. Una volta completata l'importazione, l'asset verrà visualizzato nella cartella utente con un'icona .
Compressione GeoTIFF
I file GeoTIFF possono essere compressi con DEFLATE, JPEG, JPEG-XL/JXL, LERC, LERC_DEFLATE, LERC_ZSTD, LZMA, LZW, WEBP o ZSTD. I GeoTIFF ottimizzati per Cloud (COG) che Earth Engine legge in loco anziché importare accettano un insieme più ristretto; consulta Compressione COG.
Consigli per un'esperienza di caricamento ottimale per i file di grandi dimensioni:
- Scelta migliore: ZSTD offre un buon equilibrio tra velocità e compressione.
- Da evitare: LZMA può essere molto lento nonostante una buona compressione.
- File non compressi: generano file di dimensioni maggiori e tempi di caricamento più lunghi.
- Compressione con perdita di dati (ad es. JPEG): può alterare i valori dei pixel. Utilizza la compressione senza perdita di dati (ad es. DEFLATE, LZMA, LZW, ZSTD) anziché con perdita di dati, a meno che tu non comprenda il potenziale impatto sui tuoi dati.
TFRecord
Per caricare un'immagine da un file TFRecord, devi disporre del file mixer associato che è stato generato quando hai esportato le immagini su cui hai eseguito l'inferenza. Per maggiori dettagli sul file del mixer, consulta la pagina di esportazione. Più precisamente, per importare le previsioni (come immagine) effettuate sulle immagini esportate,
- Esporta le immagini in uno o più file TFRecord.
- Esegui l'inferenza sulle immagini (ovvero
model.predict()). - Scrivi l'output di
model.predict()in un file TFRecord. Le previsioni devono essere nello stesso ordine delle esportazioni di immagini su cui hai eseguito l'inferenza. L'ordine può essere applicato ordinando i nomi file prodotti dall'esportazione. Per maggiori dettagli, consulta la sezione relativa alle esportazioni di file di grandi dimensioni. - Carica i file TFRecord e il mixer associato su Earth Engine.
Modifica delle proprietà
Modifica i metadati degli asset specificando una o più proprietà dei metadati. Nel menu Proprietà, fai clic su Aggiungi proprietà per definire un nome e un valore della proprietà (Figura 2). Il valore può essere una stringa o un numero.
Inserisci le stringhe senza virgolette. Per formattare un numero come stringa, inserisci una virgoletta singola (') prima del numero.
Per impostazione predefinita, viene aggiunta una proprietà system:time_start senza valore. Questa proprietà viene utilizzata da Earth Engine quando applica i filtri per data ImageCollection. Inserisci una data nel formato mostrato nella Figura 2 o un numero che rappresenta i millisecondi trascorsi dal 1° gennaio 1970. (Per ulteriori informazioni sui timestamp in Earth Engine, consulta il glossario).
Asset Manager interpreta un numero inserito come valore per una proprietà denominata system:time_start o system:time_end come millisecondi e lo formatta come data.
Fai clic sull'icona per rimuovere una proprietà.
Opzioni avanzate
Nel menu Avanzate, scegli la policy di piramidazione e la modalità di mascheramento per i tuoi dati.
La policy di piramidizzazione specifica il modo in cui Earth Engine genera versioni dell'immagine con risoluzione inferiore. Scopri di più su come Earth Engine gestisce più risoluzioni nel documento sulla scala. Scegli una policy di piramidizzazione "Media", "Min" o "Max" per calcolare i livelli di risoluzione inferiori della piramide di immagini come media, minimo o massimo di ogni gruppo 2x2 di pixel con risoluzione più alta. Questa è un'opzione adatta per le immagini con valori continui. Per i dati categorici (ad es. copertura del suolo) o di QA, scegli una policy di piramidizzazione "Campione" (il pixel in alto a sinistra) o "Modalità" (il valore più frequente o il campione se non esiste una modalità).
La modalità di mascheramento indica come viene mascherata l'immagine caricata (se applicabile). Per specificare un valore senza dati, seleziona "Valore senza dati" e inserisci il valore. I pixel con questo valore verranno mascherati nell'immagine caricata. Questo valore viene applicato a ogni banda dell'immagine in modo indipendente. Per utilizzare l'ultima banda dell'immagine come maschera per le altre bande dell'immagine, seleziona "Utilizza l'ultima banda come banda alfa". La banda alfa deve essere una banda a 8 bit senza segno in cui 0 indica i dati mascherati (completamente trasparenti) e 255 indica i dati completamente opachi.
Caricamenti in riquadri
Per caricare una singola immagine come più riquadri, in cui ogni riquadro è archiviato in un file di origine diverso, fai clic su Aggiungi un altro file per aggiungere altri file al caricamento. Earth Engine combinerà i riquadri per creare un'unica immagine nella cartella utente.
Esistono alcune limitazioni sui tipi di file che possono essere caricati in un asset immagine. In particolare:
- Le immagini devono avere lo stesso numero di bande, profondità di bit, proiezione, risoluzione e valori di riempimento.
- L'offset da un file all'altro deve essere un multiplo intero della dimensione in pixel.
- Gli spazi tra i riquadri verranno riempiti con pixel mascherati nell'immagine finale, quindi i riquadri dovrebbero idealmente essere adiacenti e non sparsi. Le immagini con spazi vuoti che occupano più del 99% dell'area dell'immagine non verranno importate.