একটি ডেটা স্তর অনুরোধ করুন

ডেটালেয়ার এন্ডপয়েন্ট একটি নির্দিষ্ট অবস্থানের আশেপাশের একটি অঞ্চলের জন্য বিশদ সৌর তথ্য প্রদান করে। এন্ডপয়েন্ট 17টি ডাউনলোডযোগ্য TIFF ফাইল প্রদান করে, যার মধ্যে রয়েছে:

  • ডিজিটাল সারফেস মডেল (DSM)
  • RGB যৌগিক স্তর (বায়বীয় চিত্র)
  • একটি মুখোশ স্তর যা বিশ্লেষণের সীমানা চিহ্নিত করে
  • বার্ষিক সৌর প্রবাহ, বা প্রদত্ত পৃষ্ঠের বার্ষিক ফলন
  • মাসিক সৌর প্রবাহ, বা প্রদত্ত পৃষ্ঠের মাসিক ফলন
  • প্রতি ঘন্টায় ছায়া (24 ঘন্টা)

সোলার এপিআই কীভাবে ফ্লাক্সকে সংজ্ঞায়িত করে সে সম্পর্কে আরও তথ্যের জন্য, সোলার এপিআই ধারণাগুলি দেখুন।

তথ্য স্তর অনুরোধ সম্পর্কে

নিম্নলিখিত উদাহরণটি dataLayers পদ্ধতিতে একটি REST অনুরোধের URL দেখায়:

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

আপনার অনুরোধের URL প্যারামিটারগুলি অন্তর্ভুক্ত করুন যা নিম্নলিখিতগুলি নির্দিষ্ট করে:

  • অবস্থানের অক্ষাংশ এবং দ্রাঘিমাংশ স্থানাঙ্ক
  • অবস্থানের পার্শ্ববর্তী অঞ্চলের ব্যাসার্ধ
  • ফেরত দেওয়ার জন্য ডেটার উপসেট (DSM, RGB, মাস্ক, বার্ষিক ফ্লাক্স, বা মাসিক ফ্লাক্স)
  • ফলাফলে অনুমোদিত ন্যূনতম গুণমান
  • প্রতি পিক্সেলে মিটারে ডেটার ন্যূনতম স্কেল

উদাহরণ ডেটা স্তর অনুরোধ

নিম্নলিখিত উদাহরণটি অক্ষাংশ = 37.4450 এবং দ্রাঘিমাংশ = -122.1390 ​​এর স্থানাঙ্কে অবস্থানের জন্য 100 মিটার ব্যাসার্ধে সমস্ত বিল্ডিং অন্তর্দৃষ্টি তথ্যের জন্য অনুরোধ করে:

API কী

প্রতিক্রিয়াতে URL-এ একটি অনুরোধ করতে, URL-এ আপনার 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"

এছাড়াও আপনি আপনার ব্রাউজারের URL বারে cURL অনুরোধে URL পেস্ট করে HTTP অনুরোধ করতে পারেন। API কী পাস করা আপনাকে আরও ভাল ব্যবহার এবং বিশ্লেষণ ক্ষমতা এবং প্রতিক্রিয়া ডেটাতে আরও ভাল অ্যাক্সেস নিয়ন্ত্রণ সরবরাহ করে।

OAuth টোকেন

দ্রষ্টব্য: এই বিন্যাসটি শুধুমাত্র পরীক্ষার পরিবেশের জন্য। আরও তথ্যের জন্য, OAuth ব্যবহার করুন দেখুন।

উত্তরে URL-এ একটি অনুরোধ করতে, আপনার বিলিং প্রকল্পের নাম এবং আপনার 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"
        

API নিম্নলিখিত বিন্যাসে ইউআরএল প্রদান করে:

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"
}

প্রতিক্রিয়া ডেটা অ্যাক্সেস করুন

প্রতিক্রিয়া URL-এর মাধ্যমে ডেটা অ্যাক্সেস করার জন্য অতিরিক্ত প্রমাণীকরণ প্রয়োজন। আপনি যদি একটি প্রমাণীকরণ কী ব্যবহার করেন, তাহলে আপনাকে অবশ্যই URL-এ আপনার API কী যুক্ত করতে হবে। আপনি যদি OAuth প্রমাণীকরণ ব্যবহার করেন, তাহলে আপনাকে অবশ্যই OAuth শিরোনাম যোগ করতে হবে।

API কী

প্রতিক্রিয়াতে URL-এ একটি অনুরোধ করতে, URL-এ আপনার API কী যুক্ত করুন:

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

এছাড়াও আপনি আপনার ব্রাউজারের URL বারে cURL অনুরোধে URL পেস্ট করে HTTP অনুরোধ করতে পারেন। API কী পাস করা আপনাকে আরও ভাল ব্যবহার এবং বিশ্লেষণ ক্ষমতা এবং প্রতিক্রিয়া ডেটাতে আরও ভাল অ্যাক্সেস নিয়ন্ত্রণ সরবরাহ করে।

OAuth টোকেন

উত্তরে URL-এ একটি অনুরোধ করতে, আপনার বিলিং প্রকল্পের নাম এবং আপনার 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"
        

RGB লেয়ার বাদে, সমস্ত TIFF ফাইল ইমেজ ভিউয়ার অ্যাপ্লিকেশনে ফাঁকা ছবি হিসেবে প্রদর্শিত হবে। ডাউনলোড করা TIFF ফাইলগুলি দেখতে, সেগুলিকে একটি ম্যাপিং অ্যাপ্লিকেশন সফ্টওয়্যারে আমদানি করুন, যেমন QGIS৷

এই অনুরোধ এবং প্রতিক্রিয়ার সম্পূর্ণ স্পেসিফিকেশন রেফারেন্স ডকুমেন্টেশনে রয়েছে।