커스텀 위성 임베딩의 공개 데이터 샘플

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일) 임베딩입니다.

  • 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: Calendar-month embeddings for the King County administrative area for the first six months of 2025, covering diverse urban city infrastructure and forested land.

  • 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: 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 형식이며 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 파일이 포함되어 있습니다.

파일 구조

8192x8192픽셀 크기, 64개 채널(A00~A63), 정규화된 개요 피라미드, 부호 있는 8비트 정수 양자화, -128 NoData 마스크 값을 포함한 각 COG 파일의 내부 구조는 연간 위성 임베딩 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 데이터 가이드의 역양자화 및 다운샘플링된 피라미드 생성 섹션을 참조하세요.

매니페스트 및 색인

임베딩 타일의 검색, 반복, 등록을 용이하게 하기 위해 각 데이터 세트는 데이터 세트 수준의 GeoParquet 공간 색인(aef_index.parquet)과 함께 COG 파일의 데이터 세트 수준 목록(manifest.txt)과 이미지별 메타데이터 매니페스트(image_manifest.json)라는 두 가지 유형의 매니페스트를 제공합니다.

데이터 세트 매니페스트

모든 데이터 세트에는 디렉터리의 루트에 있는 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: ISO 8601 형식의 UTC로 복합 기간의 시작(포함) 및 종료(제외) 타임스탬프를 지정합니다(예: 2026-03-15T00:00:00+00:00).
  • footprint: 유효한 픽셀이 포함된 영역을 나타내는 픽셀 좌표의 닫힌 다각형입니다. 다각형 내에 누락된 픽셀이 여전히 존재할 수 있습니다. 이는 king_county_2025_monthly와 같은 복잡한 임베딩 도형의 경우입니다.
  • properties: 다음을 포함하여 임베딩과 관련된 키-값 메타데이터입니다.
    • 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 파일에 대한 항목이 하나씩 포함되어 있으며, 특정 영역과 기간을 다루는 파일을 결정하는 데 도움이 되는 공간 및 시간 메타데이터를 제공합니다.

  • 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에 데이터 세트 로드

참고: 편의상 커스텀 위성 임베딩의 모든 샘플 데이터 세트는 연결된 노트북 가이드에 설명된 방법을 사용하여 공개 ImageCollections로 Google Earth Engine에 추가되며 이미 역양자화되어 있습니다. 링크된 가이드는 새로 전송된 커스텀 위성 임베딩 데이터 세트를 Google Earth Engine ImageCollections로 등록하는 사용자가 사용할 수 있습니다.

COG는 COG 지원 애셋으로 등록하거나 직접 로드하여 Earth Engine에 로드할 수 있습니다. 두 방법에 관한 전체 가이드는 GitHub의 커스텀 위성 임베딩 데이터 액세스 노트북을 참고하세요. 두 방법의 일반적인 개요와 비교는 Earth Engine의 Cloud Optimized GeoTIFF(COG)를 참고하세요.