נקודת הקצה (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 |
מערכת היחידות המבוקשת. הערכים כוללים:
אם לא מציינים מערכת יחידות, ברירת המחדל בתגובה היא |
אופציונלי |
pageSize |
מציין את המספר המקסימלי של תוצאות שיוחזרו. | אופציונלי |
pageToken |
טוקן של דף שהתקבל מבקשה קודמת. כדי לאחזר את דף הנתונים הבא, צריך להעביר את pageToken כפרמטר קלט בבקשה הבאה. |
אופציונלי |
מידע על התשובות של תחזית דקה אחר דקה
ה-Weather API מחזיר את השדות הבאים בגוף התשובה:
| שדה | תיאור |
|---|---|
overallPredictionTimeframe |
מסגרת הזמן הכוללת של התחזיות. |
overallPredictionTimeframe.startTime |
שעת ההתחלה של מסגרת הזמן לחיזוי. זה משקף את נקודת ההתייחסות הראשונית. |
overallPredictionTimeframe.endTime |
שעת הסיום של מסגרת הזמן לחיזוי. השעה הזו מוגדרת לשש שעות אחרי שעת ההתחלה. |
timeZone |
אזור הזמן של המיקום המבוקש. |
segments |
הפלחים של התחזית ברמת הדקה, שמסומנים ב-timeFrame. |
segments.timeFrame |
מסגרת הזמן הרלוונטית לפלח. |
segments.timeFrame.startTime |
שעת ההתחלה של הפלח. |
segments.timeFrame.endTime |
שעת הסיום של הקטע. |
segments.type |
סוג המשקעים הצפוי במהלך אותו מקטע. הערכים כוללים:
|
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). הערכים כוללים:
הערה: חשוב לוודא שהלקוח יכול לטפל בערכים לא ידועים. |
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" }, ... ] }