ที่เก็บข้อมูล GCS gs://alphaearth_foundations_custom มีชุดข้อมูลตัวอย่างของการฝังดาวเทียมที่กำหนดเองซึ่งประกอบด้วยไฟล์ COG (Cloud Optimized GeoTIFF) ที่สร้างโดย AlphaEarth Foundations
ใบอนุญาต
คอลเล็กชันชุดข้อมูลนี้ได้รับอนุญาตภายใต้ CC-BY 4.0 และต้องมีข้อความแสดงแหล่งที่มาต่อไปนี้ "Custom Satellite Embeddings จาก AlphaEarth Foundations สร้างขึ้นโดย Google และ Google DeepMind" การใช้ชุดข้อมูลสาธารณะเหล่านี้เป็นไปตามนโยบายการใช้งานที่ยอมรับได้ของ Google Cloud
ชุดข้อมูลที่มีอยู่
ต่อไปนี้คือรายการชุดข้อมูลในที่เก็บข้อมูลนี้ ซึ่งประกอบด้วยชื่อ คำอธิบาย และพื้นที่ทั่วไปที่ชุดข้อมูลครอบคลุม โปรดทราบว่าช่วงเวลาที่นี่ใช้เวลาเริ่มต้นแบบรวมและเวลาสิ้นสุดแบบไม่รวม
name: corcoran_city_2026_agricultural_change
area: เมืองคอร์โคแรนและพื้นที่เกษตรกรรมโดยรอบ รัฐแคลิฟอร์เนีย สหรัฐอเมริกา
description: การฝังข้อมูลดินเปล่าในฤดูหนาว (15 ธ.ค. 2025 - 15 ก.พ. 2026) และความเขียวขจีสูงสุดในฤดูใบไม้ผลิ (15 มี.ค. - 15 พ.ค. 2026) ซึ่งบันทึกการเปลี่ยนแปลงของพืชผลทางการเกษตรในช่วงเวลา 2 ฤดูกาลname: futaleufu_argentina_2026_fire_scar
area: อุทยานแห่งชาติ Los Alerces และภูมิภาคโดยรอบ, เขต Futaleufú, จังหวัด Chubut, อาร์เจนตินา
description: การฝังก่อนเกิดไฟไหม้ (1-31 ธ.ค. 2025) และหลังเกิดไฟไหม้ (1-31 มี.ค. 2026) ที่บันทึกขอบเขตของรอยไหม้จากไฟป่าและการรบกวนเรือนยอดไม้ในป่าจากไฟป่า Los Alerces ปี 2026name: king_county_2025_monthly
area: คิงเคาน์ตี วอชิงตัน สหรัฐอเมริกา
description: การฝังตามเดือนในปฏิทินสำหรับเขตบริหารคิงเคาน์ตีในช่วง 6 เดือนแรกของปี 2025 ซึ่งครอบคลุมโครงสร้างพื้นฐานของเมืองที่หลากหลายและพื้นที่ป่าชื่อ: meloland_california_2026_crop_cycles
พื้นที่: เมโลแลนด์และพื้นที่เกษตรกรรมโดยรอบ อิมพีเรียลแวลลีย์ แคลิฟอร์เนีย สหรัฐอเมริกา
คำอธิบาย: ลำดับเวลาการฝังข้อมูลรายเดือน (วันที่ 15 ถึง 15) 6 เดือนติดต่อกัน (กลางเดือนพฤศจิกายน 2025 ถึงกลางเดือนพฤษภาคม 2026) ที่ติดตามรอบการหมุนเวียนพืชผลหลายชนิดname: pacific_palisades_2025_fire
area: Pacific Palisades และเนินเขาชายฝั่งโดยรอบ, ลอสแอนเจลิส, แคลิฟอร์เนีย, สหรัฐอเมริกา
description: การฝังข้อมูล 31 วันก่อนเกิดไฟไหม้ (7 ธ.ค. 2024 - 7 ม.ค. 2025) และหลังเกิดไฟไหม้ (7 ม.ค. - 7 ก.พ. 2025) ซึ่งบันทึกผลกระทบจากไฟป่า Palisades และการเปลี่ยนแปลงของสิ่งปกคลุมดินname: theewaterskloof_dam_2026_water_change
area: เขื่อน Theewaterskloof, เทศบาลท้องถิ่น Theewaterskloof, แอฟริกาใต้
description: การฝังข้อมูลในช่วงฤดูแล้ง (1-31 ม.ค. 2026) และการเติมน้ำในช่วงฤดูฝน (15 เม.ย. - 15 พ.ค. 2026) ที่บันทึกการเปลี่ยนแปลงของพื้นที่ผิวน้ำในอ่างเก็บน้ำ
โครงสร้างไดเรกทอรี
ชุดข้อมูลตัวอย่างทั้งหมดจะจัดระเบียบภายใต้คำนำหน้า 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
ชุดข้อมูลแต่ละชุดมีไดเรกทอรีของตัวเองซึ่งมีไฟล์ดัชนี GeoParquet ระดับชุดข้อมูล aef_index.parquet, ไฟล์ manifest.txt ระดับชุดข้อมูล และไดเรกทอรีย่อยของช่วงเวลาอย่างน้อย 1 รายการ
ไดเรกทอรีย่อยของช่วงเวลาเหล่านี้จะตั้งชื่อโดยใช้รูปแบบ {start_date}_{end_date} โดยที่วันที่เริ่มต้นจะรวมอยู่ด้วยและวันที่สิ้นสุดจะไม่รวมอยู่ด้วย วันที่ทั้งสองจะอยู่ในรูปแบบ yyyyMMdd และอยู่ในเขตเวลา UTC
ตัวอย่างเช่น ไดเรกทอรีย่อยสำหรับเดือนมิถุนายน 2025 จะมีชื่อว่า 20250601_20250701 ซึ่งสอดคล้องกับช่วงเวลาตั้งแต่ 2025-06-01T00:00:00Z (รวม) ถึง 2025-07-01T00:00:00Z (ไม่รวม)
ไดเรกทอรีช่วงเวลาแต่ละรายการจะมีไดเรกทอรีย่อยสำหรับการฝังรูปภาพแต่ละรายการภายในช่วงเวลานั้น โดยตั้งชื่อด้วยตัวระบุรูปภาพ ({image_id}) ที่ระบุรูปภาพภายในชุดข้อมูลโดยไม่ซ้ำกัน ไดเรกทอรีย่อย {image_id} แต่ละรายการจะมีไฟล์ COG data.tiff ของข้อมูลพิกเซลและไฟล์ image_manifest.json ไซด์คาร์ที่ใช้ในการลงทะเบียนข้อมูลใน Earth Engine
โครงสร้างไฟล์
โครงสร้างภายในของไฟล์ COG แต่ละไฟล์ ซึ่งรวมถึงขนาดพิกเซล 8192x8192, 64 ช่อง (A00 ถึง A63), พีระมิดภาพรวมที่ปรับให้เป็นมาตรฐาน, การควอนไทซ์จำนวนเต็ม 8 บิตที่มีเครื่องหมาย และค่ามาสก์ -128 NoData จะเหมือนกับ COG การฝังดาวเทียมประจำปี พิกเซลที่ถูกต้องในแต่ละชิ้นส่วนตัวอย่างมักจะครอบคลุมเฉพาะส่วนย่อยของตารางกริดขนาด 8192x8192 ที่สอดคล้องกับภูมิภาคที่สนใจ โดยพิกเซลที่เหลือทั้งหมดจะถูกมาสก์เป็น -128 (NoData) ซึ่งแตกต่างจาก COG ประจำปี ดูรายละเอียดทั้งหมดเกี่ยวกับเลย์เอาต์ COG ได้ที่ส่วนโครงสร้างไฟล์ของคู่มือข้อมูล GCS ของ AlphaEarth Foundations
เส้นทางของไฟล์ COG แต่ละไฟล์ยังมีข้อมูลบางอย่างด้วย ตัวอย่างเช่น ลองดูไฟล์ที่ gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/pacific_palisades_2025_fire/20250107_20250207/x1evicvaet1mupt13-0000008192-0000000000/data.tiff
ดังที่เห็นได้จากเส้นทาง ไฟล์นี้เป็นส่วนหนึ่งของการฝังสำหรับเหตุไฟไหม้ Palisades ปี 2025 ในเทศมณฑลลอสแอนเจลิส ไฟล์นี้มีการฝังที่สรุประยะเวลาตั้งแต่วันที่ 7 มกราคม 2025 (รวม) ถึงวันที่ 7 กุมภาพันธ์ 2025 (ไม่รวม) ชื่อไดเรกทอรีย่อย x1evicvaet1mupt13-0000008192-0000000000 จะระบุ COG data.tiff ในชุดข้อมูล pacific_palisades_2025_fire โดยไม่ซ้ำกัน ตัวระบุนี้เป็น UUID แบบทึบแสง
หรือจะดึงข้อมูลเมตาของไฟล์นี้และข้อมูลอื่นๆ จากไฟล์ image_manifest.json ของ COG ที่ gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/pacific_palisades_2025_fire/20250107_20250207/x1evicvaet1mupt13-0000008192-0000000000/image_manifest.json ก็ได้
ไฟล์นี้เป็นการแสดงไฟล์ Manifest ของรูปภาพ Earth Engine ในรูปแบบ JSON โครงสร้าง JSON ของไฟล์ Manifest ของรูปภาพจะกำหนดไว้ในคู่มือไฟล์ Manifest ของรูปภาพ ดูคำอธิบายทั้งหมดของเนื้อหาในไฟล์ image_manifest.json ที่ระบุได้ในส่วนไฟล์ Manifest ของรูปภาพ
การดีควอนไทเซชัน
ค่าพิกเซลดิบในแต่ละช่องเป็นจำนวนเต็ม 8 บิตที่มีเครื่องหมายในช่วง [-127, 127] (โดยมี -128 สงวนไว้เป็นค่า "ไม่มีข้อมูล") และต้องดีควอนไทซ์เพื่อสร้างค่าจุดลอยตัวที่พร้อมสำหรับการวิเคราะห์ในช่วง [-1, 1] ดูการแมปการดีควอนไทเซชันและวิธีการสร้างปิรามิดที่ลดสุ่มตัวอย่างได้ที่ส่วนการดีควอนไทเซชันและสร้างปิรามิดที่ลดสุ่มตัวอย่างในคู่มือข้อมูล GCS ของ AlphaEarth Foundations
ไฟล์ Manifest และดัชนี
เพื่ออำนวยความสะดวกในการค้นหา การทำซ้ำ และการลงทะเบียนไทล์ที่ฝัง ชุดข้อมูลแต่ละชุดจะมีไฟล์ Manifest 2 ประเภท ได้แก่ รายการไฟล์ COG ระดับชุดข้อมูล (manifest.txt) และไฟล์ Manifest ข้อมูลเมตาต่อรูปภาพ (image_manifest.json) พร้อมกับดัชนีเชิงพื้นที่ GeoParquet ระดับชุดข้อมูล (aef_index.parquet)
ไฟล์ Manifest ของชุดข้อมูล
ชุดข้อมูลทุกชุดจะมีไฟล์ manifest.txt อยู่ที่รูทของไดเรกทอรี ดังนี้
gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/{dataset_name}/manifest.txt
ซึ่งเป็นไฟล์ข้อความธรรมดาที่มี URI ของ Google Cloud Storage แบบเต็มสำหรับไฟล์ data.tiff แต่ละไฟล์ในชุดข้อมูล โดยคั่นด้วยการขึ้นบรรทัดใหม่
ไฟล์ Manifest ของรูปภาพ
ไฟล์ data.tiff ทุกไฟล์จะมีไฟล์ image_manifest.json ที่เป็นไฟล์ Sidecar อยู่ด้วย ดังนี้
gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/{dataset_name}/{start_date}_{end_date}/{image_id}/image_manifest.json
ไฟล์ JSON นี้เป็นไปตามข้อกำหนดเฉพาะของไฟล์ Manifest ของรูปภาพ Earth Engine และอธิบายไฟล์ต้นฉบับ โครงสร้างแบนด์ ขอบเขตเวลา และความครอบคลุมเชิงพื้นที่ของชิ้นส่วน
แม้ว่าช่องไฟล์ Manifest มาตรฐาน (เช่น tilesets และ bands) จะเป็นไปตามรูปแบบมาตรฐานของ Earth Engine แต่ก็มีรายละเอียดสำคัญหลายประการที่ควรทราบ ดังนี้
name: เว้นว่างไว้ ("") ใน GCS เมื่อใช้ไฟล์ Manifest นี้เพื่อลงทะเบียนรูปภาพในคอลเล็กชันชิ้นงาน Earth Engine ไคลเอ็นต์ต้องระบุรหัสเนื้อหาเป้าหมาย (เช่นprojects/{project}/assets/{collection}/{image_id}) ดูรายละเอียดได้ที่หัวข้อโหลดชุดข้อมูลลงใน Earth Enginestart_timeและend_time: ระบุการประทับเวลาเริ่มต้น (รวม) และสิ้นสุด (ไม่รวม) สำหรับระยะเวลาแบบผสมในรูปแบบ UTC ที่จัดรูปแบบเป็น ISO 8601 (เช่น2026-03-15T00:00:00+00:00)footprint: รูปหลายเหลี่ยมปิดในพิกัดพิกเซลที่แสดงขอบเขตของพื้นที่ซึ่งมีพิกเซลที่ถูกต้อง โปรดทราบว่าพิกเซลที่ขาดหายไปอาจยังคงอยู่ภายในรูปหลายเหลี่ยม เช่น ในกรณีของเรขาคณิตแบบฝังที่ซับซ้อนอย่างking_county_2025_monthlyproperties: ข้อมูลเมตาคีย์-ค่าที่เจาะจงสำหรับการฝัง ซึ่งรวมถึงIMAGE_ID: ตัวระบุที่ไม่ซ้ำกันของรูปภาพภายในชุดข้อมูลDATASET: ชื่อชุดข้อมูลDATASET_VERSION: เวอร์ชันชุดข้อมูลSTART_DATEและEND_DATE: วันที่เริ่มต้น (รวม) และวันที่สิ้นสุด (ไม่รวม) ของช่วงเวลาที่รูปภาพครอบคลุม โดยจัดรูปแบบเป็นYYYY-MM-DDMODEL_VERSION: สตริงเวอร์ชันที่ระบุเวอร์ชันโมเดลที่ใช้สร้างรูปภาพโดยไม่ซ้ำกันPROCESSING_SOFTWARE_VERSION: สตริงเวอร์ชันที่ระบุซอฟต์แวร์การประมวลผลข้อมูลโมเดลที่ใช้สร้างรูปภาพโดยไม่ซ้ำกันUTM_ZONE: โซน UTM ของระบบอ้างอิงพิกัดที่ใช้สร้างรูปภาพ
ดัชนี GeoParquet
ชุดข้อมูลทุกชุดจะมีไฟล์ดัชนีเชิงพื้นที่ GeoParquet อยู่ที่รูทของไดเรกทอรี ดังนี้
gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/{dataset_name}/aef_index.parquet
ดัชนีนี้มี 1 รายการสำหรับไฟล์ data.tiff แต่ละไฟล์ในชุดข้อมูล และให้ข้อมูลเมตาเชิงพื้นที่และเชิงเวลาเพื่อช่วยระบุว่าไฟล์ใดครอบคลุมพื้นที่และระยะเวลาที่กำหนด
geometry: เรขาคณิตของไฟล์เป็นรูปหลายเหลี่ยม WGS84 (EPSG:4326) ดูรายละเอียดเกี่ยวกับวิธีคำนวณรูปหลายเหลี่ยมนี้จากกรอบล้อมรอบ UTM ของอาร์เรย์พิกเซลและตัดให้พอดีกับขอบเขตโซน UTM ได้ที่ส่วนการประมวลผลเรขาคณิตของคู่มือข้อมูล GCS ของ AlphaEarth Foundations โปรดทราบว่ารูปหลายเหลี่ยมนี้แสดงขอบเขตของอาร์เรย์พิกเซลขนาด 8192x8192 เต็มรูปแบบ และไม่ได้พิจารณาความถูกต้องของพิกเซลแต่ละพิกเซลcrs: CRS ของโซน UTM ที่รูปภาพเป็นของรหัส EPSG เช่นEPSG:32610path: URI ของ Google Cloud Storage (gs://...) ของไฟล์ COGdata.tiffdataset: ชื่อชุดข้อมูลstart_dateและend_date: วันที่เริ่มต้น (รวม) และวันที่สิ้นสุด (ไม่รวม) ของช่วงเวลาที่รูปภาพครอบคลุม โดยจัดรูปแบบเป็นYYYY-MM-DDimage_id: ตัวระบุที่ไม่ซ้ำกันของรูปภาพภายในชุดข้อมูลutm_zone: โซน UTM ของรูปภาพ เช่น10Nutm_west,utm_south,utm_east,utm_north: ขอบเขต UTM ของอาร์เรย์พิกเซลข้อมูลดิบ ซึ่งไม่แสดงถึงการประมวลผลเรขาคณิตใดๆ และรวมพิกเซลทั้งหมดไม่ว่าจะถูกต้องหรือไม่ก็ตามwgs84_west,wgs84_south,wgs84_east,wgs84_north: ลองจิจูดและละติจูดต่ำสุดและสูงสุดของgeometryWGS84
โหลดชุดข้อมูลลงใน Earth Engine
หมายเหตุ: เพื่อความสะดวก ระบบจะเพิ่มชุดข้อมูลตัวอย่างทั้งหมดสำหรับการฝังดาวเทียมที่กำหนดเองลงใน Google Earth Engine เป็น ImageCollections สาธารณะโดยใช้วิธีการที่อธิบายไว้ในคู่มือ Notebook ที่ลิงก์ไว้ และจะมีการดีควอนไทซ์อยู่แล้ว ผู้ใช้ที่ลงทะเบียนชุดข้อมูล Custom Satellite Embedding ที่ส่งใหม่เป็น ImageCollections ของ Google Earth Engine สามารถใช้คำแนะนำที่ลิงก์ไว้ได้
คุณสามารถโหลด COG ลงใน Earth Engine ได้โดยลงทะเบียนเป็นชิ้นงานที่ COG สนับสนุนหรือโหลดโดยตรง โปรดดูสมุดบันทึกการเข้าถึงข้อมูลการฝังดาวเทียมที่กำหนดเองใน GitHub เพื่อดูคำแนะนำฉบับสมบูรณ์สำหรับทั้ง 2 วิธี ดูภาพรวมทั่วไปและการเปรียบเทียบทั้ง 2 วิธีนี้ได้ที่ไฟล์ GeoTIFF ที่เพิ่มประสิทธิภาพสำหรับระบบคลาวด์ (COG) ใน Earth Engine