Method: dataLayers.get

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

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

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

پارامترها
location

object ( LatLng )

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

radius Meters

number

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

  • هر مقدار تا 100 متر همیشه می تواند مشخص شود.
  • تا زمانی که radiusMeters <= pixelSizeMeters * 1000 می توان مقادیر بیش از 100 متر را مشخص کرد.
  • با این حال، برای مقادیر بیش از 175 متر، DataLayerView در درخواست نباید شامل شار ماهانه یا سایه ساعتی باشد.
view

enum ( DataLayerView )

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

required Quality

enum ( ImageryQuality )

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

pixel Size Meters

number

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

exact Quality Required

boolean

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

درخواست بدن

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

بدن پاسخگو

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه ای از 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 همه داده ها را دریافت کنید