Zasobnik GCS gs://alphaearth_foundations_custom zawiera przykładowe zbiory danych niestandardowych satelitarnych wektorów dystrybucyjnych składających się z plików COG (Cloud Optimized GeoTIFF) wygenerowanych przez AlphaEarth Foundations.
Licencja
Ta kolekcja zbiorów danych jest objęta licencją CC-BY 4.0 i wymaga podania następującej informacji o pochodzeniu danych: „Niestandardowe wektory dystrybucyjne satelitarne z AlphaEarth Foundations są tworzone przez Google i Google DeepMind”. Korzystanie z tych publicznych zbiorów danych podlega Zasadom dopuszczalnego użytkowania Google Cloud.
Dostępne zbiory danych
Poniżej znajdziesz listę zbiorów danych w tym zasobniku. Zawiera nazwę zbioru danych, opis i ogólny obszar, który obejmuje. Pamiętaj, że przedziały czasu używają tu godziny rozpoczęcia (włącznie) i godziny zakończenia (wyłącznie).
name: corcoran_city_2026_agricultural_change
area: Corcoran i otaczający region rolniczy, Kalifornia, USA
description: wektory dystrybucyjne przedstawiające glebę bez roślinności zimą (15 grudnia 2025 r. – 15 lutego 2026 r.) i szczytową zieleń wiosną (15 marca – 15 maja 2026 r.) rejestrujące dynamikę upraw rolnych w 2 oknach sezonowych.name: futaleufu_argentina_2026_fire_scar
area: Park Narodowy Los Alerces i otaczający go region, departament Futaleufú, prowincja Chubut, Argentyna
description: wektory dystrybucyjne przed pożarem (1–31 grudnia 2025 r.) i po pożarze (1–31 marca 2026 r.) przedstawiające zasięg pożaru i zakłócenia w koronach drzew spowodowane pożarem w Los Alerces w 2026 r.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: Meloland i okoliczne pola uprawne, Imperial Valley, Kalifornia, USA
description: 6 kolejnych miesięcznych (od 15 do 15 dnia miesiąca) kroków czasowych wektora dystrybucyjnego (od połowy listopada 2025 r. do połowy maja 2026 r.) śledzących cykle rotacji wielu upraw.name: pacific_palisades_2025_fire
area: Pacific Palisades i okoliczne wzgórza nadmorskie, Los Angeles, Kalifornia, USA
description: 31-dniowe wektory dystrybucyjne przed pożarem (7 grudnia 2024 r. – 7 stycznia 2025 r.) i po pożarze (7 stycznia – 7 lutego 2025 r.) przedstawiające wpływ pożaru Palisades Fire i zmiany w pokryciu terenu.name: theewaterskloof_dam_2026_water_change
area: Tama Theewaterskloof, gmina Theewaterskloof, Republika Południowej Afryki
description: wektory dystrybucyjne z pory suchej (1–31 stycznia 2026 r.) i pory deszczowej (15 kwietnia – 15 maja 2026 r.) przedstawiające zmiany powierzchni wody w zbiorniku.
Struktura katalogu
Wszystkie przykładowe zbiory danych są uporządkowane pod prefiksem 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
Każdy zbiór danych ma własny katalog zawierający plik indeksu GeoParquet aef_index.parquet na poziomie zbioru danych, plik manifest.txt na poziomie zbioru danych oraz co najmniej 1 podkatalog przedziału czasu.
Te podkatalogi przedziałów czasowych są nazywane według wzorca {start_date}_{end_date}, gdzie data rozpoczęcia jest uwzględniana, a data zakończenia jest wykluczana. Obie daty są sformatowane jako yyyyMMdd i są podane w strefie czasowej UTC.
Na przykład podkatalog dla czerwca 2025 r. będzie miał nazwę 20250601_20250701, co odpowiada przedziałowi czasu od 2025-06-01T00:00:00Z (włącznie) do 2025-07-01T00:00:00Z (wyłącznie).
Każdy katalog przedziału czasu zawiera podkatalog dla każdego umieszczenia obrazu w tym przedziale czasu, nazwany identyfikatorem obrazu ({image_id}), który jednoznacznie identyfikuje obraz w zbiorze danych. Każdy podkatalog {image_id} zawiera plik COG data.tiff z danymi pikseli i plik pomocniczy image_manifest.json, który służy do rejestrowania danych w Earth Engine.
Struktura pliku
Struktura wewnętrzna każdego pliku COG – w tym wymiary 8192 x 8192 pikseli, 64 kanały (A00–A63), znormalizowane piramidy przeglądu, kwantyzacja 8-bitowych liczb całkowitych ze znakiem i wartość maski -128 NoData – jest identyczna jak w przypadku rocznych plików COG z wektorami dystrybucyjnymi zdjęć satelitarnych. W przeciwieństwie do rocznych plików COG prawidłowe piksele w każdym przykładowym kafelku zwykle pokrywają tylko podzbiór siatki 8192 x 8192 odpowiadający interesującemu regionowi, a wszystkie pozostałe piksele są maskowane jako -128 (NoData). Szczegółowe informacje o układzie COG znajdziesz w sekcji Struktura pliku w przewodniku po danych AlphaEarth Foundations GCS.
Ścieżka każdego pliku COG również zawiera pewne informacje. Weźmy na przykład plik gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/pacific_palisades_2025_fire/20250107_20250207/x1evicvaet1mupt13-0000008192-0000000000/data.tiff.
Jak widać w ścieżce, ten plik jest częścią wektorów dystrybucyjnych dotyczących pożaru Palisades w hrabstwie Los Angeles w 2025 r. Ten plik zawiera wektory dystrybucyjne, które podsumowują okres od 7 stycznia 2025 r. (włącznie) do 7 lutego 2025 r. (wyłącznie). Nazwa podkatalogu x1evicvaet1mupt13-0000008192-0000000000 jednoznacznie identyfikuje COG data.tiff w zbiorze danych pacific_palisades_2025_fire. Ten identyfikator to nieprzezroczysty identyfikator UUID.
Możesz też wyodrębnić te i inne metadane pliku z pliku image_manifest.json COG, który znajdziesz na stronie gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/pacific_palisades_2025_fire/20250107_20250207/x1evicvaet1mupt13-0000008192-0000000000/image_manifest.json.
Ten plik to reprezentacja JSON pliku manifestu obrazu Earth Engine. Struktura JSON pliku manifestu obrazu jest zdefiniowana w przewodniku po pliku manifestu obrazu. Pełny opis zawartości danego pliku image_manifest.json znajdziesz w sekcji Plik manifestu obrazu.
Dekwantyzacja
Nieprzetworzone wartości pikseli w każdym kanale to 8-bitowe liczby całkowite ze znakiem z zakresu [-127, 127] (przy czym wartość -128 jest zarezerwowana jako „brak danych”). Aby uzyskać gotowe do analizy wartości w reprezentacji zmiennoprzecinkowej z zakresu [-1, 1], należy je zdekwantyzować. Mapowanie dekwantyzacji i instrukcje tworzenia piramid z próbkowaniem w dół znajdziesz w sekcjach Dekwantyzacja i Tworzenie piramid z próbkowaniem w dół w przewodniku po danych AlphaEarth Foundations GCS.
Pliki manifestu i indeksy
Aby ułatwić odkrywanie, iterowanie i rejestrowanie kafelków osadzonych, każdy zbiór danych udostępnia 2 typy manifestów: listę plików COG na poziomie zbioru danych (manifest.txt) i manifest metadanych dla każdego obrazu (image_manifest.json) wraz z indeksem przestrzennym GeoParquet na poziomie zbioru danych (aef_index.parquet).
Plik manifestu zbioru danych
Każdy zbiór danych zawiera plik manifest.txt znajdujący się w katalogu głównym:
gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/{dataset_name}/manifest.txt
Jest to plik w formacie zwykłego tekstu zawierający pełny identyfikator URI obiektu w Google Cloud Storage dla każdego pliku data.tiff w zbiorze danych, oddzielony znakami nowego wiersza.
Plik manifestu obrazu
Obok każdego pliku data.tiff znajduje się plik pomocniczy image_manifest.json:
gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/{dataset_name}/{start_date}_{end_date}/{image_id}/image_manifest.json
Ten plik JSON jest zgodny ze specyfikacją pliku manifestu obrazu Earth Engine i opisuje pliki źródłowe kafelka, strukturę pasm, granice czasowe i zasięg przestrzenny.
Standardowe pola pliku manifestu (takie jak tilesets i bands) są zgodne ze standardowymi konwencjami Earth Engine, ale warto zwrócić uwagę na kilka kluczowych szczegółów:
name: pole pozostawione puste ("") w GCS. Podczas używania tego pliku manifestu do rejestrowania obrazu w kolekcji zasobów Earth Engine klient musi podać identyfikator zasobu docelowego (np.projects/{project}/assets/{collection}/{image_id}). Szczegółowe informacje znajdziesz w artykule Wczytywanie zbioru danych do Earth Engine.start_timeiend_time: określ sygnatury czasowe rozpoczęcia (włącznie) i zakończenia (wyłącznie) dla złożonego okresu w strefie czasowej UTC w formacie ISO 8601 (np.2026-03-15T00:00:00+00:00).footprint: zamknięty wielokąt we współrzędnych pikseli, który wyznacza region zawierający prawidłowe piksele. Pamiętaj, że w wielokącie mogą nadal występować brakujące piksele – tak jest w przypadku złożonych geometrii osadzania, takich jakking_county_2025_monthly.properties: metadane klucz-wartość dotyczące wektora dystrybucyjnego, w tym:IMAGE_ID: unikalny identyfikator obrazu w zbiorze danych.DATASET: nazwa zbioru danych.DATASET_VERSION: wersja zbioru danych.START_DATEiEND_DATE: daty rozpoczęcia (włącznie) i zakończenia (wyłącznie) przedziału czasu, który obejmuje obraz, w formacieYYYY-MM-DD.MODEL_VERSION: ciąg znaków wersji jednoznacznie identyfikujący wersję modelu użytego do wygenerowania obrazu.PROCESSING_SOFTWARE_VERSION: ciąg znaków wersji jednoznacznie identyfikujący oprogramowanie do przetwarzania danych modelu użyte do wygenerowania obrazu.UTM_ZONE: strefa UTM układu współrzędnych użytego do utworzenia obrazu.
Indeks GeoParquet
Każdy zbiór danych zawiera plik indeksu przestrzennego GeoParquet znajdujący się w katalogu głównym:
gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/{dataset_name}/aef_index.parquet
Ten indeks zawiera po 1 wpisie dla każdego pliku data.tiff w zbiorze danych i udostępnia metadane przestrzenne i czasowe, które pomagają określić, które pliki obejmują dany obszar i okres:
geometry: geometria pliku jako wielokąt WGS84 (EPSG:4326). Szczegółowe informacje o tym, jak ten wielokąt jest obliczany na podstawie ramki ograniczającej UTM tablicy pikseli i przycinany do granic strefy UTM, znajdziesz w sekcji Przetwarzanie geometrii w przewodniku po danych GCS AlphaEarth Foundations. Pamiętaj, że ten wielokąt odzwierciedla granice pełnej tablicy pikseli 8192 x 8192 i nie uwzględnia poprawności poszczególnych pikseli.crs: CRS strefy UTM, do której należy obraz, jako kod EPSG, np.EPSG:32610.path: identyfikator URI obiektu w Google Cloud Storage (gs://...) pliku COGdata.tiff.dataset: nazwa zbioru danych.start_dateiend_date: daty rozpoczęcia (włącznie) i zakończenia (wyłącznie) przedziału czasu, który obejmuje obraz, sformatowane jakoYYYY-MM-DD.image_id: unikalny identyfikator obrazu w zbiorze danych.utm_zone: strefa UTM obrazu, np.10N.utm_west,utm_south,utm_east,utm_north: granice UTM tablicy nieprzetworzonych pikseli. Nie odzwierciedla to przetwarzania geometrii i obejmuje wszystkie piksele, niezależnie od tego, czy są prawidłowe.wgs84_west,wgs84_south,wgs84_east,wgs84_north: minimalna i maksymalna długość oraz szerokość geograficzna w formacie WGS84geometry.
Wczytywanie zbioru danych do Earth Engine
UWAGA: dla wygody wszystkie przykładowe zbiory danych do niestandardowych wektorów dystrybucyjnych zdjęć satelitarnych zostaną dodane do Google Earth Engine jako publiczne kolekcje ImageCollections przy użyciu metody opisanej w powiązanym przewodniku po notatniku i będą już zdekwantyzowane. Z tego przewodnika mogą korzystać użytkownicy, którzy rejestrują nowo dostarczone zbiory danych Custom Satellite Embedding jako kolekcje obrazów Google Earth Engine.
Pliki COG można wczytać do Earth Engine, rejestrując je jako zasoby oparte na COG lub wczytując je bezpośrednio. Pełny przewodnik po obu metodach znajdziesz w notatniku Custom Satellite Embeddings Data Access na GitHubie. Ogólne omówienie i porównanie obu tych metod znajdziesz w artykule Pliki GeoTIFF zoptymalizowane pod kątem chmury (COG) w Earth Engine.