डेटा लेयर का अनुरोध करना

dataLayers एंडपॉइंट, किसी खास जगह के आस-पास के इलाके में मौजूद सौर ऊर्जा की पूरी जानकारी देता है. एंडपॉइंट, डाउनलोड की जा सकने वाली 17 TIFF फ़ाइलें दिखाता है, जिनमें ये शामिल हैं:

  • डिजिटल सरफ़ेस मॉडल (DSM)
  • आरजीबी कंपोज़िट लेयर (एरियल इमेजरी)
  • विश्लेषण की सीमाओं की पहचान करने वाली मास्क लेयर
  • सालाना सोलर फ़्लक्स या किसी सरफ़ेस से होने वाली सालाना फ़ायदा
  • हर महीने के हिसाब से सोलर फ़्लक्स या किसी सरफ़ेस का हर महीने मिलने वाला असर
  • हर घंटे के हिसाब से शेड (24 घंटे)

सोलर एपीआई के फ़्लक्स का मतलब क्या है, इस बारे में ज़्यादा जानने के लिए, Solar API Concepts देखें.

डेटा लेयर के अनुरोधों के बारे में जानकारी

यहां दिए गए उदाहरण में, dataLayers तरीके से किए गए REST अनुरोध का यूआरएल दिखाया गया है:

https://solar.googleapis.com/v1/dataLayers:get?parameters

अनुरोध के लिए यूआरएल के पैरामीटर शामिल करें, जिनसे यह जानकारी मिलती है:

  • जगह के अक्षांश और देशांतर निर्देशांक
  • जगह के आस-पास के इलाके का दायरा
  • वापस किए जाने वाले डेटा का सबसेट (DSM, RGB, मास्क, सालाना फ़्लक्स या महीने का फ़्लक्स)
  • नतीजों में दिखाई जाने वाली कम से कम क्वालिटी
  • दिखाए जाने वाले डेटा का कम से कम स्केल, मीटर प्रति पिक्सल में

डेटा लेयर के अनुरोध का उदाहरण

नीचे दिए गए उदाहरण में, अक्षांश = 37.4450 और देशांतर = -122.1390 के निर्देशांकों पर, जगह के लिए 100 मीटर के दायरे में इमारत की अहम जानकारी की सभी जानकारी का अनुरोध किया गया है:

Chronicle API (एपीआई) कुंजी

रिस्पॉन्स में यूआरएल का अनुरोध करने के लिए, अपनी एपीआई कुंजी को यूआरएल में जोड़ें:

curl -X GET "https://solar.googleapis.com/v1/dataLayers:get?location.latitude=37.4450&location.longitude=-122.1390&radiusMeters=100&view=FULL_LAYERS&requiredQuality=HIGH&pixelSizeMeters=0.5&key=YOUR_API_KEY"

आपके पास एचटीटीपी अनुरोध करने का भी विकल्प है. इसके लिए, यूआरएल को cURL अनुरोध में अपने ब्राउज़र के यूआरएल बार में चिपकाएं. एपीआई पासकोड को पास करने से, आपको इस्तेमाल और विश्लेषण की बेहतर सुविधाएं मिलती हैं. साथ ही, रिस्पॉन्स डेटा को बेहतर तरीके से कंट्रोल किया जा सकता है.

OAuth टोकन

ध्यान दें: यह फ़ॉर्मैट सिर्फ़ टेस्टिंग एनवायरमेंट के लिए है. ज़्यादा जानकारी के लिए, OAuth का इस्तेमाल करना देखें.

जवाब में यूआरएल का अनुरोध करने के लिए, अपने बिलिंग प्रोजेक्ट का नाम और अपना OAuth टोकन पास करें:

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "X-Goog-User-Project: PROJECT_NUMBER_OR_ID" \
  "https://solar.googleapis.com/v1/dataLayers:get?location.latitude=37.4450&location.longitude=-122.1390&radius_meters=100&required_quality=HIGH"
        

एपीआई इस फ़ॉर्मैट में यूआरएल दिखाता है:

https://solar.googleapis.com/v1/solar/geoTiff:get?id=HASHED_ID

रिस्पॉन्स का उदाहरण

अनुरोध करने पर, इस फ़ॉर्म में JSON रिस्पॉन्स जनरेट होता है:

