Der GCS-Bucket gs://alphaearth_foundations_custom enthält Beispiel-Datasets mit benutzerdefinierten Satelliteneinbettungen, die aus COG-Dateien (Cloud Optimized GeoTIFF) bestehen, die von AlphaEarth Foundations generiert wurden.
Lizenz
Diese Sammlung von Datasets ist unter CC-BY 4.0 lizenziert und erfordert den folgenden Quellenangabetext: „Benutzerdefinierte Satelliteneinbettungen von AlphaEarth Foundations werden von Google und Google DeepMind erstellt.“ Die Verwendung dieser öffentlichen Datasets unterliegt den Richtlinien zur zulässigen Verwendung von Google Cloud.
Verfügbare Datasets
Im Folgenden finden Sie eine Liste der Datasets in diesem Bucket. Sie enthält den Namen, die Beschreibung und den ungefähren Ort des Datasets. Beachten Sie, dass Zeitintervalle hier eine inklusive Startzeit und eine exklusive Endzeit haben.
name: corcoran_city_2026_agricultural_change
area: Corcoran und die umliegende landwirtschaftliche Region, Kalifornien, USA
description: Einbettungen für Winter-Brachland (15. Dezember 2025 bis 15. Februar 2026) und Frühjahrs-Spitzenbegrünung (15. März bis 15. Mai 2026), die die Dynamik der landwirtschaftlichen Kulturen über zwei saisonale Zeitfenster erfassen.Name: futaleufu_argentina_2026_fire_scar
Gebiet: Nationalpark Los Alerces und Umgebung, Departamento Futaleufú, Provinz Chubut, Argentinien
Beschreibung: Einbettungen vor dem Brand (1.–31. Dezember 2025) und nach dem Brand (1.–31. März 2026), die das Ausmaß der Brandnarbe und die Störung des Kronendachs durch den Waldbrand im Nationalpark Los Alerces im Jahr 2026 erfassen.name: king_county_2025_monthly
area: King County, Washington, USA
description: Kalendermonats-Einbettungen für das Verwaltungsgebiet King County für die ersten sechs Monate des Jahres 2025, die eine vielfältige städtische Infrastruktur und Waldgebiete abdecken.name: meloland_california_2026_crop_cycles
area: Meloland und umliegende landwirtschaftliche Felder, Imperial Valley, Kalifornien, USA
description: Sechs aufeinanderfolgende monatliche (15. bis 15.) Einbettungszeitschritte (Mitte November 2025 bis Mitte Mai 2026) zur Verfolgung von Fruchtfolgezyklen.name: pacific_palisades_2025_fire
area: Pacific Palisades und umliegende Küstenhügel, Los Angeles, Kalifornien, USA
description: 31-tägige Einbettungen vor dem Brand (7. Dezember 2024 bis 7. Januar 2025) und nach dem Brand (7. Januar bis 7. Februar 2025), die die Auswirkungen des Palisades-Feuers und die Veränderung der Landbedeckung erfassen.name: theewaterskloof_dam_2026_water_change
area: Theewaterskloof Dam, Theewaterskloof Local Municipality, South Africa
description: Dry-season (Jan 1-31, 2026) and wet-season recharge (Apr 15 - May 15, 2026) embeddings capturing reservoir water surface area changes.
Verzeichnisstruktur
Alle Beispiel-Datasets sind unter dem Präfix gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/ organisiert:
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
Jedes Dataset hat ein eigenes Verzeichnis mit einer GeoParquet-Indexdatei aef_index.parquet auf Dataset-Ebene, einer manifest.txt-Datei auf Dataset-Ebene und einem oder mehreren Unterverzeichnissen für Zeitintervalle.
Diese Zeitintervall-Unterverzeichnisse werden nach dem Muster {start_date}_{end_date} benannt, wobei das Startdatum eingeschlossen und das Enddatum ausgeschlossen ist. Beide Datumsangaben sind als yyyyMMdd formatiert und befinden sich in der UTC-Zeitzone.
Ein Unterverzeichnis für den Monat Juni 2025 würde beispielsweise 20250601_20250701 heißen, was einem Zeitintervall von 2025-06-01T00:00:00Z (einschließlich) bis 2025-07-01T00:00:00Z (ausschließlich) entspricht.
Jedes Zeitintervallverzeichnis enthält ein Unterverzeichnis für jede Bildeinbettung innerhalb dieses Zeitintervalls, das mit einer Bild-ID ({image_id}) benannt ist, die das Bild innerhalb des Datasets eindeutig identifiziert. Jedes {image_id}-Unterverzeichnis enthält eine data.tiff-COG-Datei mit den Pixeldaten und eine Sidecar-image_manifest.json-Datei, die zum Registrieren der Daten in Earth Engine verwendet wird.
Dateistruktur
Die interne Struktur jeder COG-Datei – einschließlich der Abmessungen von 8192 × 8192 Pixeln, der 64 Kanäle (A00 bis A63), der normalisierten Übersichtspyramiden, der Quantisierung mit vorzeichenbehafteten 8‑Bit-Ganzzahlen und des Maskenwerts -128 NoData – ist identisch mit den jährlichen COGs für Satelliteneinbettungen. Im Gegensatz zu den jährlichen COGs decken gültige Pixel in jeder Beispielkachel in der Regel nur einen Teil des 8192x8192-Rasters ab, der dem Bereich von Interesse entspricht. Alle verbleibenden Pixel werden als -128 (NoData) maskiert. Ausführliche Informationen zum COG-Layout finden Sie im Abschnitt Dateistruktur des GCS-Datenleitfadens für AlphaEarth Foundations.
Der Pfad jeder COG-Datei enthält ebenfalls Informationen. Betrachten Sie beispielsweise die Datei unter gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/pacific_palisades_2025_fire/20250107_20250207/x1evicvaet1mupt13-0000008192-0000000000/data.tiff.
Wie aus dem Pfad hervorgeht, ist diese Datei Teil der Einbettungen für das Palisades-Feuer im Jahr 2025 im Los Angeles County. Diese Datei enthält Einbettungen, die einen Zeitraum vom 7. Januar 2025 (einschließlich) bis zum 7. Februar 2025 (ausschließlich) zusammenfassen. Der Name des Unterverzeichnisses x1evicvaet1mupt13-0000008192-0000000000 identifiziert das COG data.tiff im Dataset pacific_palisades_2025_fire eindeutig. Diese Kennung ist eine intransparente UUID.
Alternativ können diese Dateimetadaten und weitere Informationen aus der image_manifest.json-Datei des COG extrahiert werden, die unter gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/pacific_palisades_2025_fire/20250107_20250207/x1evicvaet1mupt13-0000008192-0000000000/image_manifest.json zu finden ist.
Diese Datei ist eine JSON-Darstellung eines Earth Engine-Bildmanifests. Die JSON-Struktur eines Image-Manifests wird im Leitfaden für Image-Manifeste definiert. Eine vollständige Beschreibung des Inhalts einer bestimmten image_manifest.json-Datei finden Sie im Abschnitt Image-Manifest.
Dequantisierung
Die Rohpixelwerte in jedem Kanal sind vorzeichenbehaftete 8-Bit-Ganzzahlen im Bereich [-127, 127] (wobei -128 als Wert für „keine Daten“ reserviert ist) und müssen dequantisiert werden, um analysebereite Gleitkommawerte im Bereich [-1, 1] zu erzeugen. Informationen zur Dequantisierungszuordnung und zum Erstellen von Pyramiden mit reduzierter Abtastung finden Sie in den Abschnitten Dequantisierung und Pyramiden mit reduzierter Abtastung erstellen des GCS-Datenleitfadens für AlphaEarth Foundations.
Manifeste und Indexe
Um das Entdecken, Iterieren und Registrieren von Einbettungskacheln zu erleichtern, bietet jedes Dataset zwei Arten von Manifesten: eine Liste von COG-Dateien auf Dataset-Ebene (manifest.txt) und ein Metadatenmanifest pro Bild (image_manifest.json) sowie einen GeoParquet-räumlichen Index auf Dataset-Ebene (aef_index.parquet).
Dataset-Manifest
Jedes Dataset enthält eine manifest.txt-Datei im Stammverzeichnis:
gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/{dataset_name}/manifest.txt
Dies ist eine Nur-Text-Datei, die den vollständigen Google Cloud Storage-URI für jede data.tiff-Datei im Dataset enthält, getrennt durch Zeilenumbrüche.
Image-Manifest
Neben jeder data.tiff-Datei befindet sich eine Sidecar-image_manifest.json-Datei:
gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/{dataset_name}/{start_date}_{end_date}/{image_id}/image_manifest.json
Diese JSON-Datei entspricht der Spezifikation für Earth Engine-Bildmanifeste und beschreibt die Quelldateien, die Bandstruktur, die zeitlichen Grenzen und die räumliche Abdeckung der Kachel.
Standardmäßige Manifestfelder wie tilesets und bands entsprechen den Standardkonventionen von Earth Engine. Es gibt jedoch einige wichtige Details, die Sie beachten sollten:
name: In GCS leer gelassen (""). Wenn Sie dieses Manifest verwenden, um ein Bild in einer Earth Engine-Asset-Sammlung zu registrieren, muss der Client die Ziel-Asset-ID (z.B.projects/{project}/assets/{collection}/{image_id}) angeben. Weitere Informationen finden Sie unter Dataset in Earth Engine laden.start_timeundend_time: Geben Sie die Start- (einschließlich) und Endzeitstempel (ausschließlich) für den zusammengesetzten Zeitraum in UTC im ISO 8601-Format an (z.B.2026-03-15T00:00:00+00:00).footprint: Ein geschlossenes Polygon in Pixelkoordinaten, das einen Bereich mit gültigen Pixeln umreißt. Beachten Sie, dass innerhalb des Polygons weiterhin fehlende Pixel vorhanden sein können. Dies ist bei komplexen Einbettungsgeometrien wieking_county_2025_monthlyder Fall.properties: Schlüssel/Wert-Metadaten, die für die Einbettung spezifisch sind, einschließlich:IMAGE_ID: Die eindeutige Kennung des Bildes im Dataset.DATASET: Der Name des Datasets.DATASET_VERSION: Die Dataset-Version.START_DATEundEND_DATE: Das Startdatum (einschließlich) und das Enddatum (ausschließlich) des Zeitraums, der vom Bild abgedeckt wird, formatiert alsYYYY-MM-DD.MODEL_VERSION: Der Versionsstring, der die Modellversion eindeutig identifiziert, die zum Erstellen des Bildes verwendet wurde.PROCESSING_SOFTWARE_VERSION: Der Versionsstring, der die Software zur Verarbeitung der Modelldaten eindeutig identifiziert, die zum Erstellen des Bildes verwendet wurde.UTM_ZONE: Die UTM-Zone des Koordinatenreferenzsystems, das zur Erstellung des Bildes verwendet wurde.
GeoParquet-Index
Jedes Dataset enthält eine GeoParquet-Datei mit einem räumlichen Index, die sich im Stammverzeichnis des Datasets befindet:
gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/{dataset_name}/aef_index.parquet
Dieser Index enthält einen Eintrag für jede data.tiff-Datei im Dataset und bietet räumliche und zeitliche Metadaten, mit denen sich bestimmen lässt, welche Dateien einen bestimmten Bereich und Zeitraum abdecken:
geometry: Die Geometrie der Datei als WGS84-Polygon (EPSG:4326). Weitere Informationen dazu, wie dieses Polygon aus dem UTM-Begrenzungsrahmen des Pixelarrays berechnet und auf die Grenzen der UTM-Zone zugeschnitten wird, finden Sie im Abschnitt Geometrieverarbeitung des GCS-Datenleitfadens für AlphaEarth Foundations. Dieses Polygon spiegelt die Grenzen des gesamten 8192 × 8192-Pixel-Arrays wider und berücksichtigt nicht die Gültigkeit einzelner Pixel.crs: Das CRS der UTM-Zone, zu der das Bild gehört, als EPSG-Code, z. B.EPSG:32610.path: Der Google Cloud Storage-URI (gs://...) derdata.tiff-COG-Datei.dataset: Der Name des Datasets.start_dateundend_date: Das Startdatum (einschließlich) und das Enddatum (ausschließlich) des Zeitraums, der vom Bild abgedeckt wird, formatiert alsYYYY-MM-DD.image_id: Die eindeutige Kennung des Bildes im Dataset.utm_zone: Die UTM-Zone des Bildes, z. B.10N.utm_west,utm_south,utm_east,utm_north: Die UTM-Grenzen des Rohpixel-Arrays. Dies spiegelt keine Geometrieverarbeitung wider und umfasst alle Pixel, unabhängig davon, ob sie gültig sind oder nicht.wgs84_west,wgs84_south,wgs84_east,wgs84_north: Der minimale und maximale Längen- und Breitengrad des WGS84-geometry.
Dataset in Earth Engine laden
HINWEIS: Alle Beispiel-Datasets für benutzerdefinierte Satelliteneinbettungen werden der Google Earth Engine als öffentliche ImageCollections hinzugefügt. Dazu wird die im verlinkten Notebook-Leitfaden beschriebene Methode verwendet. Die Daten werden bereits dequantisiert sein. Der verlinkte Leitfaden kann von Nutzern verwendet werden, die neu bereitgestellte Datasets für benutzerdefinierte Satelliteneinbettungen als Google Earth Engine-ImageCollections registrieren.
COGs können in die Earth Engine geladen werden, indem sie entweder als COG-gestützte Assets registriert oder direkt geladen werden. Eine vollständige Anleitung für beide Methoden finden Sie im Notebook Custom Satellite Embeddings Data Access auf GitHub. Eine allgemeine Übersicht und einen Vergleich der beiden Methoden finden Sie unter Cloud Optimized GeoTIFFs (COGs) in Earth Engine.