Method: forecast.hours.lookup

הפונקציה מחזירה תחזיות שעתיות למיקום נתון למשך עד 240 שעות, החל מהשעה הנוכחית.

בקשת HTTP

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

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

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

פרמטרים
location

object (LatLng)

חובה. המיקום שרוצים לקבל לגביו תחזית לפי שעות.
unitsSystem

enum (UnitsSystem)

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

integer

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

string

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

integer

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

string

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

גוף הבקשה

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

גוף התשובה

תשובה לקריאה לשירות מרוחק (RPC) של hours.lookup.

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

ייצוג ב-JSON 
{
  "forecastHours": [
    {
      object (ForecastHour)
    }
  ],
  "timeZone": {
    object (TimeZone)
  },
  "nextPageToken": string
}
שדות
forecastHours[]

object (ForecastHour)

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

object (TimeZone)

אזור הזמן במיקום המבוקש.
nextPageToken

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) שבו נתוני התחזית האלה תקפים (חותמות הזמן מעוגלות כלפי מטה לשעה הקרובה ביותר).
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).