- בקשת HTTP
- פרמטרים של שאילתה
- גוף הבקשה
- גוף התגובה
- היקפי הרשאות
- PrecipitationSegment
- DominantPrecipitationType
- PrecipitationIntensity
- כדאי לנסות!
מחזירה אירועים של חיזוי לטווח קצר מאוד של משקעים ברמת הדקה, עד 6 שעות.
בקשת HTTP
GET https://weather.googleapis.com/v1/forecast/minutes:lookup
כתובת ה-URL כתובה בתחביר של gRPC Transcoding.
פרמטרים של שאילתה
| פרמטרים | |
|---|---|
location |
חובה. המיקום שלגביו רוצים לקבל תחזית לפי דקות. |
unitsSystem |
זה שינוי אופציונלי. מערכת היחידות שבה משתמשים לתנאי מזג האוויר שמוחזרים. אם לא תציינו מערכת, תנאי מזג האוויר שיוחזרו יהיו במערכת המטרית (ברירת המחדל = METRIC). |
pageSize |
זה שינוי אופציונלי. מספר רשומות התחזית המקסימלי שיוחזרו בכל דף. |
pageToken |
זה שינוי אופציונלי. טוקן של דף שהתקבל מבקשה קודמת. הוא משמש לאחזור הדף הבא. |
גוף הבקשה
גוף הבקשה צריך להיות ריק.
גוף התשובה
תגובה לקריאה לשירות מרוחק (RPC) של minutes.lookup.
אם הפעולה מצליחה, גוף התשובה מכיל נתונים במבנה הבא:
| ייצוג ב-JSON |
|---|
{ "overallPredictionTimeframe": { object ( |
| שדות | |
|---|---|
overallPredictionTimeframe |
מסגרת הזמן הכוללת של התחזיות. |
timeZone |
אזור הזמן במיקום המבוקש. |
nextPageToken |
הטוקן לאחזור הדף הבא. |
segments[] |
הפלחים של החיזוי ברמת הדקה. |
היקפי הרשאות
נדרש היקף ההרשאות הבא של OAuth:
https://www.googleapis.com/auth/cloud-platform
PrecipitationSegment
מייצג פלח של נתוני תחזית המשקעים.
| ייצוג ב-JSON |
|---|
{ "timeFrame": { object ( |
| שדות | |
|---|---|
timeFrame |
מסגרת הזמן הרלוונטית לפלח. |
type |
סוג המשקעים. |
probability |
הסיכוי למשקעים. הערכים הם באחוזים, בין 0 ל-100. |
qpf |
תחזית משקעים כמותית |
snowfallAmount |
תחזית כמותית של משקעי שלג |
intensity |
עוצמת המשקעים בקטע. |
DominantPrecipitationType
סוג המשקעים.
| טיפוסים בני מנייה (enum) | |
|---|---|
DOMINANT_PRECIPITATION_TYPE_UNSPECIFIED |
סוג המשקעים לא צוין. |
NONE |
אין משקעים. |
RAIN |
גשם. |
SNOW |
שלג. |
HAIL |
ברד. |
PrecipitationIntensity
עוצמת המשקעים בקטע.
| טיפוסים בני מנייה (enum) | |
|---|---|
PRECIPITATION_INTENSITY_UNSPECIFIED |
עוצמת המשקעים לא ידועה. |
NO_INTENSITY |
אין עוצמת משקעים. |
LIGHT |
עוצמת משקעים קלה. |
MODERATE |
עוצמת משקעים בינונית. |
HEAVY |
עוצמת משקעים גבוהה. |
MID_LIGHT |
עוצמת משקעים בינונית-קלה. |
MID_MODERATE |
עוצמת משקעים בינונית. |
MID_HEAVY |
עוצמת משקעים בינונית-גבוהה. |