Method: forecast.hours.lookup

پیش‌بینی‌های ساعتی تا ۲۴۰ ساعت را در یک مکان مشخص، از ساعت فعلی شروع می‌کند، برمی‌گرداند.

درخواست HTTP

GET https://weather.googleapis.com/v1/forecast/hours:lookup

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

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

پارامترها
location

object ( LatLng )

الزامی. مکانی که قرار است پیش‌بینی ساعتی آن را دریافت کنید.

unitsSystem

enum ( UnitsSystem )

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

pageSize

integer

اختیاری. حداکثر تعداد رکوردهای پیش‌بینی ساعتی که در هر صفحه برگردانده می‌شوند - مقداری از ۱ تا ۲۴ (شامل). مقدار پیش‌فرض، حداکثر مقدار مجاز ۲۴ است.

pageToken

string

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

hours

integer

اختیاری. تعداد کل ساعاتی که از ساعت فعلی قابل واکشی هستند را محدود می‌کند - مقداری از ۱ تا ۲۴۰ (شامل). مقدار پیش‌فرض، حداکثر مقدار مجاز ۲۴۰ است.

languageCode

string

اختیاری. به کلاینت اجازه می‌دهد زبان پاسخ را انتخاب کند. اگر داده‌ها برای آن زبان ارائه نشوند، API از نزدیکترین مورد منطبق استفاده می‌کند. مقادیر مجاز بر اساس استاندارد IETF BCP-47 هستند. مقدار پیش‌فرض "en" است.

درخواست بدنه

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

بدنه پاسخ

پاسخ برای hours.lookup RPC.

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

نمایش JSON 
{
  "forecastHours": [
    {
      object (ForecastHour)
    }
  ],
  "timeZone": {
    object (TimeZone)
  },
  "nextPageToken": string
}
فیلدها
forecastHours[]

object ( ForecastHour )

پیش‌بینی ساعتی، بر اساس تعداد ساعات و اندازه صفحه مشخص شده در درخواست، ثبت می‌شود.

timeZone

object ( TimeZone )

منطقه زمانی در محل درخواستی.

nextPageToken

string

توکن برای بازیابی صفحه بعدی.

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

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

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

ساعت پیش‌بینی

نشان‌دهنده‌ی یک رکورد پیش‌بینی ساعتی در یک مکان مشخص است.

نمایش JSON 
{
  "interval": {
    object (Interval)
  },
  "displayDateTime": {
    object (DateTime)
  },
  "weatherCondition": {
    object (WeatherCondition)
  },
  "temperature": {
    object (Temperature)
  },
  "feelsLikeTemperature": {
    object (Temperature)
  },
  "dewPoint": {
    object (Temperature)
  },
  "heatIndex": {
    object (Temperature)
  },
  "windChill": {
    object (Temperature)
  },
  "wetBulbTemperature": {
    object (Temperature)
  },
  "precipitation": {
    object (Precipitation)
  },
  "airPressure": {
    object (AirPressure)
  },
  "wind": {
    object (Wind)
  },
  "visibility": {
    object (Visibility)
  },
  "iceThickness": {
    object (IceThickness)
  },
  "isDaytime": boolean,
  "relativeHumidity": integer,
  "uvIndex": integer,
  "thunderstormProbability": integer,
  "cloudCover": integer
}
فیلدها
interval

object ( Interval )

این داده‌های پیش‌بینی برای بازه زمانی یک ساعته (به زمان UTC) معتبر است (مهرهای زمانی به نزدیکترین ساعت گرد شده‌اند).

displayDateTime

object ( DateTime )

تاریخ و زمان محلی در منطقه زمانی مکان (زمان رسمی) که این پیش‌بینی ساعتی برای آن محاسبه می‌شود. این فیلد ممکن است برای اهداف نمایشی در کلاینت استفاده شود. توجه: این تاریخ شامل سال، ماه، روز، ساعت و انحراف از UTC خواهد بود.

weatherCondition

object ( WeatherCondition )

وضعیت آب و هوای پیش‌بینی شده.

temperature

object ( Temperature )

دمای پیش‌بینی‌شده.

feelsLikeTemperature

object ( Temperature )

معیاری برای سنجش میزان دمایی که در محل مورد نظر احساس خواهد شد.

dewPoint

object ( Temperature )

دمای نقطه شبنم پیش‌بینی‌شده

heatIndex

object ( Temperature )

دمای پیش‌بینی‌شده شاخص گرما

windChill

object ( Temperature )

باد سرد پیش‌بینی‌شده، دمای هوایی که روی پوست نمایان می‌شود.

wetBulbTemperature

object ( Temperature )

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

precipitation

object ( Precipitation )

احتمال بارش پیش‌بینی‌شده و میزان بارش انباشته‌شده در طول ساعت گذشته.

airPressure

object ( AirPressure )

شرایط فشار هوای پیش‌بینی‌شده

wind

object ( Wind )

وضعیت باد پیش‌بینی‌شده

visibility

object ( Visibility )

میزان دید پیش‌بینی‌شده

iceThickness

object ( IceThickness )

ضخامت یخ پیش‌بینی‌شده

isDaytime

boolean

اگر این ساعت بین زمان طلوع خورشید محلی (شامل) و غروب خورشید (به جز) باشد، درست است. در غیر این صورت، شب است (بین غروب خورشید و طلوع خورشید بعدی). توجه: اگر این بازه زمانی به ترتیب با زمان طلوع و غروب خورشید محلی تلاقی کند، این ساعت به عنوان روز یا شب در نظر گرفته می‌شود (مثلاً: اگر بازه زمانی از ۵ صبح تا ۶ صبح باشد و طلوع خورشید ساعت ۵:۵۹ صبح باشد، آنگاه عبارت isDaytime درست خواهد بود).

relativeHumidity

integer

درصد رطوبت نسبی پیش‌بینی‌شده (مقادیر از ۰ تا ۱۰۰).

uvIndex

integer

شاخص فرابنفش پیش‌بینی‌شده (UV).

thunderstormProbability

integer

احتمال پیش‌بینی‌شده‌ی رعد و برق (مقادیر از ۰ تا ۱۰۰).

cloudCover

integer

درصد پیش‌بینی‌شده‌ی آسمان پوشیده از ابر (مقادیر از ۰ تا ۱۰۰).