REST Resource: dataLayers

संसाधन: DataLayers

किसी इलाके में सौर ऊर्जा के उत्पादन की क्षमता के बारे में जानकारी. असल डेटा, अनुरोध की गई जगह को कवर करने वाली कई GeoTIFF फ़ाइलों में मौजूद होता है. इस मैसेज में इन फ़ाइलों के यूआरएल शामिल होते हैं: DataLayers मैसेज में मौजूद हर स्ट्रिंग में एक यूआरएल होता है. इस यूआरएल से, उससे जुड़ी GeoTIFF फ़ाइल को फ़ेच किया जा सकता है. ये यूआरएल जनरेट होने के कुछ घंटों तक मान्य होते हैं. ज़्यादातर GeoTIFF फ़ाइलें 0.1 मीटर/पिक्सल के रिज़ॉल्यूशन पर होती हैं. हालांकि, महीने के फ़्लक्स की फ़ाइल 0.5 मीटर/पिक्सल पर होती है और हर घंटे की शेड फ़ाइलें 1 मीटर/पिक्सल पर होती हैं. अगर GetDataLayersRequest में pixelSizeMeters वैल्यू दी गई थी, तो GeoTIFF फ़ाइलों में कम से कम रिज़ॉल्यूशन वही वैल्यू होगी.

JSON के काेड में दिखाना 
{
  "imageryDate": {
    object (Date)
  },
  "imageryProcessedDate": {
    object (Date)
  },
  "dsmUrl": string,
  "rgbUrl": string,
  "maskUrl": string,
  "annualFluxUrl": string,
  "monthlyFluxUrl": string,
  "hourlyShadeUrls": [
    string
  ],
  "imageryQuality": enum (ImageryQuality)
}
फ़ील्ड
imageryDate

object (Date)

इस इलाके की सोर्स इमेज कब ली गई थी. इसी इमेज से अन्य सभी डेटा लिए गए हैं. यह जानकारी कुछ हद तक अनुमानित होती है, क्योंकि हो सकता है कि इमेज एक से ज़्यादा दिनों में ली गई हों.
imageryProcessedDate

object (Date)

इस इमेज की प्रोसेसिंग कब पूरी हुई.
dsmUrl

string

इस क्षेत्र के डीएसएम (डिजिटल सरफ़ेस मॉडल) की इमेज का यूआरएल. वैल्यू, EGM96 जियोइड (यानी कि समुद्र तल) से मीटर में ऊपर की ओर होती हैं. अमान्य जगहों (जहां हमारे पास डेटा नहीं है) को -9999 के तौर पर सेव किया जाता है.
rgbUrl

string

इलाके के आरजीबी डेटा (प्लेन या सैटलाइट से ली गई फ़ोटो) की इमेज का यूआरएल.
maskUrl

string

बिल्डिंग मास्क इमेज का यूआरएल: हर पिक्सल के लिए एक बिट, जिससे यह पता चलता है कि उस पिक्सल को छत का हिस्सा माना जाता है या नहीं.
annualFluxUrl

string

इलाके के सालाना फ़्लक्स मैप (छतों पर पड़ने वाली सालाना धूप) का यूआरएल. वैल्यू, kWh/kW/साल के हिसाब से होती हैं. यह अनमास्क किया गया फ़्लक्स है: फ़्लक्स का हिसाब हर जगह के लिए लगाया जाता है, न कि सिर्फ़ इमारतों की छतों के लिए. अमान्य जगहों की जानकारी को -9999 के तौर पर सेव किया जाता है: जिन जगहों पर हमारी सेवा उपलब्ध नहीं है उन्हें अमान्य माना जाएगा. साथ ही, जिन जगहों पर हमारी सेवा उपलब्ध है लेकिन हम फ़्लक्स का हिसाब नहीं लगा पाए हैं उन्हें भी अमान्य माना जाएगा.
monthlyFluxUrl

string

क्षेत्र के लिए, हर महीने के फ़्लक्स मैप का यूआरएल. इसमें हर महीने के हिसाब से, छतों पर पड़ने वाली धूप की जानकारी होती है. वैल्यू, kWh/kW/साल के हिसाब से होती हैं. इस यूआरएल से जुड़ी GeoTIFF फ़ाइल में 12 बैंड होंगे. ये बैंड, जनवरी से लेकर दिसंबर तक के डेटा के हिसाब से क्रम में होंगे.
hourlyShadeUrls[]

string

हर घंटे के हिसाब से छाया की जानकारी देने वाले 12 यूआरएल. ये यूआरएल, जनवरी से दिसंबर तक के हिसाब से क्रम में होने चाहिए. हर GeoTIFF में 24 बैंड होंगे. ये दिन के 24 घंटों के हिसाब से होंगे. हर पिक्सल, 32 बिट का पूर्णांक होता है. यह उस महीने के (ज़्यादा से ज़्यादा) 31 दिनों के हिसाब से होता है. 1 बिट का मतलब है कि उस जगह पर, उस दिन, उस घंटे, और उस महीने में सूरज दिख रहा है. अमान्य जगहों को -9999 के तौर पर सेव किया जाता है. यह नेगेटिव वैल्यू है, इसलिए इसका 31वां बिट सेट है. साथ ही, किसी भी मान्य वैल्यू का 31वां बिट सेट नहीं हो सकता, क्योंकि यह महीने के 32वें दिन के हिसाब से होगा.

