Method: dataLayers.get

किसी जगह के आस-पास के इलाके की सौर ऊर्जा की जानकारी देता है. अगर जगह, कवरेज एरिया से बाहर है, तो NOT_FOUND कोड के साथ गड़बड़ी दिखाता है.

एचटीटीपी अनुरोध

GET https://solar.googleapis.com/v1/dataLayers:get

यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

क्वेरी पैरामीटर

पैरामीटर
location

object (LatLng)

ज़रूरी है. क्षेत्र के केंद्र का देशांतर और अक्षांश, जिसके लिए डेटा पाना है.

radiusMeters

number

ज़रूरी है. त्रिज्या, मीटर में, उस केंद्र बिंदु के आस-पास के क्षेत्र को परिभाषित करता है जिसके लिए डेटा दिया जाना चाहिए. इस वैल्यू की सीमाएं यहां दी गई हैं:

  • 100 मीटर तक की कोई भी वैल्यू कभी भी दी जा सकती है.
  • 100 मीटर से ज़्यादा की वैल्यू सबमिट की जा सकती है. हालांकि, इसके लिए ज़रूरी है कि radiusMeters <= pixelSizeMeters * 1000 हो.
  • हालांकि, 175 मीटर से ज़्यादा वैल्यू के लिए, अनुरोध में मौजूद DataLayerView में हर महीने का फ़्लक्स या हर घंटे का शेड शामिल नहीं होना चाहिए.
view

enum (DataLayerView)

ज़रूरी नहीं. वापस किए जाने वाले डेटा का मनचाहा सबसेट.

requiredQuality

enum (ImageryQuality)

ज़रूरी नहीं. परिणामों में दिखाई जाने वाली कम से कम क्वालिटी लेवल. इससे कम क्वालिटी वाला कोई नतीजा नहीं दिखाया जाएगा. इसे तय नहीं करना, सिर्फ़ हाई क्वालिटी तक सीमित रखने के बराबर है.

pixelSizeMeters

number

ज़रूरी नहीं. दिखाए जाने वाले डेटा का कम से कम स्केल, मीटर प्रति पिक्सल में. 0.1 (डिफ़ॉल्ट, अगर यह फ़ील्ड साफ़ तौर पर सेट नहीं किया गया है), 0.25, 0.5, और 1.0 की वैल्यू इस्तेमाल की जा सकती हैं. जिन तस्वीरों का सामान्य रिज़ॉल्यूशन pixelSizeMeters से कम है उन्हें pixelSizeMeters के तय किए गए रिज़ॉल्यूशन पर दिखाया जाएगा. साथ ही, जिन तस्वीरों का सामान्य रिज़ॉल्यूशन pixelSizeMeters के बराबर या इससे ज़्यादा होता है उन्हें सामान्य रिज़ॉल्यूशन में ही दिखाया जाता है.

exactQualityRequired

boolean

ज़रूरी नहीं. तस्वीरों के संग्रह की सटीक क्वालिटी की ज़रूरत है या नहीं. अगर 'गलत है' पर सेट किया जाता है, तो requiredQuality फ़ील्ड को सबसे कम ज़रूरी क्वालिटी माना जाता है. जैसे, requiredQuality को MEDIUM पर सेट करने पर अच्छी क्वालिटी की इमेज दिख सकती है. अगर इस नीति को 'सही है' पर सेट किया जाता है, तो requiredQuality को सटीक क्वालिटी के तौर पर माना जाता है. साथ ही, अगर requiredQuality को MEDIUM पर सेट किया जाता है, तो सिर्फ़ MEDIUM क्वालिटी की इमेज दिखाई जाती है.

अनुरोध का मुख्य भाग

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

जवाब का मुख्य हिस्सा

कामयाब रहने पर, जवाब के मुख्य हिस्से में DataLayers का एक इंस्टेंस शामिल किया जाता है.

अनुमति के दायरे

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/cloud-platform

DataLayerView

सौर ऊर्जा के किस सबसेट को दिखाना है.

Enums
DATA_LAYER_VIEW_UNSPECIFIED FULL के बराबर.
DSM_LAYER केवल DSM पाएं.
IMAGERY_LAYERS DSM, RGB, और मास्क पाएं.
IMAGERY_AND_ANNUAL_FLUX_LAYERS DSM, RGB, मास्क, और सालाना फ़्लक्स पाएं.
IMAGERY_AND_ALL_FLUX_LAYERS DSM, RGB, मास्क, सालाना फ़्लक्स, और मासिक फ़्लक्स पाएं.
FULL_LAYERS सभी डेटा पाएं.