Method: currentConditions.lookup

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

בקשת HTTP

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

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

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

פרמטרים
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 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-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)
  },
  "snowQpf": {
    object (QuantitativePrecipitationForecast)
  },
  "qpf": {
    object (QuantitativePrecipitationForecast)
  }
}
שדות
temperatureChange

object (Temperature)

הטמפרטורה הנוכחית פחות הטמפרטורה לפני 24 שעות.
maxTemperature

object (Temperature)

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

object (Temperature)

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

object (QuantitativePrecipitationForecast)

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

object (QuantitativePrecipitationForecast)

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