自訂衛星嵌入的公開資料樣本

gs://alphaearth_foundations_custom GCS bucket 包含自訂衛星嵌入的範例資料集,由 AlphaEarth Foundations 生成的 COG (Cloud Optimized GeoTIFF) 檔案組成。

授權

這組資料集依據 CC-BY 4.0 授權,且須附上以下作者資訊文字:「AlphaEarth Foundations 的自訂衛星嵌入由 Google 和 Google DeepMind 製作。」使用這些公開資料集時,須遵守《Google Cloud 使用限制政策》。

可用的資料集

以下是這個 bucket 中的資料集清單。其中包含資料集的名稱、說明,以及資料集涵蓋的大概區域。請注意,這裡的時間間隔採用包含開始時間和不包含結束時間。

  • name: corcoran_city_2026_agricultural_change
    area: Corcoran and surrounding agricultural region, California, USA
    description: Winter bare soil (Dec 15, 2025 - Feb 15, 2026) and spring peak greenness (Mar 15 - May 15, 2026) embeddings capturing agricultural crop dynamics over two seasonal windows.

  • name:futaleufu_argentina_2026_fire_scar
    area:阿根廷丘布特省富塔萊烏富縣洛斯阿萊塞斯國家公園及周邊地區
    description:火災前 (2025 年 12 月 1 日至 31 日) 和火災後 (2026 年 3 月 1 日至 31 日) 的嵌入,擷取 2026 年洛斯阿萊塞斯野火造成的野火燒焦範圍和森林樹冠干擾。

  • name:king_county_2025_monthly
    area:King County, Washington, USA
    description:2025 年前六個月金郡行政區的日曆月嵌入,涵蓋多樣化的城市基礎設施和林地。

  • name: meloland_california_2026_crop_cycles
    area: Meloland and surrounding agricultural fields, Imperial Valley, California, USA
    description: Six sequential monthly (15th to 15th) embedding time steps (mid-November 2025 through mid-May 2026) tracking multi-crop rotation cycles.

  • name: pacific_palisades_2025_fire
    area: Pacific Palisades and surrounding coastal hills, Los Angeles, California, USA
    description: Pre-fire (Dec 7, 2024 - Jan 7, 2025) and post-fire (Jan 7 - Feb 7, 2025) 31-day embeddings capturing Palisades Fire wildfire impact and 土地覆蓋 change.

  • 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.

目錄結構

所有範例資料集都會整理在 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

每個資料集都有自己的目錄,其中包含資料集層級的 aef_index.parquet GeoParquet 索引檔案、資料集層級的 manifest.txt 檔案,以及一或多個時間間隔子目錄。

這些時間間隔子目錄的命名模式為 {start_date}_{end_date},其中開始日期為包含,結束日期為不包含。這兩個日期的格式均為 yyyyMMdd,且時區為世界標準時間。舉例來說,2025 年 6 月的子目錄會命名為 20250601_20250701,對應的時間間隔為 2025-06-01T00:00:00Z (含) 到 2025-07-01T00:00:00Z (不含)。

每個時間間隔目錄都包含一個子目錄,用於存放該時間間隔內的每個圖像嵌入,並以圖像 ID ({image_id}) 命名,用於在資料集中唯一識別圖像。每個 {image_id} 子目錄都包含一個像素資料的 data.tiff COG 檔案,以及一個用於在 Earth Engine 中註冊資料的附屬 image_manifest.json 檔案。

檔案結構

每個 COG 檔案的內部結構 (包括 8192x8192 像素尺寸、64 個通道 (A00 到 A63)、正規化總覽金字塔、有正負號的 8 位元整數量化,以及 -128 NoData 遮罩值) 都與年度衛星嵌入 COG 相同。與年度 COG 不同,每個樣本圖塊中的有效像素通常只涵蓋與感興趣區域對應的 8192x8192 網格的一部分,其餘像素則遮罩為 -128 (NoData)。如要進一步瞭解 COG 版面配置,請參閱 AlphaEarth Foundations GCS 資料指南的「檔案結構」一節。

每個 COG 檔案的路徑也包含一些資訊。舉例來說,假設檔案位於 gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/pacific_palisades_2025_fire/20250107_20250207/x1evicvaet1mupt13-0000008192-0000000000/data.tiff。從路徑可以看出,這個檔案是 2025 年洛杉磯郡 Palisades 火災嵌入的一部分。這個檔案包含 2025 年 1 月 7 日 (含) 至 2025 年 2 月 7 日 (不含) 這段時間範圍的摘要嵌入。x1evicvaet1mupt13-0000008192-0000000000 子目錄名稱可唯一識別 pacific_palisades_2025_fire 資料集中的 data.tiff COG。這個 ID 是不透明的 UUID。

或者,您也可以從 gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/pacific_palisades_2025_fire/20250107_20250207/x1evicvaet1mupt13-0000008192-0000000000/image_manifest.json 的 COG image_manifest.json 檔案中,擷取這個檔案中繼資料和其他資料。這個檔案是 Earth Engine 圖片資訊清單的 JSON 表示法。映像檔資訊清單的 JSON 結構定義請參閱映像檔資訊清單指南。如需指定 image_manifest.json 檔案內容的完整說明,請參閱「映像檔資訊清單」一節。

反量化

