Method: dataLayers.get

اطلاعات خورشیدی را برای منطقه اطراف یک مکان دریافت می‌کند. اگر مکان خارج از منطقه پوشش باشد، خطایی با کد NOT_FOUND برمی‌گرداند.

درخواست HTTP

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

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

پارامترهای پرس و جو

پارامترها
location

object ( LatLng )

الزامی. طول و عرض جغرافیایی مرکز منطقه برای دریافت داده‌ها.

radiusMeters

number

الزامی. شعاع، بر حسب متر، که ناحیه اطراف نقطه مرکزی را که داده‌ها باید برای آن بازگردانده شوند، تعریف می‌کند. محدودیت‌های این مقدار عبارتند از:

  • هر مقداری تا ۱۰۰ متر را می‌توان همیشه مشخص کرد.
  • مقادیر بالای ۱۰۰ متر را می‌توان مشخص کرد، به شرطی که radiusMeters <= pixelSizeMeters * 1000 .
  • با این حال، برای مقادیر بیش از ۱۷۵ متر، DataLayerView در درخواست نباید شامل شار ماهانه یا سایه ساعتی باشد.
view

enum ( DataLayerView )

اختیاری. زیرمجموعه‌ی مورد نظر از داده‌ها برای بازگشت.

requiredQuality

enum ( ImageryQuality )

اختیاری. حداقل سطح کیفیت مجاز در نتایج. هیچ نتیجه‌ای با کیفیت پایین‌تر از این بازگردانده نخواهد شد. عدم مشخص کردن این مورد معادل محدود کردن فقط به کیفیت بالا است.

pixelSizeMeters

number

اختیاری. حداقل مقیاس، بر حسب متر در هر پیکسل، برای داده‌هایی که باید بازگردانده شوند. مقادیر 0.1 (پیش‌فرض، اگر این فیلد به صراحت تنظیم نشده باشد)، 0.25، 0.5 و 1.0 پشتیبانی می‌شوند. اجزای تصویری که وضوح عادی آنها کمتر از pixelSizeMeters است، با وضوح مشخص شده توسط pixelSizeMeters بازگردانده می‌شوند؛ اجزای تصویری که وضوح عادی آنها برابر یا بزرگتر از pixelSizeMeters است، با آن وضوح عادی بازگردانده می‌شوند.

exactQualityRequired

boolean

اختیاری. اینکه آیا کیفیت دقیق تصویر مورد نیاز باشد یا خیر. اگر روی false تنظیم شود، فیلد requiredQuality به عنوان حداقل کیفیت مورد نیاز تفسیر می‌شود، به طوری که اگر requiredQuality روی MEDIUM تنظیم شود، ممکن است تصاویر با کیفیت بالا بازگردانده شوند. اگر روی true تنظیم شود، requiredQuality به عنوان کیفیت دقیق مورد نیاز تفسیر می‌شود و اگر requiredQuality روی MEDIUM تنظیم شود، فقط تصاویر با کیفیت MEDIUM ​​بازگردانده می‌شوند.

experiments[]

enum ( Experiment )

اختیاری. آزمایش‌های پیش از GA را برای فعال‌سازی مشخص می‌کند. درخواست‌هایی که از این فیلد استفاده می‌کنند، به عنوان یک پیشنهاد پیش از GA تحت شرایط خاص سرویس پلتفرم نقشه‌های گوگل طبقه‌بندی می‌شوند. برای جزئیات بیشتر به [توضیحات مرحله راه‌اندازی]( https://cloud.google.com/maps-platform/terms/launch-stages ) مراجعه کنید.

درخواست بدنه

بدنه درخواست باید خالی باشد.

بدنه پاسخ

در صورت موفقیت، بدنه پاسخ شامل نمونه‌ای از DataLayers است.

دامنه‌های مجوز

به محدوده OAuth زیر نیاز دارد:

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

نمای لایه داده

چه زیرمجموعه‌ای از اطلاعات خورشیدی را باید برگرداند.

انوم‌ها
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 تمام داده‌ها را دریافت کنید.