קבלת תחזית לדקה (ניסוי)

נקודת הקצה (endpoint) forecast:minutes מספקת תחזית משקעים ברזולוציה גבוהה, דקה אחר דקה (נקראת גם nowcasting) למיקום נתון.

ה-API מחזיר את המידע הבא למסגרת זמן של 6 שעות:

  • שעת ההתחלה ושעת הסיום של מסגרת הזמן של החיזוי
  • אזור הזמן של המיקום המבוקש
  • שעות ההתחלה והסיום של כל קטע בתחזית
  • הסוג, הסבירות, הכמות והעוצמה הצפויים של המשקעים בכל קטע

תנאים

התנאים האלה מפורסמים בהתאם לסעיף 6 (תנאי השימוש במוצרים בגרסת טרום-GA) בתנאים הספציפיים לשירות של הפלטפורמה של מפות Google, כפי שהוסכם בינך לבין Google.

‫1.1 דרישות ייחוס. אם הלקוח משתמש בתוכן של מפות Google מ-Weather API, הוא צריך לספק ל-Google שיוך (Attribution) בהתאם למסמכי התיעוד.

‫1.2 הגבלות. הלקוחות לא יכולים להשתמש בתוכן של מפות Google שאוחזר מ-Weather API כדי ליצור מחדש שירות או מוצר של Google (למשל, להשתמש בנתונים שאוחזרו מ-Weather API באפליקציית מזג אוויר או במודל מזג אוויר שהמטרה העיקרית שלהם היא לספק מידע על מזג האוויר).

‫1.3 שמירה במטמון. הלקוחות יכולים לשמור באופן זמני במטמון את התוכן הרלוונטי של מפות Google מ-Weather API למשך תקופת השמירה במטמון הרלוונטית, כפי שמתואר בטבלה 1.3.1 (הרשאות לשמירה במטמון).

טבלה 1.3.1 (הרשאות לשמירה במטמון)

ההרשאות האלה הן בנוסף להרשאות שמתוארות בטבלה 17.2.1 בתנאים הספציפיים לשירות של Google Maps Platform.

תוכן במפות Google תקופת השמירה במטמון
ערכי תחזית לדקה שעה אחת, שלאחריה הלקוח חייב למחוק את תוכן מפות Google שנשמר במטמון

מידע על בקשות לתחזית דקה

כדי לבקש תחזיות לפי דקה, שולחים בקשת HTTP GET אל:

https://weather.googleapis.com/v1/forecast/minutes:lookup?key=API_KEY&location.latitude=LATITUDE&location.longitude=LONGITUDE

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

פרמטרים של בקשות

נקודת הקצה (endpoint) forecast.minutes מקבלת את הפרמטרים הבאים של הבקשה:

פרמטר תיאור נדרש או אופציונלי
location.latitude קו הרוחב של המיקום המבוקש. חובה
location.longitude קו האורך של המיקום המבוקש. חובה
unitsSystem מערכת היחידות המבוקשת. הערכים כוללים:
  • UNITS_SYSTEM_UNSPECIFIED
  • IMPERIAL
  • METRIC

אם לא מציינים מערכת יחידות, ברירת המחדל בתגובה היא METRIC.

אופציונלי
pageSize מציין את המספר המקסימלי של תוצאות שיוחזרו. אופציונלי
pageToken טוקן של דף שהתקבל מבקשה קודמת. כדי לאחזר את דף הנתונים הבא, צריך להעביר את pageToken כפרמטר קלט בבקשה הבאה. אופציונלי

מידע על התשובות של תחזית דקה אחר דקה

ה-Weather API מחזיר את השדות הבאים בגוף התשובה:

