dataLayers एंडपॉइंट, GeoTIFF फ़ाइलों के तौर पर एन्कोड किया गया डेटा दिखाता है. इन फ़ाइलों का इस्तेमाल सौर सिस्टम डिज़ाइन करने के लिए, किसी भी भौगोलिक जानकारी सिस्टम (GIS) ऐप्लिकेशन में किया जा सकता है.
डेटा स्तर के जवाब की हर स्ट्रिंग में एक यूआरएल होता है, जिसका इस्तेमाल आप उससे जुड़े GeoTIFF फ़ेच कर सकते हैं. मूल डेटा लेयर के अनुरोध से जनरेट होने वाले यूआरएल एक घंटे तक मान्य रहते हैं. GeoTIFF फ़ाइलों को 30 दिनों तक सेव करके रखा जा सकता है.
आरजीबी लेयर को छोड़कर, GeoTIFF फ़ाइलें किसी इमेज व्यूअर के साथ सही तरीके से नहीं दिखती हैं. ऐसा इसलिए होता है, क्योंकि कॉन्टेंट को आरजीबी इमेज के बजाय कोड में बदला गया डेटा होता है. GeoTIFF फ़ाइलों को Maps JavaScript API के साथ सीधे ओवरले इमेज के रूप में भी इस्तेमाल नहीं किया जा सकता.
नीचे दी गई टेबल में, हर लेयर के बारे में पूरी जानकारी दी गई है.
| परत | पिक्सल की गहराई | रिज़ॉल्यूशन | जानकारी |
|---|---|---|---|
| डिजिटल सर्फ़ेस मॉडल (डीएसएम) | 32-बिट फ़्लोट | 0.1 मी॰/पिक्सल | ऊंचाई का डेटा, जो पृथ्वी की सतह की टोपोग्राफ़ी को दिखाता है. इसमें प्राकृतिक और बनाई गई सुविधाएं भी शामिल हैं. वैल्यू समुद्र तल से मीटर में दी गई हैं. अमान्य जगहों या उन इलाकों को -9999 के तौर पर सेव किया जाता है जिनका डेटा हमारे पास नहीं है. |
| RGB | 8-बिट | 0.1 मी॰/पिक्सल 0.25 मी॰/पिक्सल 0.5 मी॰/पिक्सल 1 मी॰/पिक्सल |
इलाके की एरियल इमेज. GeoTIFF की तस्वीरों के संग्रह में
लाल, हरे, और नीले रंग की वैल्यू से जुड़े तीन बैंड होते हैं.
हर पिक्सल के लिए 24-बिट आरजीबी वैल्यू होती है. डिफ़ॉल्ट रूप से, पिक्सल रिज़ॉल्यूशन 0.1 मीटर/पिक्सल होता है. |
| इमारत के लिए मास्क | 1-बिट | 0.1 मी॰/पिक्सल | हर पिक्सल के लिए एक बिट, जिससे पता चलता है कि उस पिक्सल को किसी छत का हिस्सा माना गया है या नहीं. |
| सालाना फ़्लक्स | 32-बिट फ़्लोट | 0.1 मी॰/पिक्सल | इलाके का सालाना फ़्लक्स मैप या छत पर पड़ने वाली सूरज की रोशनी.
वैल्यू kWh/kW/साल हैं. Flux का हिसाब सिर्फ़ छतों को बनाने के साथ-साथ हर जगह के लिए लगाया जाता है. अमान्य जगहों या उन इलाकों को -9999 के तौर पर स्टोर किया जाता है जहां हम फ़्लक्स का हिसाब नहीं लगा पाते. हमारे कवरेज एरिया से बाहर की जगहें अमान्य हैं. ध्यान दें: यह बिना मास्क वाला फ़्लक्स है. |
| हर महीने का फ़्लक्स | 32-बिट फ़्लोट | 0.5 मी॰/पिक्सल | इलाके का महीने का फ़्लक्स मैप (छतों पर सूरज की रोशनी, महीने के हिसाब से अलग-अलग किया गया है). वैल्यू kWh/kW/साल हैं. GeoTIFF की तस्वीरों के संग्रह की फ़ाइल में जनवरी से दिसंबर के बीच 12 बैंड शामिल होते हैं. |
| हर घंटे के हिसाब से शेड | 32-बिट पूर्णांक | 1 मी॰/पिक्सल | हर घंटे के हिसाब से शेड मैप के लिए, जनवरी से दिसंबर के बीच के क्रम में 12 यूआरएल
उपलब्ध हैं. हर GeoTIFF फ़ाइल में 24 बैंड होते हैं. ये बैंड, दिन के 24 घंटों के हिसाब से होते हैं. हर पिक्सल एक 32 बिट का पूर्णांक होता है, जो उस महीने के 31 दिनों के हिसाब से (ज़्यादा से ज़्यादा) होता है. 1 बिट का मतलब है कि जगह की जानकारी, उस महीने में उस दिन, उस समय, सूरज को देख पाएगी. अमान्य जगहों को -9999 के तौर पर सेव किया जाता है और इनमें बिट 31 सेट होता है. ऐसा इसलिए होता है, क्योंकि ये जगहें महीने के 32वें दिन से संबंधित होती हैं, इसलिए अमान्य होती हैं. |
हर घंटे के हिसाब से शेड रास्टर डिकोड करना
हर घंटे के शेड डेटा को मल्टीबैंड रास्टर में एन्कोड किया जाता है. रास्टर की बुनियादी बातों के बारे में ज़्यादा जानने के लिए, Solar API Concepts देखें.
हर घंटे के शेड वाले डेटा के लिए अनुरोध करने पर, आपको ज़्यादा से ज़्यादा 12 रास्टर मिल सकते हैं. यह डेटा, कैलेंडर साल के हर महीने (जनवरी से दिसंबर) के लिए मिलता है. हर रास्टर 24 लेयर या बैंड से बना होता है, जो दिन के 24 घंटों के हिसाब से होते हैं.
हर बैंड को सेल के मैट्रिक्स या पिक्सल से दिखाया जाता है. हर पिक्सल में 32 बिट की डेप्थ होती है, जो महीने के 31 दिनों (ज़्यादा से ज़्यादा) के बराबर होती है. इसलिए, शेड डेटा के दिन, समय, और महीने को डिकोड करने के लिए, उन बिट, बैंड, और रास्टर को समझना ज़रूरी है जिनका विश्लेषण किया जा रहा है.
उदाहरण के लिए, यह पता लगाने के लिए कि क्या निर्देशांक (x, y) पर किसी जगह पर, 22 जून को शाम 4:00 बजे सूरज दिखा, नीचे दिया गया तरीका अपनाएं:
- स्थान (x, y) के लिए सभी लेयर के लिए डेटा लेयर का अनुरोध करें.
- जून, साल का छठा महीना होता है. इसलिए,
hourlyShadeUrlsकी सूची में छठा यूआरएल फ़ेच करें. - घंटे के हिसाब से बैंड, 24 घंटे में दिए जाते हैं. शाम 4 बजे (16:00) का डेटा देखने के लिए, 17वां चैनल खोजें.
- बिट (दिन) का इंडेक्स 0 से है. जून के 22वें दिन का डेटा पाने के लिए, बिट 21 पढ़ें.
- बिट से बाइनरी डेटा मिलता है और पता चलता है कि उस जगह पर दी गई तारीख और समय पर सूरज की रोशनी बढ़ी या नहीं. अगर बिट 1 है, तो जगह के आस-पास सूरज दिखा. अगर बिट 0 है, तो जगह की शेड दिखाई गई थी.
नीचे दिया गया कोड, ऊपर दिए गए चरणों की खास जानकारी देता है:
(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))