Method: dataLayers.get

কোনো একটি অবস্থানের পার্শ্ববর্তী অঞ্চলের সৌর তথ্য সংগ্রহ করে। অবস্থানটি কভারেজ এলাকার বাইরে হলে NOT_FOUND কোডসহ একটি ত্রুটি বার্তা ফেরত দেয়।

HTTP অনুরোধ

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

URL-টিতে gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করা হয়েছে।

কোয়েরি প্যারামিটার

প্যারামিটার
location

object ( LatLng )

প্রয়োজনীয়। যে অঞ্চলের তথ্য সংগ্রহ করতে হবে, তার কেন্দ্রের দ্রাঘিমাংশ ও অক্ষাংশ।

radiusMeters

number

প্রয়োজনীয়। কেন্দ্রবিন্দুটির চারপাশের যে অঞ্চলের ডেটা ফেরত দেওয়া হবে, সেই অঞ্চলের ব্যাসার্ধ (মিটারে)। এই মানের সীমাবদ্ধতাগুলো হলো:

  • ১০০ মিটার পর্যন্ত যেকোনো মান সর্বদা নির্দিষ্ট করা যেতে পারে।
  • ১০০ মিটারের বেশি মানও নির্দিষ্ট করা যেতে পারে, তবে শর্ত হলো radiusMeters <= pixelSizeMeters * 1000 ।
  • তবে, ১৭৫ মিটারের বেশি মানের ক্ষেত্রে, অনুরোধের DataLayerView তে মাসিক ফ্লাক্স বা ঘণ্টাব্যাপী শেড অন্তর্ভুক্ত করা যাবে না।
view

enum ( DataLayerView )

ঐচ্ছিক। ফেরত দেওয়ার জন্য ডেটার কাঙ্ক্ষিত উপসেট।

requiredQuality

enum ( ImageryQuality )

ঐচ্ছিক। ফলাফলে অনুমোদিত সর্বনিম্ন মানের স্তর। এর চেয়ে নিম্নমানের কোনো ফলাফল ফেরত দেওয়া হবে না। এটি উল্লেখ না করা শুধুমাত্র উচ্চ মানের মধ্যে সীমাবদ্ধ রাখার সমতুল্য।

pixelSizeMeters

number

ঐচ্ছিক। ফেরত দেওয়া ডেটার সর্বনিম্ন স্কেল, মিটার প্রতি পিক্সেল এককে। ০.১ (ডিফল্ট, যদি এই ফিল্ডটি স্পষ্টভাবে সেট করা না থাকে), ০.২৫, ০.৫, এবং ১.০ মানগুলো সমর্থিত। যে সকল ইমেজারি কম্পোনেন্টের স্বাভাবিক রেজোলিউশন pixelSizeMeters এর চেয়ে কম, সেগুলোকে pixelSizeMeters দ্বারা নির্দিষ্ট রেজোলিউশনে ফেরত দেওয়া হবে; যে সকল ইমেজারি কম্পোনেন্টের স্বাভাবিক রেজোলিউশন pixelSizeMeters সমান বা তার চেয়ে বেশি, সেগুলোকে সেই স্বাভাবিক রেজোলিউশনেই ফেরত দেওয়া হবে।

exactQualityRequired

boolean

ঐচ্ছিক। ছবির সঠিক গুণমান প্রয়োজন হবে কিনা। যদি 'false' সেট করা হয়, তাহলে ' requiredQuality ফিল্ডটিকে সর্বনিম্ন প্রয়োজনীয় গুণমান হিসেবে গণ্য করা হবে, যার ফলে requiredQuality 'MEDIUM'-এ সেট করা হলেও 'HIGH' গুণমানের ছবি ফেরত দেওয়া হতে পারে। যদি 'true' সেট করা হয়, তাহলে requiredQuality সঠিক প্রয়োজনীয় গুণমান হিসেবে গণ্য করা হবে এবং requiredQuality MEDIUM এ সেট করা হলে শুধুমাত্র MEDIUM গুণমানের ছবিই ফেরত দেওয়া হবে।

experiments[]

enum ( Experiment )

ঐচ্ছিক। কোন প্রি-জিএ এক্সপেরিমেন্টগুলো চালু করতে হবে তা নির্দিষ্ট করে। এই ফিল্ড ব্যবহার করে করা অনুরোধগুলোকে Google Maps Platform Service Specific Terms-এর অধীনে একটি প্রি-জিএ অফারিং হিসেবে শ্রেণীবদ্ধ করা হয়। আরও বিস্তারিত জানতে [লঞ্চ স্টেজের বিবরণ]( https://cloud.google.com/maps-platform/terms/launch-stages ) দেখুন।

অনুরোধকারী শরীর

অনুরোধের মূল অংশ অবশ্যই খালি হতে হবে।

প্রতিক্রিয়া সংস্থা

সফল হলে, রেসপন্স বডিতে DataLayers এর একটি ইনস্ট্যান্স থাকে।

অনুমোদনের পরিধি

নিম্নলিখিত OAuth স্কোপ প্রয়োজন:

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

ডেটালেয়ারভিউ

সৌর তথ্যের কোন উপসেটটি ফেরত দিতে হবে।

এনাম
DATA_LAYER_VIEW_UNSPECIFIED সম্পূর্ণের সমতুল্য।
DSM_LAYER শুধু ডিএসএম-টি নিন।
IMAGERY_LAYERS DSM, RGB এবং মাস্ক সংগ্রহ করুন।
IMAGERY_AND_ANNUAL_FLUX_LAYERS DSM, RGB, মাস্ক এবং বার্ষিক ফ্লাক্স সংগ্রহ করুন।
IMAGERY_AND_ALL_FLUX_LAYERS DSM, RGB, মাস্ক, বার্ষিক ফ্লাক্স এবং মাসিক ফ্লাক্স সংগ্রহ করুন।
FULL_LAYERS সমস্ত ডেটা পান।