उदाहरण से मदद मिल सकती है. अगर आपको यह जानना है कि 22 जून को शाम 4 बजे, किसी पॉइंट (पिक्सेल की जगह (x, y) पर) पर सूरज की रोशनी पड़ी थी या नहीं, तो आपको यह करना होगा:

  1. इस सूची में मौजूद छठे यूआरएल (जून के हिसाब से) को फ़ेच करें.
  2. शाम 4 बजे के हिसाब से 17वां चैनल ढूंढो.
  3. (x, y) पर मौजूद 32-बिट वैल्यू को पढ़ता है.
  4. वैल्यू का 21वां बिट पढ़ें (यह महीने की 22वीं तारीख से जुड़ा है).
  5. अगर वह बिट 1 है, तो इसका मतलब है कि उस जगह पर 22 जून को शाम 4 बजे सूरज की रोशनी पड़ी थी.

अधिक औपचारिक रूप से: month (1-12), day (1...माह अधिकतम; फरवरी में 28 दिन होते हैं) और hour (0-23) दिए गए हैं, उस महीने/दिन/घंटे के लिए (x, y) स्थिति पर छाया/सूर्य बिट है

(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))

यहां (x, y) का मतलब स्पेस के हिसाब से इंडेक्सिंग करना है, [month - 1] का मतलब month - 1वें यूआरएल (शून्य से इंडेक्सिंग) को फ़ेच करना है, और [hour] का मतलब चैनलों में इंडेक्सिंग करना है. साथ ही, शून्य के अलावा कोई भी नतीजा "धूप" को दिखाता है. इसमें कोई लीप डे नहीं होता और न ही डीएसटी होता है (सभी दिन 24 घंटे के होते हैं; दोपहर हमेशा "स्टैंडर्ड टाइम" के हिसाब से होती है).
imageryQuality

enum (ImageryQuality)

नतीजे में मौजूद इमेज की क्वालिटी.

तारीख

यह पूरी या कुछ समय की कैलेंडर तारीख को दिखाता है. जैसे, जन्मदिन. दिन के समय और टाइम ज़ोन की जानकारी, कहीं और दी गई है या यह जानकारी ज़रूरी नहीं है. यह तारीख, ग्रेगोरियन कैलेंडर के हिसाब से होती है. यह इनमें से किसी एक को दिखा सकता है:

  • पूरी तारीख, जिसमें साल, महीने, और दिन की वैल्यू शून्य नहीं होनी चाहिए.
  • महीना और दिन, जिसमें साल शून्य होता है. उदाहरण के लिए, सालगिरह.
  • सिर्फ़ साल, जिसमें महीने और दिन की वैल्यू शून्य होती है.
  • साल और महीना, जिसमें दिन की वैल्यू शून्य होती है. उदाहरण के लिए, क्रेडिट कार्ड के खत्म होने की तारीख.

मिलते-जुलते टाइप:

JSON के काेड में दिखाना 
{
  "year": integer,
  "month": integer,
  "day": integer
}
फ़ील्ड
year

integer

तारीख का साल. यह 1 से 9999 के बीच होना चाहिए. साल के बिना तारीख तय करने के लिए, इसे 0 पर सेट करें.
month

integer

साल का महीना. यह वैल्यू 1 से 12 के बीच होनी चाहिए. अगर आपको महीने और दिन के बिना साल की जानकारी देनी है, तो इसे 0 पर सेट करें.
day

integer

महीने का दिन. यह 1 से 31 के बीच होना चाहिए और साल और महीने के लिए मान्य होना चाहिए. इसके अलावा, इसे 0 पर सेट करके सिर्फ़ साल या साल और महीने की जानकारी दी जा सकती है. ऐसे में, दिन की जानकारी देना ज़रूरी नहीं होता.

ImageryQuality

कुछ एपीआई के नतीजे का हिसाब लगाने के लिए इस्तेमाल की गई इमेज की क्वालिटी.

ध्यान दें: इमेज की क्वालिटी के लेवल से कोई फ़र्क़ नहीं पड़ता. डीएसएम के आउटपुट का रिज़ॉल्यूशन हमेशा 0.1 मीटर/पिक्सल होता है. हर महीने के फ़्लक्स के आउटपुट का रिज़ॉल्यूशन हमेशा 0.5 मीटर/पिक्सल होता है. साथ ही, हर घंटे के शेड के आउटपुट का रिज़ॉल्यूशन हमेशा 1 मीटर/पिक्सल होता है.

Enums
IMAGERY_QUALITY_UNSPECIFIED क्वालिटी के बारे में कोई जानकारी नहीं है.
HIGH सौर ऊर्जा से जुड़ा डेटा, कम ऊंचाई से ली गई हवाई तस्वीरों से लिया जाता है. इसे 0.1 मीटर/पिक्सल पर प्रोसेस किया जाता है.
MEDIUM सोलर डेटा, ऊंचाई से ली गई बेहतर क्वालिटी की तस्वीरों से लिया जाता है. इसे 0.25 मीटर/पिक्सल पर प्रोसेस किया जाता है.
BASE सौर ऊर्जा का डेटा, बेहतर सैटलाइट इमेज से लिया जाता है. इसे 0.25 मीटर/पिक्सल पर प्रोसेस किया जाता है.

तरीके

get

 किसी जगह के आस-पास के इलाके के लिए, सौर ऊर्जा से जुड़ी जानकारी मिलती है.