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: 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: लॉस एलर्सेस नैशनल पार्क और आस-पास का इलाका, फ़ुतालेउफ़ू डिपार्टमेंट, चुबुत प्रांत, अर्जेंटीना
description: आग लगने से पहले (1 से 31 दिसंबर, 2025) और आग लगने के बाद (1 से 31 मार्च, 2026) की एंबेडिंग. इनमें, 2026 में लॉस एलर्सेस में लगी जंगल की आग से हुए नुकसान और जंगल के कैनोपी में आई रुकावट को कैप्चर किया गया है.name: king_county_2025_monthly
area: किंग काउंटी, वॉशिंगटन, अमेरिका
description: साल 2025 के पहले छह महीनों के लिए, किंग काउंटी के प्रशासनिक इलाके के लिए कैलेंडर-महीने के हिसाब से एंबेडिंग. इसमें अलग-अलग तरह के शहरी इंफ़्रास्ट्रक्चर और जंगल वाली ज़मीन शामिल है.name: meloland_california_2026_crop_cycles
area: मेलोलांड और उसके आस-पास के कृषि क्षेत्र, इंपीरियल वैली, कैलिफ़ोर्निया, अमेरिका
description: इसमें छह महीने (15 तारीख से 15 तारीख तक) के एंबेडिंग टाइम स्टेप शामिल हैं. ये नवंबर 2025 के मध्य से मई 2026 के मध्य तक के हैं. इनमें कई फसलों के रोटेशन साइकल को ट्रैक किया गया है.name: pacific_palisades_2025_fire
area: पैसिफ़िक पैलिसेड्स और उसके आस-पास की तटीय पहाड़ियां, लॉस एंजेलिस, कैलिफ़ोर्निया, अमेरिका
description: आग लगने से पहले (7 दिसंबर, 2024 से 7 जनवरी, 2025) और आग लगने के बाद (7 जनवरी से 7 फ़रवरी, 2025) की 31 दिनों की एंबेडिंग. इनमें पैलिसेड्स फ़ायर के असर और लैंड कवर में हुए बदलाव को कैप्चर किया गया है.name: theewaterskloof_dam_2026_water_change
area: थीवाटर्सक्लुफ़ डैम, थीवाटर्सक्लुफ़ लोकल म्यूनिसिपैलिटी, साउथ अफ़्रीका
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
हर डेटासेट की अपनी डायरेक्ट्री होती है. इसमें डेटासेट-लेवल की aef_index.parquet GeoParquet इंडेक्स फ़ाइल, डेटासेट-लेवल की manifest.txt फ़ाइल, और समय के अंतराल वाली एक या उससे ज़्यादा सबडायरेक्ट्री होती हैं.
समय के अंतराल वाली इन सबडायरेक्ट्री को {start_date}_{end_date} पैटर्न का इस्तेमाल करके नाम दिया जाता है. इसमें शुरू होने की तारीख शामिल होती है और खत्म होने की तारीख शामिल नहीं होती. दोनों तारीखें yyyyMMdd के तौर पर फ़ॉर्मैट की गई हैं और यूटीसी टाइमज़ोन में हैं.
उदाहरण के लिए, जून 2025 की सबडायरेक्ट्री का नाम 20250601_20250701 होगा. यह 2025-06-01T00:00:00Z (शामिल है) से लेकर 2025-07-01T00:00:00Z (शामिल नहीं है) तक की समयावधि से जुड़ा है.
समय के हर अंतराल की डायरेक्ट्री में, उस समयावधि के दौरान एम्बेड की गई हर इमेज के लिए एक सबडायरेक्ट्री होती है. इसका नाम, इमेज आइडेंटिफ़ायर ({image_id}) के साथ रखा जाता है. इससे डेटासेट में मौजूद इमेज की खास तौर पर पहचान की जाती है. हर {image_id} सबडायरेक्ट्री में, पिक्सल डेटा की एक data.tiff COG फ़ाइल और एक साइडकार image_manifest.json फ़ाइल होती है. इसका इस्तेमाल, Earth Engine में डेटा रजिस्टर करने के लिए किया जाता है.
फ़ाइल स्ट्रक्चर
हर सीओजी फ़ाइल का इंटरनल स्ट्रक्चर, सालाना सैटलाइट एंबेडिंग सीओजी जैसा ही होता है. इसमें 8192x8192 पिक्सल डाइमेंशन, 64 चैनल (A00 से A63), नॉर्मलाइज़्ड ओवरव्यू पिरामिड, साइन किया गया 8-बिट इंटिजर क्वांटाइज़ेशन, और -128 NoData मास्क वैल्यू शामिल होती है. हर साल के सीओजी के उलट, हर सैंपल टाइल में मान्य पिक्सल आम तौर पर, दिलचस्पी के क्षेत्र से जुड़े 8192x8192 ग्रिड के सिर्फ़ एक सबसेट को कवर करते हैं. बाकी सभी पिक्सल को -128 (NoData) के तौर पर मास्क किया जाता है. सीओजी लेआउट के बारे में पूरी जानकारी पाने के लिए, AlphaEarth Foundations GCS डेटा गाइड का फ़ाइल स्ट्रक्चर सेक्शन देखें.
हर सीओजी फ़ाइल के पाथ में भी कुछ जानकारी होती है. उदाहरण के लिए, gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/pacific_palisades_2025_fire/20250107_20250207/x1evicvaet1mupt13-0000008192-0000000000/data.tiff पर मौजूद फ़ाइल देखें.
पाथ से पता चलता है कि यह फ़ाइल, लॉस एंजेलिस काउंटी में 2025 में लगी पैलिसेड्स फ़ायर के लिए एंबेड की गई फ़ाइलों का हिस्सा है. इस फ़ाइल में ऐसी एम्बेडिंग मौजूद हैं जिनमें 7 जनवरी, 2025 से 7 फ़रवरी, 2025 तक की समयावधि की खास जानकारी शामिल है. x1evicvaet1mupt13-0000008192-0000000000 सबडायरेक्ट्री का नाम, pacific_palisades_2025_fire डेटासेट में मौजूद data.tiff सीओजी की खास तौर पर पहचान करता है. यह आइडेंटिफ़ायर, एक ओपेक यूयूआईडी है.
इसके अलावा, इस फ़ाइल का मेटाडेटा और अन्य जानकारी, सीओजी की image_manifest.json फ़ाइल से निकाली जा सकती है. यह फ़ाइल gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/pacific_palisades_2025_fire/20250107_20250207/x1evicvaet1mupt13-0000008192-0000000000/image_manifest.json पर मौजूद है.
यह फ़ाइल, Earth Engine इमेज मेनिफ़ेस्ट का JSON रिप्रज़ेंटेशन है. इमेज मेनिफ़ेस्ट के JSON स्ट्रक्चर के बारे में, इमेज मेनिफ़ेस्ट की गाइड में बताया गया है. किसी image_manifest.json फ़ाइल में मौजूद कॉन्टेंट की पूरी जानकारी के लिए, इमेज मेनिफ़ेस्ट सेक्शन देखें.
डी-क्वांटाइज़ेशन
हर चैनल में रॉ पिक्सल वैल्यू, [-127, 127] की रेंज में साइंड 8-बिट इंटिजर होती हैं. इसमें -128 को "कोई डेटा नहीं" वैल्यू के तौर पर रिज़र्व किया जाता है. साथ ही, [-1, 1] की रेंज में विश्लेषण के लिए तैयार फ़्लोटिंग-पॉइंट वैल्यू जनरेट करने के लिए, इन्हें डी-क्वांटाइज़ किया जाना चाहिए. डी-क्वांटाइज़ेशन मैपिंग और डाउनसैंपल किए गए पिरामिड बनाने के निर्देशों के लिए, AlphaEarth Foundations GCS डेटा गाइड के डी-क्वांटाइज़ेशन और डाउनसैंपल किए गए पिरामिड बनाएं सेक्शन देखें.
मेनिफ़ेस्ट और इंडेक्स
एंबेड की गई टाइल को खोजने, उन्हें दोहराने, और रजिस्टर करने के लिए, हर डेटासेट में दो तरह के मेनिफ़ेस्ट होते हैं. पहला, सीओजी फ़ाइलों की डेटासेट-लेवल की सूची (manifest.txt) और दूसरा, हर इमेज के लिए मेटाडेटा मेनिफ़ेस्ट (image_manifest.json). इसके साथ ही, डेटासेट-लेवल का GeoParquet स्पेशल इंडेक्स (aef_index.parquet) भी होता है.
डेटासेट मेनिफ़ेस्ट
हर डेटासेट में एक manifest.txt फ़ाइल होती है, जो उसकी डायरेक्ट्री के रूट में मौजूद होती है:
gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/{dataset_name}/manifest.txt
यह एक सादे टेक्स्ट वाली फ़ाइल होती है. इसमें डेटासेट में मौजूद हर data.tiff फ़ाइल का पूरा Google Cloud Storage यूआरआई होता है. हर यूआरआई को नई लाइन से अलग किया जाता है.
इमेज मेनिफ़ेस्ट
हर 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 ऐसेट कलेक्शन में किसी इमेज को रजिस्टर करने के लिए, इस मेनिफ़ेस्ट का इस्तेमाल करते समय क्लाइंट को टारगेट ऐसेट का आईडी (उदाहरण के लिए,projects/{project}/assets/{collection}/{image_id}) देना होगा. ज़्यादा जानकारी के लिए, Earth Engine में डेटासेट लोड करना लेख पढ़ें.start_timeऔरend_time: कंपोज़िट समयावधि के लिए, शुरू होने (शामिल है) और खत्म होने (शामिल नहीं है) के टाइमस्टैंप की जानकारी दें.यह जानकारी, आईएसओ 8601 के तौर पर फ़ॉर्मैट किए गए यूटीसी में होनी चाहिए. उदाहरण के लिए,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: इमेज बनाने के लिए इस्तेमाल किए गए कोऑर्डिनेट रेफ़रंस सिस्टम का यूटीएम ज़ोन.
GeoParquet इंडेक्स
हर डेटासेट में, GeoParquet की स्पेशल इंडेक्स फ़ाइल शामिल होती है. यह फ़ाइल, डेटासेट की डायरेक्ट्री के रूट में मौजूद होती है:
gs://alphaearth_foundations_custom/custom_satellite_embedding/v1/{dataset_name}/aef_index.parquet
इस इंडेक्स में, डेटासेट की हर data.tiff फ़ाइल के लिए एक एंट्री होती है. साथ ही, इसमें स्पेस और समय से जुड़ा मेटाडेटा होता है. इससे यह तय करने में मदद मिलती है कि कौनसी फ़ाइलें किसी दिए गए इलाके और समयावधि को कवर करती हैं:
geometry: फ़ाइल की ज्यामिति, WGS84 (EPSG:4326) पॉलीगॉन के तौर पर होनी चाहिए. यह पॉलीगॉन, पिक्सल कलेक्शन के यूटीएम बाउंडिंग बॉक्स से कैसे कैलकुलेट किया जाता है और यूटीएम ज़ोन की सीमाओं के हिसाब से कैसे काटा जाता है, इस बारे में ज़्यादा जानने के लिए, AlphaEarth Foundations GCS डेटा गाइड का ज्यामिति प्रोसेसिंग सेक्शन देखें. ध्यान दें कि यह पॉलीगॉन, पूरे 8192x8192 पिक्सल कलेक्शन की सीमाओं को दिखाता है. साथ ही, इसमें अलग-अलग पिक्सल की वैधता को ध्यान में नहीं रखा जाता.crs: ईपीएसजी कोड के तौर पर, इमेज के यूटीएम ज़ोन का सीआरएस, जैसे किEPSG:32610.path:data.tiffसीओजी फ़ाइल का Google Cloud Storage यूआरआई (gs://...).dataset: डेटासेट का नाम.start_dateऔरend_date: इमेज में शामिल समयावधि के शुरू होने (शामिल है) और खत्म होने (शामिल नहीं है) की तारीखें. इन्हेंYYYY-MM-DDके तौर पर फ़ॉर्मैट किया गया है.image_id: डेटासेट में मौजूद इमेज का यूनीक आइडेंटिफ़ायर.utm_zone: इमेज का यूटीएम ज़ोन, जैसे कि10N.utm_west,utm_south,utm_east,utm_north: रॉ पिक्सल कलेक्शन के यूटीएम बाउंड. इसमें कोई ज्यामिति प्रोसेसिंग नहीं दिखती. साथ ही, इसमें सभी पिक्सल शामिल होते हैं, भले ही वे मान्य हों या नहीं.wgs84_west,wgs84_south,wgs84_east,wgs84_north: WGS84geometryका कम से कम और ज़्यादा से ज़्यादा देशांतर और अक्षांश.
Earth Engine में डेटासेट लोड करना
ध्यान दें: कस्टम सैटलाइट एंबेडिंग के लिए सभी सैंपल डेटासेट, Google Earth Engine में सार्वजनिक ImageCollections के तौर पर जोड़े जाएंगे. इसके लिए, लिंक की गई नोटबुक गाइड में बताए गए तरीके का इस्तेमाल किया जाएगा. साथ ही, इन्हें पहले से ही डी-क्वांटाइज़ किया जाएगा. इस गाइड का इस्तेमाल वे उपयोगकर्ता कर सकते हैं जो डिलीवर किए गए नए कस्टम सैटलाइट एंबेडिंग डेटासेट को Google Earth Engine ImageCollections के तौर पर रजिस्टर कर रहे हैं.
सीओजी को Earth Engine में लोड करने के लिए, उन्हें सीओजी-बैक्ड ऐसेट के तौर पर रजिस्टर करें या सीधे लोड करें. दोनों तरीकों की पूरी जानकारी के लिए, GitHub पर कस्टम सैटलाइट एंबेडिंग डेटा ऐक्सेस नोटबुक देखें. इन दोनों तरीकों की खास जानकारी और तुलना के लिए, Earth Engine में क्लाउड के लिए ऑप्टिमाइज़ किए गए GeoTIFF (सीओजी) देखें.