REST Resource: dataLayers

संसाधन: Datalayers

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

जेएसओएन के काेड में दिखाना 
{
  "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

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

string

क्षेत्र के आरजीबी डेटा (एरियल फ़ोटो) की इमेज का यूआरएल.
maskUrl

string

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

string

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

string

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

string

हर घंटे के हिसाब से बारह यूआरएल, जनवरी...दिसंबर से मिलते-जुलते क्रम में. हर GeoTIFF में 24 बैंड होंगे, जो दिन के 24 घंटों के बराबर हैं. हर पिक्सल 32 बिट का पूर्णांक होता है और महीने के 31 दिनों के हिसाब से होता है. 1 बिट का मतलब है कि उस जगह से जुड़ी जगह, उस महीने के उसी घंटे में, उस दिन सूरज देख सकती है. अमान्य स्थान -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] का मतलब है कि यूआरएल को किसी चैनल में इंडेक्स किया जा रहा है. साथ ही, फ़ाइनल इंडेक्स का मतलब है "धूप". इसमें कोई लीप दिन नहीं होते और DST मौजूद नहीं होते (सभी दिन 24 घंटे के होते हैं; दोपहर हमेशा "मानक समय" दोपहर होती है).
imageryQuality

enum (ImageryQuality)

नतीजे की तस्वीरों के संग्रह की क्वालिटी.

तारीख

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

  • साल, महीने, और दिन की वैल्यू के अलावा, पूरी तारीख.
  • महीना और दिन, जिसमें कोई साल नहीं हो. उदाहरण के लिए, सालगिरह.
  • अपने-आप में, साल की शुरुआत, जिसमें शून्य महीना और एक शून्य दिन होता है.
  • साल और महीना, जिसमें शून्य दिन हो (उदाहरण के लिए, क्रेडिट कार्ड के खत्म होने की तारीख).

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

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

integer

तारीख का साल. 1 से 9999 के बीच होना चाहिए या बिना साल वाली तारीख बताने के लिए 0 होना चाहिए.
month

integer

साल का महीना. बिना महीना और दिन के किसी साल के बारे में बताने के लिए, यह 1 से 12 के बीच होना चाहिए या 0 होना चाहिए.
day

integer

महीने का दिन. 1 से 31 के बीच होना चाहिए और साल और महीने के लिए मान्य होना चाहिए या खुद में किसी साल या किसी साल और महीने के बारे में बताने के लिए 0 मान्य होना चाहिए, जिसमें दिन अहम नहीं होता है.

ImageryQuality

एपीआई के कुछ नतीजे कैलकुलेट करने के लिए इस्तेमाल की गई तस्वीरों की क्वालिटी.

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

Enums
IMAGERY_QUALITY_UNSPECIFIED किसी क्वालिटी के बारे में कोई जानकारी नहीं है.
HIGH मूल तस्वीरों का संग्रह और DSM डेटा 0.1 मीटर/पिक्सल पर प्रोसेस किया गया था.
MEDIUM मूल तस्वीरों का संग्रह और DSM डेटा 0.25 मीटर/पिक्सल पर प्रोसेस किया गया था.
LOW बुनियादी तस्वीरों का संग्रह और DSM डेटा 0.5 मीटर/पिक्सल पर प्रोसेस किया गया था.

तरीके

get

 किसी जगह के आस-पास के इलाके की सौर ऊर्जा की जानकारी देता है.