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 के उन एक्सपेरिमेंट के बारे में बताता है जिन्हें चालू करना है. इस फ़ील्ड का इस्तेमाल करने वाले अनुरोधों को, Google Maps Platform की सेवा से जुड़ी खास शर्तों के तहत, Pre-GA ऑफ़र के तौर पर क्लासिफ़ाई किया जाता है. ज़्यादा जानकारी के लिए, [लॉन्च स्टेज के बारे में जानकारी]( https://cloud.google.com/maps-platform/terms/launch-stages) देखें.

अनुरोध का मुख्य हिस्सा

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

जवाब का मुख्य भाग

कामयाब रहने पर, जवाब के मुख्य हिस्से में 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 सारा डेटा पाएं.