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