Method: forecast.hours.lookup

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

בקשת HTTP

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

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

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

פרמטרים
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 (UV) הצפוי.
thunderstormProbability

integer

ההסתברות לחזה רעמים (ערכים מ-0 ל-100).
cloudCover

integer

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