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