Bộ chứa GCS gs://alphaearth_foundations_custom chứa các tập dữ liệu mẫu của
Giá trị nhúng vệ tinh tuỳ chỉnh được tạo từ các tệp COG (Cloud Optimized GeoTIFF)
do AlphaEarth Foundations tạo.
Giấy phép
Tập hợp các tập dữ liệu này được cấp phép theo CC-BY 4.0 và yêu cầu phải có văn bản ghi công sau: "Các mục nhúng vệ tinh tuỳ chỉnh từ AlphaEarth Foundations do Google và Google DeepMind tạo ra". Việc sử dụng các tập dữ liệu công khai này phải tuân thủ Chính sách sử dụng của Google Cloud.
Tập dữ liệu có sẵn
Sau đây là danh sách các tập dữ liệu trong bộ chứa này. Tệp này chứa tên, nội dung mô tả và khu vực khái quát của tập dữ liệu. Xin lưu ý rằng khoảng thời gian ở đây sử dụng thời gian bắt đầu (bao gồm) và thời gian kết thúc (không bao gồm).
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: Vườn quốc gia Los Alerces và khu vực lân cận, tỉnh Futaleufú, tỉnh Chubut, Argentina
description: Các mục nhúng trước khi cháy (1 – 31 tháng 12 năm 2025) và sau khi cháy (1 – 31 tháng 3 năm 2026) ghi lại phạm vi vết cháy rừng và sự xáo trộn tán rừng do vụ cháy rừng Los Alerces năm 2026 gây ra.name: king_county_2025_monthly
area: King County, Washington, USA
description: Bản nhúng theo tháng dương lịch cho khu vực hành chính King County trong 6 tháng đầu năm 2025, bao gồm nhiều cơ sở hạ tầng đô thị và đất rừng.name: meloland_california_2026_crop_cycles
area: Meloland và các cánh đồng nông nghiệp xung quanh, Thung lũng Imperial, California, Hoa Kỳ
description: Sáu bước thời gian nhúng liên tiếp hằng tháng (từ ngày 15 đến ngày 15) (từ giữa tháng 11 năm 2025 đến giữa tháng 5 năm 2026) theo dõi các chu kỳ luân canh nhiều loại cây trồng.name: pacific_palisades_2025_fire
area: Pacific Palisades và các ngọn đồi ven biển xung quanh, Los Angeles, California, Hoa Kỳ
description: Các mục nhúng 31 ngày trước khi xảy ra cháy rừng (7/12/2024 – 7/1/2025) và sau khi xảy ra cháy rừng (7/1 – 7/2/2025) ghi lại tác động của vụ cháy rừng Palisades và sự thay đổi về lớp phủ bề mặt đất.name: theewaterskloof_dam_2026_water_change
area: Đập Theewaterskloof, Đô thị địa phương Theewaterskloof, Nam Phi
description: Các mục nhúng mùa khô (ngày 1 đến ngày 31 tháng 1 năm 2026) và mùa mưa (ngày 15 tháng 4 đến ngày 15 tháng 5 năm 2026) ghi lại những thay đổi về diện tích bề mặt nước của hồ chứa.
Cấu trúc thư mục
Tất cả các tập dữ liệu mẫu đều được sắp xếp theo tiền tố 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
Mỗi tập dữ liệu có thư mục riêng chứa tệp chỉ mục GeoParquet aef_index.parquet ở cấp tập dữ liệu, tệp manifest.txt ở cấp tập dữ liệu và một hoặc nhiều thư mục con theo khoảng thời gian.
Các thư mục con của khoảng thời gian này được đặt tên theo mẫu {start_date}_{end_date}, trong đó ngày bắt đầu được bao gồm và ngày kết thúc không được bao gồm. Cả hai ngày đều được định dạng là yyyyMMdd và theo múi giờ UTC.
Ví dụ: một thư mục con cho tháng 6 năm 2025 sẽ có tên là 20250601_20250701, tương ứng với khoảng thời gian từ 2025-06-01T00:00:00Z (bao gồm) đến 2025-07-01T00:00:00Z (không bao gồm).
Mỗi thư mục khoảng thời gian chứa một thư mục con cho mỗi mục nhúng hình ảnh trong khoảng thời gian đó, được đặt tên bằng giá trị nhận dạng hình ảnh ({image_id}) giúp xác định hình ảnh duy nhất trong tập dữ liệu. Mỗi thư mục con {image_id} chứa một tệp COG data.tiff của dữ liệu pixel và một tệp image_manifest.json phụ được dùng để đăng ký dữ liệu trong Earth Engine.
Cấu trúc tệp
Cấu trúc nội bộ của mỗi tệp COG (bao gồm kích thước pixel 8192x8192, 64 kênh (A00 đến A63), kim tự tháp tổng quan chuẩn hoá, lượng tử hoá số nguyên 8 bit có dấu và giá trị mặt nạ -128 NoData) giống hệt với COG nhúng vệ tinh hằng năm. Không giống như COG hằng năm, các pixel hợp lệ trong
mỗi ô mẫu thường chỉ bao phủ một tập hợp con của lưới 8192x8192
tương ứng với vùng quan tâm, trong đó tất cả các pixel còn lại được che dưới dạng
-128 (NoData). Để biết thông tin chi tiết đầy đủ về bố cục COG, hãy xem
phần Cấu trúc tệp
trong hướng dẫn về dữ liệu GCS của AlphaEarth Foundations.
Đường dẫn của mỗi tệp COG cũng chứa một số thông tin. Ví dụ: hãy xem xét tệp tại gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/pacific_palisades_2025_fire/20250107_20250207/x1evicvaet1mupt13-0000008192-0000000000/data.tiff.
Như bạn thấy trong đường dẫn, tệp này là một phần của các mục nhúng cho vụ cháy Palisades năm 2025 ở Quận Los Angeles. Tệp cụ thể này chứa các mục nhúng tóm tắt một khoảng thời gian từ ngày 7 tháng 1 năm 2025 (bao gồm) đến ngày 7 tháng 2 năm 2025 (không bao gồm). Tên thư mục con x1evicvaet1mupt13-0000008192-0000000000 xác định duy nhất COG data.tiff trong tập dữ liệu pacific_palisades_2025_fire. Giá trị nhận dạng này là một UUID không rõ ràng.
Ngoài ra, bạn có thể trích xuất siêu dữ liệu của tệp này và nhiều thông tin khác từ tệp image_manifest.json của COG tại gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/pacific_palisades_2025_fire/20250107_20250207/x1evicvaet1mupt13-0000008192-0000000000/image_manifest.json.
Tệp này là bản trình bày JSON của một Tệp kê khai hình ảnh Earth Engine. Cấu trúc JSON của Tệp kê khai hình ảnh được xác định trong Hướng dẫn về tệp kê khai hình ảnh. Để xem nội dung mô tả đầy đủ về nội dung trong một tệp image_manifest.json nhất định, hãy xem phần Tệp kê khai hình ảnh.
Phép giải lượng tử
Giá trị pixel thô trong mỗi kênh là số nguyên 8 bit có dấu trong phạm vi [-127, 127] (với -128 được đặt trước làm giá trị "không có dữ liệu") và phải được khử lượng tử hoá để tạo ra các giá trị dấu phẩy động sẵn sàng phân tích trong phạm vi [-1, 1]. Để biết thông tin về việc liên kết giải lượng tử hoá và hướng dẫn tạo kim tự tháp lấy mẫu giảm, hãy xem phần Giải lượng tử hoá và Tạo kim tự tháp lấy mẫu giảm trong hướng dẫn về dữ liệu AlphaEarth Foundations trên GCS.
Tệp kê khai và chỉ mục
Để hỗ trợ việc khám phá, lặp lại và đăng ký các ô nhúng, mỗi tập dữ liệu cung cấp hai loại tệp kê khai: danh sách tệp COG ở cấp tập dữ liệu (manifest.txt) và tệp kê khai siêu dữ liệu cho mỗi hình ảnh (image_manifest.json), cùng với chỉ mục không gian GeoParquet ở cấp tập dữ liệu (aef_index.parquet).
Tệp kê khai tập dữ liệu
Mỗi tập dữ liệu đều có một tệp manifest.txt nằm ở thư mục gốc:
gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/{dataset_name}/manifest.txt
Đây là tệp văn bản thuần túy chứa URI Google Cloud Storage đầy đủ cho mỗi tệp data.tiff trong tập dữ liệu, được phân tách bằng dòng mới.
Tệp kê khai hình ảnh
Bên cạnh mỗi tệp data.tiff là một tệp image_manifest.json đi kèm:
gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/{dataset_name}/{start_date}_{end_date}/{image_id}/image_manifest.json
Tệp JSON này tuân theo Thông số kỹ thuật của tệp kê khai hình ảnh Earth Engine và mô tả các tệp nguồn, cấu trúc dải, ranh giới thời gian và phạm vi không gian của thẻ thông tin.
Mặc dù các trường tệp kê khai tiêu chuẩn (chẳng hạn như tilesets và bands) tuân theo các quy ước tiêu chuẩn của Earth Engine, nhưng có một số chi tiết quan trọng cần lưu ý:
name: Để trống ("") trong GCS. Khi sử dụng tệp kê khai này để đăng ký một hình ảnh trong tập hợp tài sản Earth Engine, ứng dụng phải cung cấp mã tài sản mục tiêu (ví dụ:projects/{project}/assets/{collection}/{image_id}). Hãy xem bài viết Tải tập dữ liệu vào Earth Engine để biết thông tin chi tiết.start_timevàend_time: Chỉ định dấu thời gian bắt đầu (bao gồm) và kết thúc (không bao gồm) cho khoảng thời gian tổng hợp theo giờ UTC, được định dạng theo ISO 8601 (ví dụ:2026-03-15T00:00:00+00:00).footprint: Một đa giác khép kín trong toạ độ pixel phác thảo một vùng chứa các pixel hợp lệ. Xin lưu ý rằng các pixel bị thiếu vẫn có thể tồn tại trong đa giác – chẳng hạn như trường hợp hình học nhúng phức tạp như củaking_county_2025_monthly.properties: Siêu dữ liệu khoá-giá trị dành riêng cho mục nhúng, bao gồm:IMAGE_ID: Giá trị nhận dạng riêng biệt của hình ảnh trong tập dữ liệu.DATASET: Tên tập dữ liệu.DATASET_VERSION: Phiên bản tập dữ liệu.START_DATEvàEND_DATE: Ngày bắt đầu (bao gồm) và ngày kết thúc (không bao gồm) của khoảng thời gian mà hình ảnh bao gồm, được định dạng làYYYY-MM-DD.MODEL_VERSION: Chuỗi phiên bản xác định duy nhất phiên bản mô hình được dùng để tạo hình ảnh.PROCESSING_SOFTWARE_VERSION: Chuỗi phiên bản xác định duy nhất phần mềm xử lý dữ liệu mô hình được dùng để tạo hình ảnh.UTM_ZONE: Vùng UTM của hệ toạ độ tham chiếu dùng để tạo hình ảnh.
Chỉ mục GeoParquet
Mỗi tập dữ liệu đều có một tệp chỉ mục không gian GeoParquet nằm ở thư mục gốc:
gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/{dataset_name}/aef_index.parquet
Chỉ mục này chứa một mục cho mỗi tệp data.tiff trong tập dữ liệu và cung cấp siêu dữ liệu về không gian và thời gian để giúp xác định tệp nào bao gồm một khu vực và khoảng thời gian nhất định:
geometry: Hình dạng của tệp dưới dạng đa giác WGS84 (EPSG:4326). Để biết thông tin chi tiết về cách tính toán đa giác này từ hộp giới hạn UTM của mảng pixel và cắt theo ranh giới vùng UTM, hãy xem phần Xử lý hình học trong hướng dẫn về dữ liệu GCS của AlphaEarth Foundations. Xin lưu ý rằng đa giác này phản ánh ranh giới của toàn bộ mảng pixel 8192x8192 và không tính đến tính hợp lệ của từng pixel.crs: CRS của vùng UTM mà hình ảnh thuộc về dưới dạng mã EPSG, chẳng hạn nhưEPSG:32610.path: URI của Google Cloud Storage (gs://...) của tệp COGdata.tiff.dataset: Tên tập dữ liệu.start_datevàend_date: Ngày bắt đầu (bao gồm) và ngày kết thúc (không bao gồm) của khoảng thời gian mà hình ảnh bao gồm, được định dạng làYYYY-MM-DD.image_id: Giá trị nhận dạng riêng biệt của hình ảnh trong tập dữ liệu.utm_zone: Vùng UTM của hình ảnh, chẳng hạn như10N.utm_west,utm_south,utm_east,utm_north: Ranh giới UTM của mảng pixel thô. Điều này không phản ánh bất kỳ quá trình xử lý hình học nào và bao gồm tất cả các pixel cho dù chúng có hợp lệ hay không.wgs84_west,wgs84_south,wgs84_east,wgs84_north: Kinh độ và vĩ độ tối thiểu và tối đa củageometryWGS84.
Tải tập dữ liệu vào Earth Engine
LƯU Ý: Để thuận tiện, tất cả các tập dữ liệu mẫu cho Bản nhúng vệ tinh tuỳ chỉnh sẽ được thêm vào Google Earth Engine dưới dạng ImageCollections công khai bằng phương thức được mô tả trong hướng dẫn về sổ tay được liên kết và sẽ được huỷ lượng tử hoá. Người dùng có thể sử dụng hướng dẫn được liên kết để đăng ký các tập dữ liệu Nhúng vệ tinh tuỳ chỉnh mới được cung cấp dưới dạng ImageCollections của Google Earth Engine.
Bạn có thể tải COG vào Earth Engine bằng cách đăng ký COG dưới dạng tài sản được COG hỗ trợ hoặc tải trực tiếp. Hãy xem sổ tay Truy cập dữ liệu nhúng vệ tinh tuỳ chỉnh trên GitHub để biết hướng dẫn đầy đủ về cả hai phương thức. Để biết thông tin tổng quan và so sánh cả hai phương thức này, hãy xem bài viết GeoTIFF được tối ưu hoá cho đám mây (COG) trong Earth Engine.