שדה תיאור
overallPredictionTimeframe מסגרת הזמן הכוללת של התחזיות.
overallPredictionTimeframe.startTime שעת ההתחלה של מסגרת הזמן לחיזוי. זה משקף את נקודת ההתייחסות הראשונית.
overallPredictionTimeframe.endTime שעת הסיום של מסגרת הזמן לחיזוי. השעה הזו מוגדרת לשש שעות אחרי שעת ההתחלה.
timeZone אזור הזמן של המיקום המבוקש.
segments הפלחים של התחזית ברמת הדקה, שמסומנים ב-timeFrame.
segments.timeFrame מסגרת הזמן הרלוונטית לפלח.
segments.timeFrame.startTime שעת ההתחלה של הפלח.
segments.timeFrame.endTime שעת הסיום של הקטע.
segments.type סוג המשקעים הצפוי במהלך אותו מקטע. הערכים כוללים:
  • DOMINANT_PRECIPITATION_TYPE_UNSPECIFIED
  • NONE
  • RAIN
  • SNOW
  • HAIL
segments.probability הסיכוי החזוי למשקעים במהלך אותו מקטע. הערכים הם באחוזים, בין 0 ל-100.
segments.qpf תחזית המשקעים הכמותית.
segments.qpf.quantity כמות המשקעים הצפויה במהלך אותו מקטע.
segments.qpf.unit היחידה שמשמשת למדידת כמות המשקעים המצטברת (לדוגמה, MILLIMETERS, INCHES).
segments.snowfallAmount כמות השלג הצפויה במהלך אותו מקטע.
segments.snowfallAmount.quantity כמות השלג החזויה (שווה ערך למים נוזליים) במהלך אותו מקטע.
segments.snowfallAmount.unit יחידת המידה של כמות השלג שנערם (לדוגמה, MILLIMETERS, INCHES).
segments.intensity עוצמת המשקעים בקטע (PrecipitationIntensity). הערכים כוללים:
  • PRECIPITATION_INTENSITY_UNSPECIFIED
  • NO_INTENSITY
  • MID_LIGHT
  • LIGHT
  • MID_MODERATE
  • MODERATE
  • MID_HEAVY
  • HEAVY

הערה: חשוב לוודא שהלקוח יכול לטפל בערכים לא ידועים.

nextPageToken טוקן שאפשר לשלוח כ-pageToken כדי לאחזר את הדף הבא. אם משמיטים את השדה הזה, לא יופיעו דפים נוספים.

דוגמה לתחזית לפי דקות

בדוגמה הבאה נשלחת בקשה למידע על תחזית לפי דקות למיקום בווירג'יניה המערבית:

curl -H "Content-Type: application/json" -X GET "https://weather.googleapis.com/v1/forecast/minutes:lookup?key=API_KEY&location.latitude=37.60451&location.longitude=-80.59044&unitsSystem=METRIC&pageSize=5"

בתגובה, האובייקט segments מציין כל פלח במסגרת הזמן הכוללת של החיזוי:

  {
  "overallPredictionTimeframe": {
    "startTime": "2026-05-11T12:10:00Z",
    "endTime": "2026-05-11T18:12:00Z"
  },
  "timeZone": {
    "id": "America/New_York"
  },
  "segments": [
    {
      "timeFrame": {
        "startTime": "2026-05-11T12:20:00Z",
        "endTime": "2026-05-11T12:22:00Z"
      },
      "type": "RAIN",
      "probability": 21,
      "qpf": {
        "quantity": 0.1333,
        "unit": "MILLIMETERS"
      },
      "snowfallAmount": {
        "quantity": 0.0,
        "unit": "MILLIMETERS"
      },
      "intensity": "MODERATE"
    },
    {
      "timeFrame": {
        "startTime": "2026-05-11T12:22:00Z",
        "endTime": "2026-05-11T12:24:00Z"
      },
      "type": "RAIN",
      "probability": 21,
      "qpf": {
        "quantity": 0.1333,
        "unit": "MILLIMETERS"
      },
      "snowfallAmount": {
        "quantity": 0.0,
        "unit": "MILLIMETERS"
      },
      "intensity": "MODERATE"
    },
    ...
  ]
}