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 dei vettori utilizzando Editor di codice, consulta Importazione di dati vettoriali.)
Caricamento di asset immagine
GeoTIFF
Nell'editor di codice, puoi caricare file immagine GeoTIFF di dimensioni massime pari a 10 GB nella tua cartella utente di Earth Engine. Per file di dimensioni maggiori, utilizza l'opzione di caricamento a riga di comando.
Per caricare un file GeoTIFF utilizzando l'editor di codice,
seleziona la scheda Asset nell'angolo in alto a sinistra,
fai clic sul pulsante 
e poi seleziona Carica
immagine. Earth Engine presenta una finestra di dialogo di caricamento simile alla
Figura 1. Fai clic sul pulsante SELEZIONA e vai a un file GeoTIFF sul tuo
file system locale.
Assegna all'immagine un ID risorsa appropriato (che non esista già) nella
cartella utente. Se vuoi caricare l'immagine in una cartella o una raccolta esistente,
anteponi all'ID risorsa l'ID della cartella o della 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à viene visualizzata un'attività "Importazione asset" sul lato destro dell'editor di codice. Se passi il mouse sopra l'attività in Task Manager, viene visualizzato un messaggio
? che puoi utilizzare per controllare lo stato del caricamento. Per annullare un caricamento,
fai clic sull'icona con il cerchio che gira 
accanto all'attività. Al termine dell'importazione, l'asset verrà visualizzato nella cartella dell'utente con
un'icona .
Compressione GeoTIFF
I file GeoTIFF possono essere compressi con DEFLATE, JPEG-XL/JXL, LERC, LERC_DEFLATE, LERC_ZSTD, LZMA, LZW, WEBP o ZSTD.
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: i file saranno più grandi e i tempi di caricamento più lunghi.
- Compressione con perdita di dati (ad es. JPEG): potrebbero essere alterati i valori dei pixel. Utilizza la compressione senza perdita di dati (ad es. DEFLATE, LZMA, LZW, ZSTD) anziché con perdita, 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. In particolare, per importare le previsioni (come immagine) effettuate sulle immagini esportate,
- Esporta le immagini in uno o più file TFRecord.
- Esegui l'inferenza sulle immagini (ad es.
model.predict()). - Scrivi l'output di
model.predict()in un file TFRecord. Le previsioni devono essere nello stesso ordine delle esportazioni delle immagini su cui hai eseguito l'inferenza. L'ordine può essere applicato tramite una sorta di ordinamento dei nomi dei file prodotti dall'esportazione. Per informazioni dettagliate, 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 della risorsa specificando una o più proprietà dei metadati. Nel menu Proprietà, fai clic su Aggiungi proprietà per definire il nome e il valore di una 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 singola virgolette
(') prima del numero.
Per impostazione predefinita, viene aggiunta una proprietà system:time_start
senza valore. Questa proprietà viene utilizzata da Earth Engine per applicare
i filtri delle date ImageCollection. Inserisci una data nel formato mostrato
nella Figura 2 o un numero che rappresenti i millisecondi trascorsi dal 1° gennaio 1970. (consulta
il glossario per ulteriori informazioni sui timestamp in Earth Engine).
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 il criterio di piramidizzazione e la modalità di mascheramento per i dati.
Il criterio di piramidizzazione specifica in che modo Earth Engine genera versioni con risoluzione inferiore dell'immagine. Scopri di più su come Earth Engine gestisce più risoluzioni nel documento relativo alla scala. Scegli un criterio di piramidizzazione "Media", "Minima" o "Massima" per calcolare i livelli di risoluzione inferiori della piramide di immagini come media, minima o massima di ogni gruppo 2x2 di pixel a risoluzione più elevata. Si tratta di un'opzione adatta per le immagini con valori continui. Per i dati di tipo categorico (ad es. la copertura del suolo) o di QA, scegli un'opzione di elaborazione gerarchica "Sample" (pixel in alto a sinistra) o "Mode" (valore che si verifica più di frequente o campione se non è presente alcuna modalità).
La modalità di mascheramento indica in che modo l'immagine caricata è mascherata (se lo è). 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, seleziona "Utilizza ultima banda come banda alpha". La banda alpha deve essere una banda senza segno a 8 bit in cui 0 corrisponde ai dati mascherati (completamente trasparenti) e 255 è completamente opaco.
Caricamenti a 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 dell'utente.
Esistono alcuni vincoli per i tipi di file che possono essere caricati in un asset illustrativo. In particolare:
- Le immagini devono avere lo stesso numero di bande, la stessa profondità di bit, la stessa proiezione, la stessa risoluzione e gli stessi valori di riempimento.
- L'offset da un file all'altro deve essere un multiplo intero delle dimensioni dei pixel.
- Gli spazi tra i riquadri verranno riempiti con pixel mascherati nell'immagine finale, pertanto i riquadri devono essere idealmente adiacenti e non sparsi. Le immagini con spazi vuoti che occupano più del 99% dell'area dell'immagine non verranno importate.