Method: lookupWeather

לחפש את תנאי מזג האוויר במיקום מסוים.

בקשת HTTP

POST https://mapstools.googleapis.com/v1:lookupWeather

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

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "unitsSystem": enum (UnitsSystem),
  "location": {
    object (Location)
  },
  "capabilities": [
    enum (Capability)
  ],
  "date": {
    object (Date)
  },
  "hour": integer,
  "languageCode": string,
  "weatherOptions": {
    object (WeatherOptions)
  },
  "airQualityOptions": {
    object (AirQualityOptions)
  }
}
שדות
unitsSystem

enum (UnitsSystem)

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

object (Location)

חובה. המיקום שרוצים לקבל את תנאי מזג האוויר שלו.
capabilities[]

enum (Capability)

זה שינוי אופציונלי. היכולות הסביבתיות שצריך לכלול בתשובה.
date

object (Date)

זה שינוי אופציונלי. מציין את התאריך של המידע הסביבתי המבוקש, ביחס לאזור הזמן המקומי של המיקום שצוין בשדה location. טווחי התאריכים הנתמכים תלויים ביכולות המבוקשות: - WEATHER: עד 24 שעות בעבר (כאשר hour מוגדר גם כן) ועד 10 ימים (240 שעות) בעתיד (היום עד +9 ימים לתחזיות יומיות). ‫- AIR_QUALITY: עד 30 ימים (720 שעות) בעבר ועד 4 ימים (96 שעות) בעתיד. ‫- POLLEN: מהיום ועד 4 ימים קדימה (עד 5 ימים כולל היום, לא כולל תאריכים קודמים).
hour

integer

זה שינוי אופציונלי. מציין את השעה של המידע הסביבתי המבוקש, בפורמט של 24 שעות (0-23), ביחס לאזור הזמן המקומי של המיקום שצוין בשדה location. צריך לציין את date. טווחי השעות הנתמכים תלויים ביכולות המבוקשות: - WEATHER: עד 24 שעות בעבר ועד 240 שעות (10 ימים) בעתיד. ‫- AIR_QUALITY: עד 30 ימים (720 שעות) בעבר ועד 4 ימים (96 שעות) בעתיד. ‫- POLLEN: מחזירה תחזיות יומיות בלבד. המערכת מתעלמת מהערך hour כשמדובר באבקנים.
languageCode

string

זה שינוי אופציונלי. קוד השפה בתקן BCP-47 לטקסט המותאם לשוק המקומי בתגובה (למשל "en",‏ "ja",‏ "fr-CA"). אם לא מציינים ערך, ברירת המחדל היא "en".
weatherOptions

object (WeatherOptions)

זה שינוי אופציונלי. אפשרויות ספציפיות לבקשות שקשורות למזג האוויר. השדה weatherOptions.units_system נתמך בשילוב עם unitsSystem ברמה העליונה (תג 4) כדי לשמור על תאימות לדורות קודמים עבור מבצעי קריאה קיימים. הפונקציה מחזירה את הערך INVALID_ARGUMENT אם שניהם מציינים מערכות יחידות סותרות. המערכת מתעלמת מהמדיניות הזו אם לא נשלחה בקשה להפעיל את WEATHER במדיניות capabilities.
airQualityOptions

object (AirQualityOptions)

זה שינוי אופציונלי. אפשרויות ספציפיות לבקשות שקשורות לאיכות האוויר. המערכת מתעלמת מהמדיניות הזו אם לא נשלחה בקשה להפעיל את AIR_QUALITY במדיניות capabilities.

גוף התשובה

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

היקפי הרשאות

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/maps-platform.mapstools