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/year में होती हैं. GeoTIFF तस्वीरों की फ़ाइल में 12 जनवरी — दिसंबर के हिसाब से बैंड. |
| घंटे के हिसाब से शेड | 32-बिट इंटिजर | 1 मी॰/पिक्सल | हर घंटे के शेड मैप के लिए 12 यूआरएल, जो जनवरी — दिसंबर,
ऑर्डर. हर GeoTIFF फ़ाइल में 24 बैंड होते हैं. ये बैंड दिन के 24 घंटे. हर पिक्सल एक 32 बिट का पूर्णांक होता है, जो उस महीने के 31 दिनों तक. 1 बिट का मतलब है कि संबंधित जगह उस दिन, उस घंटे में, उस महीने में सूरज को देख सकती है. अमान्य जगहों की जानकारी को -9999 के तौर पर सेव किया जाता है. साथ ही, बिट 31 को सेट किया जाता है, क्योंकि यह महीने के 32वें दिन से जुड़ा होता है और इसलिए अमान्य होता है. |
हर घंटे के शेड रास्टर को डिकोड करें
हर घंटे के हिसाब से शेड डेटा को मल्टीबैंड रैस्टर में एन्कोड किया जाता है. रास्टर के बारे में ज़्यादा जानने के लिए Solar API Concepts की बुनियादी जानकारी देखें.
हर घंटे के शेड डेटा के लिए अनुरोध करने पर, आपको ज़्यादा से ज़्यादा 12 रास्टर मिल सकते हैं. कैलेंडर साल के हर महीने (जनवरी से दिसंबर तक) के लिए एक ऑफ़र. हर रास्टर 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))