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/year में होती हैं. यह बिना छिपे फ़्लक्स है: फ़्लक्स का हिसाब सिर्फ़ इमारत की छतों के लिए नहीं, बल्कि हर जगह के लिए लगाया जाता है. अमान्य जगहों को -9999 के तौर पर सेव किया जाता है: कवरेज वाले इलाके से बाहर की जगहें अमान्य होंगी. साथ ही, कवरेज वाले इलाके में भी कुछ ऐसी जगहें होंगी जहां हम फ़्लक्स का हिसाब नहीं लगा पाएंगे.
monthlyFluxUrl

string

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

string

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

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

  1. इस सूची में जून का छठा यूआरएल फ़ेच करें.
  2. 17वां चैनल देखें (यह चैनल शाम 4 बजे के हिसाब से है).
  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 मीटर/पिक्सल पर प्रोसेस किया जाता है.

ध्यान दें: यह वैल्यू सिर्फ़ तब उपलब्ध होती है, जब अनुरोध में experiments=EXPANDED_COVERAGE सेट हो. ज़्यादा जानकारी के लिए, बड़ी हुई कवरेज लेख पढ़ें.

तरीके

get

 किसी जगह के आस-पास के इलाके के लिए, सोलर एनर्जी की जानकारी पाता है.