Method: history.hours.lookup

حداکثر 24 ساعت اطلاعات آب و هوای تاریخی ساعتی را در یک مکان معین، از آخرین ساعت شروع می‌کند.

درخواست HTTP

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

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

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

پارامترها
location

object ( LatLng )

مورد نیاز. مکانی برای دریافت اطلاعات تاریخی ساعتی.

units System

enum ( UnitsSystem )

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

page Size

integer

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

page Token

string

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

hours

integer

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

language Code

string

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

درخواست بدن

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

بدن پاسخگو

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

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

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

object ( HistoryHour )

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

time Zone

object ( TimeZone )

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

next Page Token

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

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).