Le bucket GCS gs://alphaearth_foundations_custom contient des exemples d'ensembles de données d'embeddings satellites personnalisés composés de fichiers COG (Cloud Optimized GeoTIFF) générés par AlphaEarth Foundations.
Licence
Cette collection d'ensembles de données est concédée sous licence CC-BY 4.0 et nécessite le texte d'attribution suivant : "Les embeddings satellites personnalisés d'AlphaEarth Foundations sont produits par Google et Google DeepMind." L'utilisation de ces ensembles de données publics est soumise au Règlement sur l'utilisation acceptable de Google Cloud.
Ensembles de données disponibles
Voici la liste des ensembles de données de ce bucket. Il contient le nom, la description et la zone géographique générale d'un ensemble de données. Notez que les intervalles de temps utilisent ici une heure de début inclusive et une heure de fin exclusive.
name: corcoran_city_2026_agricultural_change
area: Corcoran et la région agricole environnante, Californie, États-Unis
description: Embeddings de sol nu en hiver (15 décembre 2025 – 15 février 2026) et de pic de verdure au printemps (15 mars – 15 mai 2026) capturant la dynamique des cultures agricoles sur deux fenêtres saisonnières.name: futaleufu_argentina_2026_fire_scar
area: Parc national Los Alerces et région environnante, département de Futaleufú, province de Chubut, Argentine
description: Embeddings avant l'incendie (du 1er au 31 décembre 2025) et après l'incendie (du 1er au 31 mars 2026) capturant l'étendue de la cicatrice de brûlure de l'incendie de forêt et la perturbation de la canopée forestière causées par l'incendie de forêt de Los Alerces en 2026.name: king_county_2025_monthly
area: King County, Washington, USA
description: Calendar-month embeddings for the King County administrative area for the first six months of 2025, covering diverse urban city infrastructure and forested land.name : meloland_california_2026_crop_cycles
area : Meloland et les champs agricoles environnants, Imperial Valley, Californie, États-Unis
description : Six étapes temporelles d'embedding mensuelles séquentielles (du 15 au 15) (de mi-novembre 2025 à mi-mai 2026) suivant les cycles de rotation de plusieurs cultures.name: pacific_palisades_2025_fire
area: Pacific Palisades et collines côtières environnantes, Los Angeles, Californie, États-Unis
description: Embeddings sur 31 jours avant l'incendie (7 décembre 2024 au 7 janvier 2025) et après l'incendie (7 janvier au 7 février 2025) capturant l'impact de l'incendie de Palisades et l'évolution de l'occupation du sol.name: theewaterskloof_dam_2026_water_change
area: barrage de Theewaterskloof, municipalité locale de Theewaterskloof, Afrique du Sud
description: embeddings de la saison sèche (du 1er au 31 janvier 2026) et de la recharge de la saison humide (du 15 avril au 15 mai 2026) capturant les changements de surface de l'eau du réservoir.
Structure des répertoires
Tous les exemples d'ensembles de données sont organisés sous le préfixe gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/ :
gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/
└── {dataset_name}/
├── aef_index.parquet
├── manifest.txt
└── {start_date}_{end_date}/
└── {image_id}/
├── data.tiff
└── image_manifest.json
Chaque ensemble de données possède son propre répertoire contenant un fichier d'index GeoParquet aef_index.parquet au niveau de l'ensemble de données, un fichier manifest.txt au niveau de l'ensemble de données et un ou plusieurs sous-répertoires d'intervalles de temps.
Ces sous-répertoires d'intervalles de temps sont nommés à l'aide du modèle {start_date}_{end_date}, où la date de début est incluse et la date de fin est exclue. Les deux dates sont au format yyyyMMdd et utilisent le fuseau horaire UTC.
Par exemple, un sous-répertoire pour le mois de juin 2025 serait nommé 20250601_20250701, ce qui correspond à un intervalle de temps allant de 2025-06-01T00:00:00Z (inclus) à 2025-07-01T00:00:00Z (exclus).
Chaque répertoire d'intervalle de temps contient un sous-répertoire pour chaque embedding d'image dans cet intervalle de temps, nommé avec un identifiant d'image ({image_id}) qui identifie de manière unique l'image dans l'ensemble de données. Chaque sous-répertoire {image_id} contient un fichier COG data.tiff des données de pixels et un fichier side-car image_manifest.json utilisé pour enregistrer les données dans Earth Engine.
Structure des fichiers
La structure interne de chaque fichier COG (y compris ses dimensions de 8 192 x 8 192 pixels, ses 64 canaux (A00 à A63), ses pyramides de présentation normalisées, sa quantification d'entiers 8 bits signés et sa valeur de masque -128 NoData) est identique à celle des COG d'embeddings satellites annuels. Contrairement aux COG annuels, les pixels valides de chaque tuile d'échantillon ne couvrent généralement qu'un sous-ensemble de la grille 8192x8192 correspondant à la région d'intérêt, tous les pixels restants étant masqués en tant que -128 (NoData). Pour en savoir plus sur la mise en page des COG, consultez la section Structure des fichiers du guide des données GCS d'AlphaEarth Foundations.
Le chemin d'accès de chaque fichier COG contient également des informations. Prenons l'exemple du fichier situé à l'emplacement gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/pacific_palisades_2025_fire/20250107_20250207/x1evicvaet1mupt13-0000008192-0000000000/data.tiff.
Comme le montre le chemin d'accès, ce fichier fait partie des embeddings de l'incendie de Palisades de 2025 dans le comté de Los Angeles. Ce fichier contient des embeddings qui résument une période allant du 7 janvier 2025 (inclus) au 7 février 2025 (exclus). Le nom du sous-répertoire x1evicvaet1mupt13-0000008192-0000000000 identifie de manière unique le COG data.tiff dans l'ensemble de données pacific_palisades_2025_fire. Cet identifiant est un UUID opaque.
Vous pouvez également extraire ces métadonnées de fichier et d'autres informations du fichier image_manifest.json du COG, disponible à l'adresse gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/pacific_palisades_2025_fire/20250107_20250207/x1evicvaet1mupt13-0000008192-0000000000/image_manifest.json.
Ce fichier est une représentation JSON d'un fichier manifeste d'image Earth Engine. La structure JSON d'un fichier manifeste d'image est définie dans le guide sur les fichiers manifestes d'image. Pour obtenir une description complète du contenu d'un fichier image_manifest.json donné, consultez la section Fichier manifeste d'image.
Déquantification
Les valeurs de pixel brutes de chaque canal sont des entiers signés de 8 bits compris entre -127 et 127 (-128 étant réservé à la valeur "aucune donnée"). Elles doivent être déquantifiées pour produire des valeurs à virgule flottante prêtes pour l'analyse comprises entre -1 et 1. Pour en savoir plus sur le mappage de déquantification et la création de pyramides sous-échantillonnées, consultez les sections Déquantification et Créer des pyramides sous-échantillonnées du guide des données GCS AlphaEarth Foundations.
Fichiers manifestes et index
Pour faciliter la découverte, l'itération et l'enregistrement des tuiles d'embedding, chaque ensemble de données fournit deux types de fichiers manifestes : une liste de fichiers COG au niveau de l'ensemble de données (manifest.txt) et un fichier manifeste de métadonnées par image (image_manifest.json), ainsi qu'un index spatial GeoParquet au niveau de l'ensemble de données (aef_index.parquet).
Fichier manifeste de l'ensemble de données
Chaque ensemble de données inclut un fichier manifest.txt situé à la racine de son répertoire :
gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/{dataset_name}/manifest.txt
Il s'agit d'un fichier en texte brut contenant l'URI Google Cloud Storage complet de chaque fichier data.tiff de l'ensemble de données, séparé par des sauts de ligne.
Fichier manifeste d'image
Chaque fichier data.tiff est accompagné d'un fichier side-car image_manifest.json :
gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/{dataset_name}/{start_date}_{end_date}/{image_id}/image_manifest.json
Ce fichier JSON suit la spécification du fichier manifeste d'image Earth Engine et décrit les fichiers sources, la structure des bandes, les limites temporelles et la couverture spatiale de la tuile.
Bien que les champs de fichier manifeste standards (tels que tilesets et bands) suivent les conventions standards d'Earth Engine, plusieurs détails importants sont à noter :
name: laissé vide ("") dans GCS. Lorsque vous utilisez ce fichier manifeste pour enregistrer une image dans une collection d'éléments Earth Engine, le client doit fournir l'ID d'élément cible (par exemple,projects/{project}/assets/{collection}/{image_id}). Pour en savoir plus, consultez Charger un ensemble de données dans Earth Engine.start_timeetend_time: spécifiez les codes temporels de début (inclusif) et de fin (exclusif) de la période composite au format UTC ISO 8601 (par exemple,2026-03-15T00:00:00+00:00).footprint: polygone fermé en coordonnées de pixel délimitant une région contenant des pixels valides. Notez que des pixels manquants peuvent toujours exister dans le polygone, comme c'est le cas pour les géométries d'embedding complexes telles que celle deking_county_2025_monthly.properties: métadonnées clé-valeur spécifiques à l'embedding, y compris :IMAGE_ID: identifiant unique de l'image dans l'ensemble de données.DATASET: nom de l'ensemble de données.DATASET_VERSION: version de l'ensemble de données.START_DATEetEND_DATE: dates de début (inclusif) et de fin (exclusif) de l'intervalle de temps couvert par l'image, au formatYYYY-MM-DD.MODEL_VERSION: chaîne de version identifiant de manière unique la version du modèle utilisée pour produire l'image.PROCESSING_SOFTWARE_VERSION: chaîne de version identifiant de manière unique le logiciel de traitement des données du modèle utilisé pour produire l'image.UTM_ZONE: zone UTM du système de référence de coordonnées utilisé pour produire l'image.
Index GeoParquet
Chaque ensemble de données inclut un fichier d'index spatial GeoParquet situé à la racine de son répertoire :
gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/{dataset_name}/aef_index.parquet
Cet index contient une entrée pour chaque fichier data.tiff de l'ensemble de données et fournit des métadonnées spatiales et temporelles pour aider à déterminer quels fichiers couvrent une zone et une période données :
geometry: géométrie du fichier sous forme de polygone WGS84 (EPSG:4326). Pour savoir comment ce polygone est calculé à partir du cadre de délimitation UTM du tableau de pixels et découpé selon les limites de la zone UTM, consultez la section Traitement de la géométrie du guide des données GCS AlphaEarth Foundations. Notez que ce polygone reflète les limites de l'ensemble du tableau de pixels 8192 x 8192 et ne tient pas compte de la validité des pixels individuels.crs: CRS de la zone UTM à laquelle l'image appartient, sous forme de code EPSG, par exempleEPSG:32610.path: URI Google Cloud Storage (gs://...) du fichier COGdata.tiff.dataset: nom de l'ensemble de données.start_dateetend_date: dates de début (inclusif) et de fin (exclusif) de l'intervalle de temps couvert par l'image, au formatYYYY-MM-DD.image_id: identifiant unique de l'image dans l'ensemble de données.utm_zone: zone UTM de l'image, par exemple10N.utm_west,utm_south,utm_east,utm_north: limites UTM du tableau de pixels bruts. Cela ne reflète aucun traitement géométrique et inclut tous les pixels, qu'ils soient valides ou non.wgs84_west,wgs84_south,wgs84_east,wgs84_north: longitude et latitude minimales et maximales dugeometryWGS84.
Charger un ensemble de données dans Earth Engine
REMARQUE : Pour plus de commodité, tous les exemples d'ensembles de données pour les embeddings satellites personnalisés seront ajoutés à Google Earth Engine en tant qu'ImageCollections publiques à l'aide de la méthode décrite dans le guide du notebook associé, et seront déjà déquantifiés. Le guide associé peut être utilisé par les utilisateurs qui enregistrent des ensembles de données d'intégration de satellites personnalisés nouvellement fournis en tant qu'ImageCollections Google Earth Engine.
Les COG peuvent être chargés dans Earth Engine en les enregistrant en tant qu'éléments basés sur des COG ou en les chargeant directement. Pour obtenir un guide complet sur les deux méthodes, consultez le notebook Accès aux données d'embeddings satellites personnalisés sur GitHub. Pour obtenir une présentation générale et une comparaison de ces deux méthodes, consultez GeoTIFF optimisés pour le cloud (COG) dans Earth Engine.