‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

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

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

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

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

תנאים

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

‫1.1 דרישות בנושא שיוך (Attribution) אם הלקוח משתמש בתוכן של מפות 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 שנשמר במטמון

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

כדי לבקש תחזיות ברמת הדקה, שולחים בקשת 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"
    },
    ...
  ]
}