gs://alphaearth_foundations_custom GCS paketi, AlphaEarth Foundations tarafından oluşturulan COG (Cloud Optimized GeoTIFF) dosyalarından oluşan özel uydu yerleştirmelerinin örnek veri kümelerini içerir.
Lisans
Bu veri kümesi koleksiyonu, CC-BY 4.0 kapsamında lisanslanmıştır ve şu atıf metnini gerektirir: "AlphaEarth Foundations'ın özel uydu yerleştirmeleri, Google ve Google DeepMind tarafından üretilmiştir." Bu herkese açık veri kümelerinin kullanımı, Google Cloud Kabul Edilebilir Kullanım Politikası'na tabidir.
Kullanılabilir veri kümeleri
Bu paketteki veri kümelerinin listesi aşağıda verilmiştir. Veri kümesinin adını, açıklamasını ve veri kümesinin kapsadığı genel alanı içerir. Buradaki zaman aralıklarında başlangıç zamanının dahil, bitiş zamanının ise hariç tutulduğunu unutmayın.
name: corcoran_city_2026_agricultural_change
area: Corcoran ve çevresindeki tarım bölgesi, Kaliforniya, ABD
description: İki mevsimsel dönem boyunca tarımsal mahsul dinamiklerini yakalayan kış çıplak toprak (15 Aralık 2025 - 15 Şubat 2026) ve ilkbahar zirve yeşillik (15 Mart - 15 Mayıs 2026) yerleştirmeleri.name: futaleufu_argentina_2026_fire_scar
area: Los Alerces Ulusal Parkı ve çevresi, Futaleufú Departmanı, Chubut Eyaleti, Arjantin
description: 2026 Los Alerces Orman Yangını'nın neden olduğu yanık izi boyutunu ve orman örtüsündeki bozulmayı gösteren, yangın öncesi (1-31 Aralık 2025) ve yangın sonrası (1-31 Mart 2026) yerleştirmeler.name: king_county_2025_monthly
area: King County, Washington, ABD
description: King County bağlı olduğu yeri için 2025'in ilk altı ayına ait takvim ayı yerleştirmeleri. Çeşitli kentsel şehir altyapısını ve ormanlık alanları kapsar.name: meloland_california_2026_crop_cycles
area: Meloland ve çevresindeki tarım alanları, Imperial Valley, Kaliforniya, ABD
description: Çoklu ürün rotasyon döngülerini izleyen altı ardışık aylık (15'inden 15'ine) yerleştirme zaman adımı (Kasım 2025'in ortasından Mayıs 2026'nın ortasına kadar).name: pacific_palisades_2025_fire
area: Pacific Palisades ve çevresindeki kıyı tepeleri, Los Angeles, Kaliforniya, ABD
description: Palisades yangınının etkisini ve arazi örtüsü değişimini gösteren, yangın öncesi (7 Aralık 2024 - 7 Ocak 2025) ve yangın sonrası (7 Ocak - 7 Şubat 2025) 31 günlük yerleştirmeler.name: theewaterskloof_dam_2026_water_change
area: Theewaterskloof Barajı, Theewaterskloof Yerel Belediyesi, Güney Afrika
description: Kurak mevsim (1-31 Ocak 2026) ve yağışlı mevsimde dolum (15 Nisan-15 Mayıs 2026) dönemlerinde baraj gölü su yüzey alanındaki değişiklikleri gösteren yerleştirmeler.
Dizin yapısı
Tüm örnek veri kümeleri gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/ öneki altında düzenlenir:
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
Her veri kümesinin, veri kümesi düzeyinde bir aef_index.parquet GeoParquet dizin dosyası, veri kümesi düzeyinde bir manifest.txt dosyası ve bir veya daha fazla zaman aralığı alt dizini içeren kendi dizini vardır.
Bu zaman aralığı alt dizinleri, {start_date}_{end_date} kalıbı kullanılarak adlandırılır. Burada başlangıç tarihi dahil, bitiş tarihi ise hariçtir. Her iki tarih de yyyyMMdd olarak biçimlendirilir ve UTC saat dilimindedir.
Örneğin, Haziran 2025 ayı için bir alt dizin 20250601_20250701 olarak adlandırılır. Bu, 2025-06-01T00:00:00Z (dahil) ile 2025-07-01T00:00:00Z (hariç) arasındaki bir zaman aralığına karşılık gelir.
Her zaman aralığı dizini, söz konusu zaman aralığındaki her bir resim yerleştirmesi için bir alt dizin içerir. Bu alt dizin, veri kümesindeki resmi benzersiz şekilde tanımlayan bir resim tanımlayıcısıyla ({image_id}) adlandırılır. Her {image_id} alt dizini, piksel verilerinin data.tiff COG dosyasını ve verileri Earth Engine'e kaydetmek için kullanılan bir yardımcı image_manifest.json dosyasını içerir.
Dosya yapısı
Her COG dosyasının iç yapısı (8192x8192 piksel boyutları, 64 kanal (A00 - A63), normalleştirilmiş genel bakış piramitleri, işaretli 8 bit tam sayı niceleme ve -128 NoData maske değeri dahil), yıllık Uydu Yerleştirme COG'leriyle aynıdır. Yıllık COG'lerin aksine, her örnek karodaki geçerli pikseller genellikle yalnızca ilgili bölgeye karşılık gelen 8192x8192 ızgaranın bir alt kümesini kapsar ve kalan tüm pikseller -128 (NoData) olarak maskelenir. COG düzeniyle ilgili tüm ayrıntılar için AlphaEarth Foundations GCS veri kılavuzunun Dosya yapısı bölümüne bakın.
Her COG dosyasının yolu da bazı bilgiler içerir. Örneğin, gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/pacific_palisades_2025_fire/20250107_20250207/x1evicvaet1mupt13-0000008192-0000000000/data.tiff adresindeki dosyayı inceleyin.
Yoldan da anlaşılacağı üzere bu dosya, Los Angeles County'deki 2025 Palisades yangınıyla ilgili yerleştirmelerin bir parçasıdır. Bu dosyada, 7 Ocak 2025 (dahil) ile 7 Şubat 2025 (hariç) arasındaki dönemi özetleyen yerleştirmeler bulunur. x1evicvaet1mupt13-0000008192-0000000000 alt dizin adı, pacific_palisades_2025_fire veri kümesindeki data.tiff COG'yi benzersiz şekilde tanımlar. Bu tanımlayıcı, opak bir UUID'dir.
Alternatif olarak, bu dosya meta verileri ve daha fazlası, COG'un gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/pacific_palisades_2025_fire/20250107_20250207/x1evicvaet1mupt13-0000008192-0000000000/image_manifest.json adresinde bulunan image_manifest.json dosyasından çıkarılabilir.
Bu dosya, Earth Engine görüntü manifestinin JSON gösterimidir. Resim manifestinin JSON yapısı, Resim Manifesti kılavuzunda tanımlanmıştır. Belirli bir image_manifest.json dosyasının içeriğinin tam açıklaması için Resim manifesti bölümüne bakın.
De-quantization (Kuantizasyonu kaldırma)
Her kanaldaki ham piksel değerleri, [-127, 127] aralığında işaretli 8 bitlik tam sayılardır (-128, "veri yok" değeri olarak ayrılmıştır) ve [-1, 1] aralığında analize hazır kayan nokta değerleri üretmek için niceliksizleştirilmelidir. Niceleme kaldırma eşlemesi ve alt örneklenmiş piramitler oluşturma talimatları için AlphaEarth Foundations GCS veri kılavuzunun Niceleme kaldırma ve Alt örneklenmiş piramitler oluşturma bölümlerine bakın.
Manifestler ve dizinler
Yerleştirme parçalarının keşfedilmesini, yinelenmesini ve kaydedilmesini kolaylaştırmak için her veri kümesi, veri kümesi düzeyinde bir GeoParquet uzamsal dizini (aef_index.parquet) ile birlikte iki tür manifest sağlar: COG dosyalarının veri kümesi düzeyinde bir listesi (manifest.txt) ve resim başına meta veri manifesti (image_manifest.json).
Veri kümesi manifesti
Her veri kümesi, dizininin kökünde bulunan bir manifest.txt dosyası içerir:
gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/{dataset_name}/manifest.txt
Bu, veri kümesindeki her bir data.tiff dosyasının tam Google Cloud Storage URI'sini içeren ve yeni satırlarla ayrılmış bir düz metin dosyasıdır.
Resim manifesti
Her data.tiff dosyasının yanında bir yardımcı image_manifest.json dosyası bulunur:
gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/{dataset_name}/{start_date}_{end_date}/{image_id}/image_manifest.json
Bu JSON dosyası, Earth Engine Görüntü Manifesti spesifikasyonuna uygundur ve karonun kaynak dosyalarını, bant yapısını, zamansal sınırlarını ve mekansal kapsamını açıklar.
Standart manifest alanları (ör. tilesets ve bands) standart Earth Engine kurallarına uysa da dikkat edilmesi gereken birkaç önemli ayrıntı vardır:
name: GCS'de boş bırakıldı (""). Bir Earth Engine öğe koleksiyonuna görüntü kaydetmek için bu manifest kullanılırken istemcinin hedef öğe kimliğini (ör.projects/{project}/assets/{collection}/{image_id}) sağlaması gerekir. Ayrıntılar için Earth Engine'e veri kümesi yükleme başlıklı makaleyi inceleyin.start_timeveend_time: Birleşik zaman dilimi için başlangıç (dahil) ve bitiş (hariç) zaman damgalarını ISO 8601 biçiminde UTC olarak belirtin (ör.2026-03-15T00:00:00+00:00).footprint: Geçerli pikseller içeren bir bölgenin ana hatlarını belirten piksel koordinatlarında kapalı bir çokgen. Çokgen içinde eksik pikseller olabileceğini unutmayın.king_county_2025_monthlygibi karmaşık yerleştirme geometrilerinde bu durum söz konusu olabilir.properties: Yerleştirmeye özgü anahtar/değer meta verileri. Şunları içerir:IMAGE_ID: Veri kümesindeki resmin benzersiz tanımlayıcısı.DATASET: Veri kümesinin adı.DATASET_VERSION: Veri kümesi sürümü.START_DATEveEND_DATE: Görüntünün kapsadığı zaman aralığının başlangıç (dahil) ve bitiş (hariç) tarihleri,YYYY-MM-DDolarak biçimlendirilmiştir.MODEL_VERSION: Resmi oluşturmak için kullanılan model sürümünü benzersiz şekilde tanımlayan sürüm dizesi.PROCESSING_SOFTWARE_VERSION: Resmi oluşturmak için kullanılan model veri işleme yazılımını benzersiz şekilde tanımlayan sürüm dizesi.UTM_ZONE: Resmi oluşturmak için kullanılan koordinat referans sisteminin UTM bölgesi.
GeoParquet dizini
Her veri kümesi, dizininin kökünde bulunan bir GeoParquet uzamsal dizin dosyası içerir:
gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/{dataset_name}/aef_index.parquet
Bu dizin, veri kümesindeki her data.tiff dosyası için bir giriş içerir ve belirli bir alanı ve zaman dilimini kapsayan dosyaların belirlenmesine yardımcı olmak için mekansal ve zamansal meta veriler sağlar:
geometry: Dosyanın WGS84 (EPSG:4326) poligonu olarak geometrisi. Bu poligonun piksel dizisinin UTM sınırlayıcı kutusundan nasıl hesaplandığı ve UTM bölge sınırlarına nasıl kırpıldığı hakkında ayrıntılı bilgi için AlphaEarth Foundations GCS veri kılavuzunun Geometri işleme bölümüne bakın. Bu poligonun, 8192x8192 piksellik tam dizinin sınırlarını yansıttığını ve tek tek piksellerin geçerliliğini hesaba katmadığını unutmayın.crs: Resmin ait olduğu UTM bölgesinin EPSG kodu olarak CRS'si (ör.EPSG:32610).path:data.tiffCOG dosyasının Google Cloud Storage URI'si (gs://...).dataset: Veri kümesinin adı.start_dateveend_date: Görüntünün kapsadığı zaman aralığının başlangıç (dahil) ve bitiş (hariç) tarihleri,YYYY-MM-DDolarak biçimlendirilmiştir.image_id: Veri kümesindeki resmin benzersiz tanımlayıcısı.utm_zone: Resmin UTM bölgesi (ör.10N).utm_west,utm_south,utm_east,utm_north: Ham piksel dizisinin UTM sınırları. Bu, geometri işleme'yi yansıtmaz ve geçerli olup olmadıklarına bakılmaksızın tüm pikselleri içerir.wgs84_west,wgs84_south,wgs84_east,wgs84_north: WGS84geometryiçin minimum ve maksimum boylam ve enlem.
Earth Engine'e veri kümesi yükleme
NOT: Özel Uydu Yerleştirmeleri için tüm örnek veri kümeleri, bağlantılı not defteri kılavuzunda açıklanan yöntem kullanılarak Google Earth Engine'e herkese açık ImageCollections olarak eklenir ve önceden de-quantize edilir. Bağlantılı kılavuz, yeni teslim edilen Özel Uydu Yerleştirme veri kümelerini Google Earth Engine ImageCollections olarak kaydeden kullanıcılar tarafından kullanılabilir.
COG'ler, COG destekli öğeler olarak kaydedilerek veya doğrudan yüklenerek Earth Engine'e yüklenebilir. Her iki yöntemin de eksiksiz kılavuzu için GitHub'daki Özel Uydu Yerleştirmeleri Veri Erişimi not defterine bakın. Bu iki yöntemin genel bir özeti ve karşılaştırması için Earth Engine'de Bulut İçin Optimize Edilmiş GeoTIFF'ler (COG'ler) başlıklı makaleyi inceleyin.