REST Resource: dataLayers

संसाधन: Datalayers

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

इलाके के 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. 32-बिट वैल्यू को (x, y) पर पढ़ें.
  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

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

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

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

तरीके

get

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