Vous pouvez utiliser le gestionnaire d'éléments ou l'interface de ligne de commande (CLI) pour importer des images ou d'autres ensembles de données matricielles géoréférencées au format GeoTIFF ou TFRecord. (Pour en savoir plus sur l'importation de vecteurs à l'aide de l'éditeur de code, consultez Importer des données vectorielles.)
Importation des composants Image…
GeoTIFF
Dans l'éditeur de code, vous pouvez importer des fichiers image GeoTIFF d'une taille maximale de 10 Go dans votre dossier utilisateur Earth Engine. (Pour les fichiers plus volumineux, utilisez l'option d'importation par ligne de commande.)
Pour importer un fichier GeoTIFF à l'aide de l'éditeur de code, sélectionnez l'onglet "Assets" (Éléments) en haut à gauche, cliquez sur le bouton 
, puis sélectionnez Image upload (Importer une image). Earth Engine affiche une boîte de dialogue d'importation qui doit ressembler à la figure 1. Cliquez sur le bouton SÉLECTIONNER et accédez à un fichier GeoTIFF sur votre système de fichiers local.
Attribuez à l'image un ID d'élément approprié (qui n'existe pas déjà) dans votre dossier utilisateur. Si vous souhaitez importer l'image dans un dossier ou une collection existants, ajoutez l'ID du dossier ou de la collection en préfixe de l'ID d'élément, par exemple projects/myproject/folder-or-collection-id/new-asset.
Cliquez sur IMPORTER pour lancer l'importation.
Une fois l'importation lancée, une tâche "Asset ingestion" (Ingestion d'éléments) s'affiche dans l'onglet "Tasks" (Tâches) à droite de l'éditeur de code. Si vous pointez sur la tâche dans le gestionnaire de tâches, un point d'interrogation (?) s'affiche. qui vous permet de vérifier l'état de l'importation. Pour annuler une importation, cliquez sur l'icône de chargement 
à côté de la tâche. Une fois l'ingestion terminée, l'élément apparaît dans votre dossier utilisateur avec une icône .
Compression GeoTIFF
Les fichiers GeoTIFF peuvent être compressés avec DEFLATE, JPEG, JPEG-XL/JXL, LERC, LERC_DEFLATE, LERC_ZSTD, LZMA, LZW, WEBP ou ZSTD. Les fichiers GeoTIFF optimisés pour le cloud (COG) qu'Earth Engine lit sur place plutôt que d'ingérer acceptent un ensemble plus restreint. Consultez Compression COG.
Recommandations pour une expérience d'importation optimale des fichiers volumineux :
- Meilleur choix : ZSTD offre un bon équilibre entre vitesse et compression.
- À éviter : LZMA peut être très lent malgré une bonne compression.
- Fichiers non compressés : les fichiers sont plus volumineux et les temps d'importation plus longs.
- Compression avec perte (par exemple, JPEG) : peut modifier les valeurs des pixels. Utilisez une compression sans perte (par exemple, DEFLATE, LZMA, LZW, ZSTD) plutôt qu'une compression avec perte, à moins que vous ne compreniez l'impact potentiel sur vos données.
TFRecord
Pour importer une image à partir d'un fichier TFRecord, vous devez disposer du fichier de mixage associé qui a été généré lorsque vous avez exporté l'imagerie sur laquelle vous avez effectué l'inférence. Pour en savoir plus sur le fichier de mixage, consultez la page d'exportation. Plus précisément, pour importer des prédictions (sous forme d'image) effectuées sur des images exportées,
- Exportez l'imagerie dans un ou plusieurs fichiers TFRecord.
- Effectuer une inférence sur l'imagerie (c'est-à-dire
model.predict()). - Écrivez le résultat de
model.predict()dans un fichier TFRecord. Les prédictions doivent être dans le même ordre que les exportations d'images sur lesquelles vous avez effectué l'inférence. L'ordre peut être appliqué par un tri des noms de fichiers produits par l'exportation. Pour en savoir plus, consultez la section Exportations de fichiers volumineux. - Importez le ou les fichiers TFRecord et le mélangeur associé dans Earth Engine.
Modification des propriétés
Modifiez les métadonnées d'un asset en spécifiant une ou plusieurs propriétés de métadonnées. Dans le menu Properties (Propriétés), cliquez sur Add property (Ajouter une propriété) pour définir un nom et une valeur de propriété (figure 2). La valeur peut être une chaîne ou un nombre.
Saisissez les chaînes sans guillemets. Pour mettre en forme un nombre sous forme de chaîne, saisissez un guillemet simple (') avant le nombre.
Par défaut, une propriété system:time_start est ajoutée sans valeur. Cette propriété est utilisée par Earth Engine lors de l'application des filtres de date ImageCollection. Saisissez une date au format indiqué dans la figure 2 ou un nombre représentant les millisecondes écoulées depuis le 1er janvier 1970. (Pour en savoir plus sur les codes temporels dans Earth Engine, consultez le glossaire.)
Le gestionnaire d'éléments interprète un nombre saisi comme valeur d'une propriété nommée system:time_start ou system:time_end en millisecondes et le formate en tant que date.
Cliquez sur l'icône pour supprimer une propriété.
Options avancées
Dans le menu Avancé, choisissez la règle de pyramide et le mode de masquage de vos données.
La règle de pyramide spécifie comment Earth Engine génère des versions de l'image en résolution inférieure. Pour en savoir plus sur la gestion des résolutions multiples par Earth Engine, consultez la documentation sur l'échelle. Choisissez une règle de pyramide "Moyenne", "Min" ou "Max" pour calculer les niveaux de résolution inférieurs de la pyramide d'images en tant que moyenne, minimum ou maximum de chaque groupe de pixels 2x2 de résolution supérieure. Cette option convient aux images à valeurs continues. Pour les données catégorielles (par exemple, l'occupation du sol) ou d'assurance qualité, choisissez une règle de pyramide "Échantillon" (pixel supérieur gauche) ou "Mode" (valeur la plus fréquente, ou échantillon s'il n'y a pas de mode).
Le mode de masquage indique comment l'image importée est masquée (le cas échéant). Pour spécifier une valeur sans données, sélectionnez "Valeur sans données" et saisissez la valeur. Les pixels ayant cette valeur seront masqués dans l'image importée. Cette valeur est appliquée à chaque bande de l'image indépendamment. Pour utiliser la dernière bande de votre image comme masque pour les autres bandes d'image, sélectionnez "Utiliser la dernière bande comme bande alpha". La bande alpha doit être une bande 8 bits non signée, où 0 correspond aux données masquées (complètement transparentes) et 255 aux données complètement opaques.
Importations par tuiles
Pour importer une seule image sous forme de plusieurs tuiles, où chaque tuile est stockée dans un fichier source différent, cliquez sur Ajouter un autre fichier pour ajouter des fichiers supplémentaires à l'importation. Earth Engine combinera les tuiles pour créer une seule image dans votre dossier utilisateur.
Il existe quelques contraintes concernant les types de fichiers pouvant être importés dans un composant Image. En particulier :
- Les images doivent avoir le même nombre de bandes, la même profondeur de bits, la même projection, la même résolution et les mêmes valeurs de remplissage.
- Le décalage d'un fichier à l'autre doit être un multiple entier de la taille des pixels.
- Les espaces entre les tuiles seront remplis de pixels masqués dans l'image finale. Les tuiles doivent donc idéalement être adjacentes et non dispersées. Les images dont les espaces vides occupent plus de 99 % de la surface ne seront pas ingérées.