每個通道中的原始像素值都是帶正負號的 8 位元整數,範圍為 [-127, 127] (-128 保留為「無資料」值),且必須經過反量化,才能產生範圍為 [-1, 1] 的浮點值,供分析使用。如要瞭解去量化對應和建立降取樣金字塔的操作說明,請參閱 AlphaEarth Foundations GCS 資料指南的「去量化」和「建立降取樣金字塔」部分。

資訊清單和索引

為方便探索、疊代及註冊嵌入圖塊,每個資料集都提供兩種資訊清單:資料集層級的 COG 檔案清單 (manifest.txt) 和每張圖片的中繼資料資訊清單 (image_manifest.json),以及資料集層級的 GeoParquet 空間索引 (aef_index.parquet)。

資料集資訊清單

每個資料集都包含一個 manifest.txt 檔案,位於目錄的根目錄: gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/{dataset_name}/manifest.txt

這個純文字檔案包含資料集中每個 data.tiff 檔案的完整 Google Cloud Storage URI,並以換行符號分隔。

映像檔資訊清單

每個 data.tiff 檔案旁都有一個附屬 image_manifest.json 檔案: gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/{dataset_name}/{start_date}_{end_date}/{image_id}/image_manifest.json

這個 JSON 檔案遵循 Earth Engine 圖片資訊清單規格,並說明圖塊的來源檔案、波段結構、時間範圍和空間涵蓋範圍。

雖然標準資訊清單欄位 (例如 tilesets 和 bands) 遵循標準 Earth Engine 慣例,但仍有幾項重要細節需要注意:

  • name:在 GCS 中留空 ("")。使用這個資訊清單在 Earth Engine 資產集合中註冊圖片時,用戶端必須提供目標資產 ID (例如 projects/{project}/assets/{collection}/{image_id})。詳情請參閱「將資料集載入 Earth Engine」。
  • start_time 和 end_time:指定複合時間範圍的開始 (含) 和結束 (不含) 時間戳記,採用世界標準時間 (UTC) 格式,並符合 ISO 8601 標準 (例如 2026-03-15T00:00:00+00:00)。
  • footprint:像素座標中的封閉多邊形,用於勾勒出包含有效像素的區域。請注意,多邊形內仍可能缺少像素,例如 king_county_2025_monthly 等複雜的嵌入幾何圖形。
  • properties:嵌入專屬的鍵/值中繼資料,包括:
    • IMAGE_ID:資料集內圖片的專屬 ID。
    • DATASET:資料集名稱。
    • DATASET_VERSION:資料集版本。
    • START_DATE 和 END_DATE:圖片涵蓋時間間隔的開始日期 (含) 和結束日期 (不含),格式為 YYYY-MM-DD。
    • MODEL_VERSION:版本字串,可明確識別用於生成圖片的模型版本。
    • PROCESSING_SOFTWARE_VERSION:版本字串,用於識別產生圖片的模型資料處理軟體。
    • UTM_ZONE:用於產生圖片的座標參考系統 UTM 區域。

GeoParquet 索引

每個資料集都包含一個 GeoParquet 空間索引檔案,位於目錄的根目錄: gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/{dataset_name}/aef_index.parquet

這個索引包含資料集中每個 data.tiff 檔案的項目,並提供空間和時間中繼資料,協助判斷哪些檔案涵蓋特定區域和時間範圍:

  • geometry:檔案的幾何圖形,以 WGS84 (EPSG:4326) 多邊形表示。如要瞭解如何從像素陣列的 UTM 定界框計算這個多邊形,並裁剪至 UTM 區域邊界,請參閱 AlphaEarth Foundations GCS 資料指南的「幾何圖形處理」一節。請注意,這個多邊形反映的是完整 8192x8192 像素陣列的邊界,不代表個別像素的有效性。
  • crs:圖片所屬 UTM 區域的 CRS,以 EPSG 代碼表示,例如 EPSG:32610。
  • path:data.tiff COG 檔案的 Google Cloud Storage URI (gs://...)。
  • dataset:資料集名稱。
  • start_date 和 end_date:圖片涵蓋時間間隔的開始日期 (含) 和結束日期 (不含),格式為 YYYY-MM-DD。
  • image_id:資料集內圖片的專屬 ID。
  • utm_zone:圖片的 UTM 區域,例如 10N。
  • utm_west、utm_south、utm_east、utm_north:原始像素陣列的 UTM 邊界。這不反映任何幾何處理,且包含所有像素,無論是否有效。
  • wgs84_west、wgs84_south、wgs84_east、wgs84_north:WGS84 geometry 的經緯度最小值和最大值。

將資料集載入 Earth Engine

注意:為方便起見,自訂衛星嵌入的所有範例資料集,都會按照連結筆記本指南所述的方法,以公開 ImageCollections 的形式新增至 Google Earth Engine,且已完成去量化。使用者可以參考連結指南,將新提供的自訂衛星嵌入資料集,註冊為 Google Earth Engine ImageCollection。

您可以將 COG 註冊為 COG 支援的資產,或直接載入,將其載入 Earth Engine。如需這兩種方法的完整指南,請參閱 GitHub 上的自訂衛星嵌入資料存取筆記本。如需這兩種方法的一般總覽和比較,請參閱「Earth Engine 中的雲端最佳化 GeoTIFF (COG)」。