Method: history.hours.lookup

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

בקשת HTTP

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

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

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

פרמטרים
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).