Method: lookupWeather

شرایط آب‌وهوایی را در مکانی جستجو کنید.

درخواست HTTP

POST https://mapstools.googleapis.com/v1alpha:lookupWeather

این نشانی وب از نحو تراتبدیل gRPC استفاده می‌کند.

متن درخواست

بدنه درخواست حاوی داده‌هایی با ساختار زیر است:

نمایش JSON 
{
  "unitsSystem": enum (UnitsSystem),
  "location": {
    object (Location)
  },
  "capabilities": [
    enum (Capability)
  ],
  "date": {
    object (Date)
  },
  "hour": integer,
  "languageCode": string,
  "weatherOptions": {
    object (WeatherOptions)
  },
  "airQualityOptions": {
    object (AirQualityOptions)
  }
}
فیلدها
unitsSystem

enum (UnitsSystem)

اختیاری. سیستم واحدهایی که برای شرایط آب‌وهوایی برگردانده‌شده استفاده می‌شود. اگر ارائه نشود، شرایط آب‌وهوایی برگردانده‌شده در سیستم متریک خواهد بود (پیش‌فرض = METRIC).
location

object (Location)

الزامی. مکانی که می‌خواهید وضعیت آب‌وهوای آن را دریافت کنید.
capabilities[]

enum (Capability)

اختیاری. قابلیت‌های محیطی که باید در پاسخ گنجانده شود.
date

object (Date)

اختیاری. تاریخ اطلاعات محیطی درخواست‌شده را نسبت به منطقه زمانی محلی مکان مشخص‌شده در فیلد location مشخص می‌کند. محدوده تاریخ پشتیبانی‌شده به قابلیت‌های درخواست‌شده بستگی دارد: - WEATHER: تا ۲۴ ساعت در گذشته (وقتی hour نیز تنظیم شده باشد) و تا ۱۰ روز (۲۴۰ ساعت) در آینده (از امروز تا ۹ روز آینده برای پیش‌بینی‌های روزانه). - AIR_QUALITY: تا ۳۰ روز (۷۲۰ ساعت) در گذشته و تا ۴ روز (۹۶ ساعت) در آینده. - POLLEN: از امروز تا ۴ روز آینده (تا ۵ روز شامل امروز؛ تاریخ‌های گذشته پشتیبانی نمی‌شود).
hour

integer

اختیاری. ساعت اطلاعات زیست‌محیطی درخواست‌شده را در قالب ۲۴ ساعته (۰-۲۳) نسبت به منطقه زمانی محلی مکان مشخص‌شده در فیلد location مشخص می‌کند. date باید مشخص شود. محدوده‌های ساعتی پشتیبانی‌شده به قابلیت‌های درخواست‌شده بستگی دارد: - WEATHER: تا ۲۴ ساعت در گذشته و تا ۲۴۰ ساعت (۱۰ روز) در آینده. - AIR_QUALITY: تا ۳۰ روز (۷۲۰ ساعت) در گذشته و تا ۴ روز (۹۶ ساعت) در آینده. - POLLEN: فقط پیش‌بینی‌های روزانه را برمی‌گرداند؛ hour برای گرده گل نادیده گرفته می‌شود.
languageCode

string

اختیاری. کد زبان BCP-47 برای نوشتار بومی‌سازی‌شده در پاسخ (مثلاً «en»،‏ «ja»،‏ «fr-CA»). اگر مشخص نشده باشد، به‌طور پیش‌فرض روی «en» تنظیم می‌شود.
weatherOptions

object (WeatherOptions)

اختیاری. گزینه‌های مختص درخواست‌های آب‌وهوا. weatherOptions.units_system به‌همراه unitsSystem سطح بالا (برچسب ۴) پشتیبانی می‌شود تا سازگاری با نسخه‌های قدیمی برای تماس‌گیرندگان موجود حفظ شود؛ اگر هر دو سیستم‌های واحد متناقضی را مشخص کنند، INVALID_ARGUMENT برمی‌گرداند. اگر WEATHER در capabilities درخواست نشده باشد، نادیده گرفته می‌شود.
airQualityOptions

object (AirQualityOptions)

اختیاری. گزینه‌های مختص درخواست‌های کیفیت هوا. اگر AIR_QUALITY در capabilities درخواست نشده باشد، نادیده گرفته می‌شود.

بدنه پاسخ

اگر موفقیت‌آمیز باشد، بدنه پاسخ حاوی نمونه‌ای از LookupWeatherResponse است.

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

به گستره OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/maps-platform.mapstools