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.tiffCOG 檔案的 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:WGS84geometry的經緯度最小值和最大值。
將資料集載入 Earth Engine
注意:為方便起見,自訂衛星嵌入的所有範例資料集,都會按照連結筆記本指南所述的方法,以公開 ImageCollections 的形式新增至 Google Earth Engine,且已完成去量化。使用者可以參考連結指南,將新提供的自訂衛星嵌入資料集,註冊為 Google Earth Engine ImageCollection。
您可以將 COG 註冊為 COG 支援的資產,或直接載入,將其載入 Earth Engine。如需這兩種方法的完整指南,請參閱 GitHub 上的自訂衛星嵌入資料存取筆記本。如需這兩種方法的一般總覽和比較,請參閱「Earth Engine 中的雲端最佳化 GeoTIFF (COG)」。