Method: history.hours.lookup

הפונקציה מחזירה נתוני מזג אוויר היסטוריים שעתיים של עד 24 שעות במיקום נתון, החל מהשעה האחרונה.

בקשת HTTP

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

כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.

פרמטרים של שאילתה

פרמטרים
location

object (LatLng)

חובה. המיקום שבו רוצים לקבל את הנתונים ההיסטוריים השעתיים.
unitsSystem

enum (UnitsSystem)

זה שינוי אופציונלי. מערכת היחידות שבה נעשה שימוש לתנאי מזג האוויר שמוחזרים. אם לא יצוין ערך, תנאי מזג האוויר שיוחזרו יהיו לפי השיטה המטרית (ברירת המחדל = METRIC).
pageSize

integer

זה שינוי אופציונלי. המספר המקסימלי של רשומות היסטוריות שעתיות להחזיר בכל דף – ערך בין 1 ל-24 (כולל). ערך ברירת המחדל הוא הערך המקסימלי המותר, 24.
pageToken

string

זה שינוי אופציונלי. אסימון דף שהתקבל מבקשה קודמת. הוא משמש לאחזור הדף הבא.
hours

integer

זה שינוי אופציונלי. הגבלת מספר השעות הכולל לאחזור, החל מהשעה האחרונה – בין 1 ל-24 (כולל). ערך ברירת המחדל הוא הערך המקסימלי המותר, 24.
languageCode

string

זה שינוי אופציונלי. מאפשרת ללקוח לבחור את שפת התגובה. אם לא ניתן לספק נתונים בשפה הזו, המערכת תשתמש בהתאמה הקרובה ביותר ב-API. הערכים המותרים מבוססים על תקן IETF BCP-47. ערך ברירת המחדל הוא 'en'.

גוף הבקשה

גוף הבקשה חייב להיות ריק.

גוף התשובה

התגובה של ה-RPC של hours.lookup.

אם הפעולה מצליחה, גוף התגובה מכיל נתונים במבנה הבא:

ייצוג ב-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

HistoryHour

תיעוד היסטוריה שעתי במיקום נתון.

ייצוג ב-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

הערך True מוחזר אם השעה הזו נמצאת בין שעת הזריחה המקומית (כולל) לשעת השקיעה המקומית (לא כולל). אחרת, זוהי שעת לילה (בין השקיעה לבין הזריחה הבאה). הערה: השעה הזו תיחשב לשעות היום או הלילה אם מרווח הזמן חוצה את שעות הזריחה והשקיעה המקומיות, בהתאמה (למשל: אם מרווח הזמן הוא מ-5:00 עד 6:00 והזריחה היא בשעה 5:59, הערך של isDaytime יהיה true).
relativeHumidity

integer

אחוז הלחות היחסית ההיסטורית (ערכים מ-0 ל-100).
uvIndex

integer

המדד ההיסטורי של הקרינה האולטרה סגולה (UV).
thunderstormProbability

integer

ההסתברות ההיסטורית לשיטפון (ערכים מ-0 ל-100).
cloudCover

integer

האחוז ההיסטורי של השמיים שכוסו בעננים (ערכים מ-0 ל-100).