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 को 'मीडियम' पर सेट करने पर, अच्छी क्वालिटी की इमेज दिख सकती हैं. अगर इसकी वैल्यू 'सही है' पर सेट है, तो requiredQuality को ज़रूरी क्वालिटी के तौर पर समझा जाता है. साथ ही, अगर requiredQuality को MEDIUM पर सेट किया जाता है, तो सिर्फ़ MEDIUM क्वालिटी की इमेज दिखती है.
experiments[]

enum (Experiment)

ज़रूरी नहीं. उन Pre-GA एक्सपेरिमेंट के बारे में बताता है जिन्हें चालू करना है.

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

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

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

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

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

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

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

DataLayerView

सूरज की जानकारी का कौनसा सबसेट दिखाना है.

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