Method: floodStatus.queryLatestFloodStatusByGaugeIds

שאילתה לגבי הסטטוס העדכני של שיטפון לפי מזהי מדיד.

בקשת HTTP

GET https://floodforecasting.googleapis.com/v1/floodStatus:queryLatestFloodStatusByGaugeIds

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

פרמטרים של שאילתה

פרמטרים
gaugeIds[]

string

חובה. רשימה של מזהי מדדים. גודל הרשימה הנתמך מוגבל ל-20,000. אם מספקים רשימה גדולה מ-20,000, הפעולה נכשלת עם השגיאה INVALID_REQUEST.
cutoffTime

string

אופציונלי. אופציונלי. המועד האחרון לפרסום סטטוסים לגבי שיטפונות. אם מספקים את הנתונים, יוחזרו הסטטוסים האחרונים של השיטפונות (הסטטוסים שפורסמו לאחרונה) נכון למועד האחרון. אם לא מציינים את הפרמטר הזה, המערכת מחזירה את הסטטוסים האחרונים של השיטפונות שפורסמו עד עכשיו. המועד המוקדם ביותר שאפשר להגדיר למועד האחרון הוא 2025-08-01T00:00:00Z. אם שעת הסיום חלה לפני השעה הזו, תוחזר שגיאת INVALID_ARGUMENT. מיוצג בפורמט ISO 8601, לדוגמה: "2025-10-17T10:34:00Z".

גוף הבקשה

גוף הבקשה צריך להיות ריק.

גוף התשובה

התשובה של floodStatus.queryLatestFloodStatusByGaugeIds.

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "floodStatuses": [
    {
      object (FloodStatus)
    }
  ]
}
שדות
floodStatuses[]

object (FloodStatus)

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