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

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

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

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

תנאים

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

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

‫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 שנשמר במטמון

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

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

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

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

פרמטרים של בקשה

נקודת הקצה 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 עוצמת המשקעים בפלח. הערכים כוללים:
  • PRECIPITATION_INTENSITY_UNSPECIFIED
  • NO_INTENSITY
  • LIGHT
  • MODERATE
  • 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"
    },
    ...
  ]
}