Method: currentConditions.lookup

הפונקציה מחזירה את תנאי מזג האוויר הנוכחיים במיקום נתון.

בקשת HTTP

GET https://weather.googleapis.com/v1/currentConditions:lookup

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

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

פרמטרים
location

object (LatLng)

חובה. המיקום שבו רוצים לקבל את תנאי מזג האוויר הנוכחיים.
unitsSystem

enum (UnitsSystem)

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

string

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

גוף הבקשה

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

גוף התשובה

תגובה ל-RPC של currentConditions.lookup – מייצגת את תנאי מזג האוויר הנוכחיים במיקום המבוקש.

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

ייצוג ב-JSON 
{
  "currentTime": string,
  "timeZone": {
    object (TimeZone)
  },
  "weatherCondition": {
    object (WeatherCondition)
  },
  "temperature": {
    object (Temperature)
  },
  "feelsLikeTemperature": {
    object (Temperature)
  },
  "dewPoint": {
    object (Temperature)
  },
  "heatIndex": {
    object (Temperature)
  },
  "windChill": {
    object (Temperature)
  },
  "precipitation": {
    object (Precipitation)
  },
  "airPressure": {
    object (AirPressure)
  },
  "wind": {
    object (Wind)
  },
  "visibility": {
    object (Visibility)
  },
  "currentConditionsHistory": {
    object (CurrentConditionsHistory)
  },
  "isDaytime": boolean,
  "relativeHumidity": integer,
  "uvIndex": integer,
  "thunderstormProbability": integer,
  "cloudCover": integer
}
שדות
currentTime

string (Timestamp format)

השעה הנוכחית (UTC) שמשויכת לנתונים שהוחזרו.

הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
timeZone

object (TimeZone)

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

object (WeatherCondition)

תנאי מזג האוויר הנוכחיים.
temperature

object (Temperature)

הטמפרטורה הנוכחית
feelsLikeTemperature

object (Temperature)

המדד של תחושת הטמפרטורה הנוכחית במיקום המבוקש.
dewPoint

object (Temperature)

הטמפרטורה הנוכחית של נקודת הטל.
heatIndex

object (Temperature)

הטמפרטורה הנוכחית של מדד החום.
windChill

object (Temperature)

הטמפרטורה הנוכחית של הרוח, טמפרטורת האוויר שנחשפת על העור.
precipitation

object (Precipitation)

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

object (AirPressure)

תנאי לחץ האוויר הנוכחיים.
wind

object (Wind)

תנאי הרוח הנוכחיים.
visibility

object (Visibility)

הרשאות הגישה הנוכחיות.
currentConditionsHistory

object (CurrentConditionsHistory)

השינויים בתנאי הנסיעה הנוכחיים ב-24 השעות האחרונות.
isDaytime

boolean

הפונקציה מחזירה את הערך True אם השעה הנוכחית במיקום המבוקש היא בין שעת הזריחה המקומית (כולל) לשעת השקיעה המקומית (לא כולל). אחרת, זוהי שעת לילה (בין השקיעה לבין הזריחה הבאה).
relativeHumidity

integer

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

integer

המדד הנוכחי של קרינת UV.
thunderstormProbability

integer

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

integer

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

היקפי הרשאה

נדרשת הרשאת OAuth ברמה הבאה:

  • https://www.googleapis.com/auth/cloud-platform

CurrentConditionsHistory

מייצג קבוצה של שינויים בתנאי הנוכחיים ב-24 השעות האחרונות.

ייצוג ב-JSON 
{
  "temperatureChange": {
    object (Temperature)
  },
  "maxTemperature": {
    object (Temperature)
  },
  "minTemperature": {
    object (Temperature)
  },
  "qpf": {
    object (QuantitativePrecipitationForecast)
  }
}
שדות
temperatureChange

object (Temperature)

הטמפרטורה הנוכחית פחות הטמפרטורה מ-24 שעות קודם.
maxTemperature

object (Temperature)

הטמפרטורה המקסימלית (הגבוהה) ב-24 השעות האחרונות.
minTemperature

object (Temperature)

הטמפרטורה המינימלית (הנמוכה) ב-24 השעות האחרונות.
qpf

object (QuantitativePrecipitationForecast)

כמות המשקעים (גשם או שלג), שנמדדת ככמות מים נוזליים, שהצטברה ב-24 השעות האחרונות. הערה: QPF הוא קיצור של Quantitative Precipitation Forecast (תחזית משקעים כמותית). פרטים נוספים זמינים בהגדרה של QuantitativePrecipitationForecast.