Method: history.hours.lookup

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

درخواست HTTP

GET https://weather.googleapis.com/v1/history/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 
{
  "historyHours": [
    {
      object (HistoryHour)
    }
  ],
  "timeZone": {
    object (TimeZone)
  },
  "nextPageToken": string
}
فیلدها
historyHours[]

object ( HistoryHour )

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

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

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