Method: flashFloods.search

搜尋暴洪。傳回目前有效或預測的最新暴洪事件。詳情請參閱 https://support.google.com/flood-hub/answer/16811681。

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

要求主體

要求主體會包含結構如下的資料：

JSON 表示法 
{
  "countryCodes": [
    string
  ],
  "pageSize": integer,
  "pageToken": string
}
欄位
countryCodes[]

string

(選用步驟) 搜尋突發洪水的國家/地區代碼。採用 ISO 3166 alpha-2 格式，例如「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

可能受暴洪影響的區域多邊形。您可以將多邊形 ID 傳送至 [serializedPolygons.get][google.research.floodforecasting.v1.GetSerializedPolygon]，以擷取事件區域的多邊形。
highlyLikelyAffectedPolygonId

string

暴洪極有可能影響的區域多邊形。您可以將多邊形 ID 傳送至 [serializedPolygons.get][google.research.floodforecasting.v1.GetSerializedPolygon]，以擷取事件區域的多邊形。
eventPolygonId

string

活動邊界區域的多邊形 ID。這是可能和極有可能多邊形的聯集。您可以將多邊形 ID 傳送至 [serializedPolygons.get][google.research.floodforecasting.v1.GetSerializedPolygon]，以擷取事件邊界區域的多邊形。