Method: forecast.hours.lookup

تا 240 ساعت پیش‌بینی ساعتی را در یک مکان مشخص، از ساعت فعلی، برمی‌گرداند.

درخواست HTTP

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

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

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

پارامترها
location

object ( LatLng )

مورد نیاز. مکانی برای دریافت پیش‌بینی ساعتی.

units System

enum ( UnitsSystem )

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

page Size

integer

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

page Token

string

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

hours

integer

اختیاری. مقدار کل ساعات واکشی را با شروع از ساعت فعلی محدود می کند - مقداری از 1 تا 240 (شامل). پیش فرض حداکثر مقدار مجاز 240 است.

language Code

string

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

درخواست بدن

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

بدن پاسخگو

پاسخ برای ساعت ها.lookup RPC.

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

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

object ( ForecastHour )

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

time Zone

object ( TimeZone )

منطقه زمانی در مکان درخواستی

next Page Token

string

نشانه برای بازیابی صفحه بعدی.

محدوده مجوز

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

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

ForecastHour

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

نمایندگی 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) این داده های پیش بینی برای آن معتبر است (مهرهای زمانی به نزدیکترین ساعت گرد می شوند).

display Date Time

object ( DateTime )

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

weather Condition

object ( WeatherCondition )

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

temperature

object ( Temperature )

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

feels Like Temperature

object ( Temperature )

اندازه گیری اینکه دما در مکان درخواستی چگونه خواهد بود.

dew Point

object ( Temperature )

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

heat Index

object ( Temperature )

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

wind Chill

object ( Temperature )

باد سرد پیش بینی شده، دمای هوا بر روی پوست قرار می گیرد.

wet Bulb Temperature

object ( Temperature )

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

precipitation

object ( Precipitation )

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

air Pressure

object ( AirPressure )

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

wind

object ( Wind )

شرایط باد پیش بینی شده

visibility

object ( Visibility )

دید پیش بینی شده

ice Thickness

object ( IceThickness )

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

is Daytime

boolean

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

relative Humidity

integer

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

uv Index

integer

شاخص ماوراء بنفش (UV) پیش بینی شده

thunderstorm Probability

integer

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

cloud Cover

integer

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