Custom Satellite Embeddings の公開データサンプル

gs://alphaearth_foundations_custom GCS バケットには、AlphaEarth Foundations によって生成された COG(Cloud Optimized GeoTIFF)ファイルで構成されるカスタム衛星エンベディングのサンプル データセットが含まれています。

ライセンス

このデータセット コレクションは CC-BY 4.0 に基づいてライセンスされており、次の帰属表示テキストが必要です。「AlphaEarth Foundations のカスタム衛星エンベディングは、Google と Google DeepMind によって作成されています。」これらの一般公開データセットの使用には、Google Cloud 利用規定が適用されます。

利用可能なデータセット

このバケット内のデータセットのリストは次のとおりです。これには、データセットの名前、説明、データセットに含まれる一般的な領域が含まれます。ここでの時間間隔では、開始時刻は含まれ、終了時刻は含まれません。

  • name: corcoran_city_2026_agricultural_change
    area: 米国カリフォルニア州コーコランとその周辺の農業地域
    description: 冬の裸地(2025 年 12 月 15 日~ 2026 年 2 月 15 日)と春のピーク時の緑度(2026 年 3 月 15 日~ 5 月 15 日)のエンベディング。2 つの季節的な期間にわたる農作物の動態を捉えています。

  • name: futaleufu_argentina_2026_fire_scar
    area: アルゼンチン、チュブ州、フタレウフ県、ロス アレルセス国立公園とその周辺地域
    description: 2026 年のロス アレルセス森林火災による森林火災の焼失範囲と森林キャノピーの乱れを捉えた、火災前(2025 年 12 月 1 日~ 31 日)と火災後(2026 年 3 月 1 日~ 31 日)のエンベディング。

  • name: king_county_2025_monthly
    area: King County, Washington, USA
    description: 2025 年上半期のキング郡行政区域のカレンダー月エンベディング。多様な都市インフラと森林地帯をカバーしています。

  • name: meloland_california_2026_crop_cycles
    area: メロランドとその周辺の農地、インペリアル バレー、カリフォルニア、米国
    description: 複数の作物の輪作サイクルを追跡する、6 つの連続した月次(15 日から 15 日)の埋め込みタイムステップ(2025 年 11 月中旬から 2026 年 5 月中旬)。

  • name: pacific_palisades_2025_fire
    area: パシフィック パリセーズとその周辺の沿岸丘陵地帯、ロサンゼルス、カリフォルニア、米国
    description: 火災前(2024 年 12 月 7 日~ 2025 年 1 月 7 日)と火災後(2025 年 1 月 7 日~ 2 月 7 日)の 31 日間のエンベディング。パリセーズ火災の影響と土地被覆の変化を捉えています。

  • name: theewaterskloof_dam_2026_water_change
    area: Theewaterskloof Dam, Theewaterskloof Local Municipality, South Africa
    description: 乾季(2026 年 1 月 1 日~ 31 日)と雨季の再充電(2026 年 4 月 15 日~ 5 月 15 日)のエンベディング。貯水池の水面面積の変化をキャプチャします。

ディレクトリ構造

すべてのサンプル データセットは、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 ファイル、1 つ以上の時間間隔サブディレクトリを含む独自のディレクトリがあります。

これらの時間間隔サブディレクトリの名前は、{start_date}_{end_date} のパターンを使用して付けられます。ここで、開始日は含まれ、終了日は含まれません。どちらの日付も yyyyMMdd 形式で、UTC タイムゾーンです。たとえば、2025 年 6 月のサブディレクトリの名前は 20250601_20250701 になります。これは、2025-06-01T00:00:00Z(含む)から 2025-07-01T00:00:00Z(含まない)までの期間に対応します。

各時間間隔ディレクトリには、その時間間隔内の各画像エンベディングのサブディレクトリが含まれています。このサブディレクトリには、データセット内の画像を一意に識別する画像識別子({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 年のパリセーズ火災のエンベディングの一部です。このファイルには、2025 年 1 月 7 日(含む)から 2025 年 2 月 7 日(含まない)までの期間を要約したエンベディングが含まれています。x1evicvaet1mupt13-0000008192-0000000000 サブディレクトリ名は、pacific_palisades_2025_fire データセット内の data.tiff COG を一意に識別します。この識別子は不透明な 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 ファイルの内容の詳細については、イメージ マニフェスト セクションをご覧ください。

逆量子化

各チャネルの未加工のピクセル値は、[-127, 127] の範囲の符号付き 8 ビット整数です(-128 は「データなし」の値として予約されています)。分析可能な [-1, 1] の範囲の浮動小数点値を生成するには、逆量子化する必要があります。逆量子化マッピングとダウンサンプリングされたピラミッドの作成手順については、AlphaEarth Foundations GCS データガイドの逆量子化とダウンサンプリングされたピラミッドを作成するのセクションをご覧ください。

マニフェストとインデックス

エンベディング タイルの検出、反復処理、登録を容易にするため、各データセットには、データセット レベルの COG ファイルのリスト(manifest.txt)と画像ごとのメタデータ マニフェスト(image_manifest.json)の 2 種類のマニフェストと、データセット レベルの 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 Image Manifest 仕様に準拠しており、タイルのソースファイル、バンド構造、時間境界、空間カバレッジを記述します。

標準のマニフェスト フィールド(tilesets や bands など)は標準の Earth Engine 規則に従いますが、次の重要な点に注意してください。

  • name: GCS では空("")のままにします。このマニフェストを使用して Earth Engine アセット コレクションに画像を登録する場合、クライアントはターゲット アセット ID(projects/{project}/assets/{collection}/{image_id} など)を指定する必要があります。詳細については、Earth Engine にデータセットを読み込むをご覧ください。
  • start_time と end_time: 複合期間の開始(包括的)と終了(排他的)のタイムスタンプを、ISO 8601 形式の UTC(例: 2026-03-15T00:00:00+00:00)で指定します。
  • footprint: 有効なピクセルを含む領域を囲むピクセル座標の閉じたポリゴン。ポリゴン内に欠落したピクセルが存在する可能性があります。これは、king_county_2025_monthly のような複雑な埋め込みジオメトリの場合です。
  • properties: エンベディングに固有の Key-Value メタデータ。以下が含まれます。
    • IMAGE_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 ファイルごとに 1 つのエントリが含まれており、特定のエリアと期間をカバーするファイルを特定するのに役立つ空間メタデータと時間メタデータが提供されます。

  • 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: データセット内の画像の固有識別子。
  • 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 に読み込む

注: 便宜上、カスタム衛星エンベディングのすべてのサンプル データセットは、リンクされたノートブック ガイドに記載されている方法を使用して、公開 ImageCollection として Google Earth Engine に追加され、すでに量子化解除されています。リンク先のガイドは、新しく配信されたカスタム衛星埋め込みデータセットを Google Earth Engine ImageCollections として登録するユーザーが使用できます。

COG を Earth Engine に読み込むには、COG をサポートするアセットとして登録するか、直接読み込みます。両方の方法の詳細については、GitHub の Custom Satellite Embeddings Data Access ノートブックをご覧ください。これらの方法の概要と比較については、Earth Engine の Cloud Optimized GeoTIFF(COG)をご覧ください。