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