Method: flashFloods.search

מחפשים שיטפונות בזק. הפונקציה מחזירה את האירועים האחרונים של שיטפונות פתאומיים שפעילים כרגע או צפויים. פרטים נוספים זמינים בכתובת https://support.google.com/flood-hub/answer/16811681.

בקשת HTTP

POST https://floodforecasting.googleapis.com/v1/flashFloods:search

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

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "countryCodes": [
    string
  ],
  "pageSize": integer,
  "pageToken": string
}
שדות
countryCodes[]

string

אופציונלי. קודי המדינות שבהן רוצים לחפש שיטפונות בזק. בפורמט alpha-2 לפי תקן ISO 3166, לדוגמה, US. אם לא תציינו מדינה, המערכת תחזיר נתוני שיטפונות לגבי כל המדינות.
pageSize

integer

אופציונלי. מספר האירועים המקסימלי שיוחזרו. יכול להיות שהשירות יחזיר פחות מהערך הזה. אם לא מציינים ערך, יוחזרו לכל היותר 10,000 אירועים. הערך המקסימלי הוא 10,000. ערכים גבוהים יותר יומרו ל-10,000.
pageToken

string

אופציונלי. טוקן של דף שהתקבל מקריאה קודמת של flashFloods.search. צריך להזין את הטוקן כדי לאחזר את הדף הבא. כשמבצעים חלוקה לעמודים, כל הפרמטרים האחרים שסופקו ל-flashFloods.search חייבים להיות זהים לקריאה שסיפקה את הטוקן של הדף.

גוף התשובה

התשובה של [flashFloods.search][google.research.floodforecasting.v1.SearchLatestFlashFloods].

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

ייצוג ב-JSON 
{
  "flashFloodEvents": [
    {
      object (FlashFloodEvent)
    }
  ],
  "nextPageToken": string
}
שדות
flashFloodEvents[]

object (FlashFloodEvent)

אירועי השיטפונות הפתאומיים שנמצאו על סמך קריטריוני הבקשה.
nextPageToken

string

אופציונלי. טוקן שאפשר לשלוח כ-pageToken כדי לאחזר את הדף הבא. אם משמיטים את השדה הזה, לא יופיעו דפים נוספים.

FlashFloodEvent

אירוע של שיטפון בזק. הוא מייצג מסגרת זמן שמתחילה ב-forecastIssueTime ונמשכת forecastPeriodHours, שבמהלכה צפוי שיטפון בזק.

ייצוג ב-JSON 
{
  "forecastIssueTime": string,
  "forecastPeriodHours": integer,
  "affectedCountryCodes": [
    string
  ],
  "likelyAffectedPolygonId": string,
  "highlyLikelyAffectedPolygonId": string,
  "eventPolygonId": string
}
שדות
forecastIssueTime

string

השעה שבה התחזית הזו פורסמה. הפורמט הוא ISO 8601, לדוגמה, ‎"2025-10-17T10:34:00Z".
forecastPeriodHours

integer

משך התחזית בשעות.
affectedCountryCodes[]

string

המדינות שצפויות להיות מושפעות מהאירוע, בפורמט ISO 3166 alpha-2, למשל 'US'.
likelyAffectedPolygonId

string

פוליגון של האזור שסביר שיושפע משיטפון בזק. אפשר לשלוח את מזהה המצולע אל [serializedPolygons.get][google.research.floodforecasting.v1.GetSerializedPolygon] כדי לאחזר את המצולע של אזור האירוע.
highlyLikelyAffectedPolygonId

string

פוליגון של האזור שסביר מאוד שיושפע משיטפון בזק. אפשר לשלוח את מזהה המצולע אל [serializedPolygons.get][google.research.floodforecasting.v1.GetSerializedPolygon] כדי לאחזר את המצולע של אזור האירוע.
eventPolygonId

string

מזהה הפוליגון של אזור הגבול של האירוע. זהו איחוד של מצולעים עם סבירות גבוהה וסבירות גבוהה מאוד. אפשר לשלוח את מזהה הפוליגון אל [serializedPolygons.get][google.research.floodforecasting.v1.GetSerializedPolygon] כדי לאחזר את הפוליגון של אזור הגבול של האירוע.