{
  "imageryDate": {
    "year": 2019,
    "month": 7,
    "day": 9
  },
  "imageryProcessedDate": {
    "year": 2022,
    "month": 3,
    "day": 21
  },
  "dsmUrl": "https://solar.googleapis.com/v1/geoTiff:get?id=14f82e6931a8c33fc31ab8378e51804a-852f4ca7f056addda5b8fcb93e02c2fd",
  "rgbUrl": "https://solar.googleapis.com/v1/geoTiff:get?id=bf769c43d72eb85493b20df583bc0c95-d13126638efaa89e44951abc8664d6a3",
  "maskUrl": "https://solar.googleapis.com/v1/geoTiff:get?id=ed089240efc78e417c96a945460830ef-e666758b7cc183f82d1c7b7a891f858b",
  "annualFluxUrl": "https://solar.googleapis.com/v1/geoTiff:get?id=aaa2637073d62cc7331d067eb7080bbe-f94eab79915f66759f5265b2ff8b1ad4",
  "monthlyFluxUrl": "https://solar.googleapis.com/v1/geoTiff:get?id=d1608d342a3d0393b5decd063d330271-2a2e27504a2009cad1f1f3d2b471bcd3",
  "hourlyShadeUrls": [
    "https://solar.googleapis.com/v1/geoTiff:get?id=541c2f32b936f190f7562309ea1d60fc-432bf94bcd0dc918f0c828d07aa00e7c",
    "https://solar.googleapis.com/v1/geoTiff:get?id=4eb7a0b9c0f34e0e746816d0f3085274-4794b9eb35ab18ad4fbe2c3ee59f151d",
    ...
  ],
  "imageryQuality": "HIGH"
}

जवाब का डेटा ऐक्सेस करें

रिस्पॉन्स यूआरएल से डेटा को ऐक्सेस करने के लिए, पुष्टि करने के अतिरिक्त तरीके की ज़रूरत होती है. अगर पुष्टि करने वाली कुंजी का इस्तेमाल किया जाता है, तो आपको अपनी एपीआई कुंजी को यूआरएल से जोड़ना होगा. अगर OAuth की पुष्टि करने की सुविधा का इस्तेमाल किया जाता है, तो आपको OAuth हेडर जोड़ने होंगे.

Chronicle API (एपीआई) कुंजी

रिस्पॉन्स में यूआरएल का अनुरोध करने के लिए, अपनी एपीआई कुंजी को यूआरएल में जोड़ें:

curl -X GET "https://solar.googleapis.com/v1/solar/geoTiff:get?id=fbde33e9cd16d5fd10d19a19dc580bc1-8614f599c5c264553f821cd034d5cf32&key=YOUR_API_KEY"

आपके पास एचटीटीपी अनुरोध करने का भी विकल्प है. इसके लिए, यूआरएल को cURL अनुरोध में अपने ब्राउज़र के यूआरएल बार में चिपकाएं. एपीआई पासकोड को पास करने से, आपको इस्तेमाल और विश्लेषण की बेहतर सुविधाएं मिलती हैं. साथ ही, रिस्पॉन्स डेटा को बेहतर तरीके से कंट्रोल किया जा सकता है.

OAuth टोकन

जवाब में यूआरएल का अनुरोध करने के लिए, अपने बिलिंग प्रोजेक्ट का नाम और अपना OAuth टोकन पास करें:

curl -X GET \
-H 'X-Goog-User-Project: PROJECT_NUMBER_OR_ID' \
-H "Authorization: Bearer $TOKEN" \
"https://solar.googleapis.com/v1/solar/geoTiff:get?id=fbde33e9cd16d5fd10d19a19dc580bc1-8614f599c5c264553f821cd034d5cf32"
        

आरजीबी लेयर के अपवाद के अलावा, सभी TIFF फ़ाइलें इमेज व्यूअर ऐप्लिकेशन में खाली इमेज के रूप में दिखाई देंगी. डाउनलोड की गई TIFF फ़ाइलें देखने के लिए, उन्हें QGIS जैसे मैपिंग ऐप्लिकेशन सॉफ़्टवेयर में इंपोर्ट करें.

इस अनुरोध और उसके जवाब की पूरी जानकारी रेफ़रंस दस्तावेज़ में दी गई है.