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 的值会强制转换为 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

活动边界区域的 polygon ID。这是可能多边形和极可能多边形的并集。可以将多边形 ID 发送到 [serializedPolygons.get][google.research.floodforecasting.v1.GetSerializedPolygon]，以检索事件边界区域的多边形。