Method: floodStatus.searchLatestFloodStatusByArea

按地理区域搜索最新的洪水状态。注意：返回的洪水状态的水位计 位于给定区域内，而不是例如受影响的区域与给定区域相交。但将来这项优惠可能会发生变化。

HTTP 请求

POST https://floodforecasting.googleapis.com/v1/floodStatus:searchLatestFloodStatusByArea

网址采用 gRPC 转码语法。

请求正文

请求正文中包含结构如下的数据：

JSON 表示法 
{
  "cutoffTime": string,
  "pageToken": string,
  "pageSize": integer,

  // Union field area_type can be only one of the following:
  "regionCode": string,
  "loop": {
    object (Loop)
  }
  // End of list of possible types for union field area_type.
  "includeNonQualityVerified": boolean
}
字段
cutoffTime

string

可选。洪水状态的截止时间。如果提供此字段，系统将返回截止时间之前的最新（上次发布）洪水状态。如果未提供此字段，系统将返回截至目前的最新发布洪水状态。允许的最小截止时间为 2025-08-01T00:00:00Z。如果截止时间早于此时间，系统将返回 INVALID_ARGUMENT 错误。以 ISO 8601 格式表示，例如“2025-10-17T10:34:00Z”。
pageToken

string

可选。从之前的 floodStatus.searchLatestFloodStatusByArea 调用接收的页面令牌。提供此令牌可检索后续页面。进行分页时，提供给 floodStatus.searchLatestFloodStatusByArea 的所有其他参数必须与提供页面令牌的调用匹配。
pageSize

integer

可选。要返回的洪水状态数量上限。服务返回的值可能小于此值。如果未指定，则最多返回 20,000 个洪水状态。最大值为 20,000；如果值高于 20,000，系统会强制将其设为 20,000。

联合字段 area_type。

area_type 只能是下列其中一项：
regionCode

string

用于查询洪水状态的区域。使用 CLDR，例如“US”。
loop

object (Loop)

用于查询洪水状态的环路。
includeNonQualityVerified

boolean

可选。在结果中包含未经过质量验证的测量仪。请谨慎使用。默认值为 false。

响应正文

floodStatus.searchLatestFloodStatusByArea 的响应。

如果成功，响应正文将包含结构如下的数据：

JSON 表示法 
{
  "floodStatuses": [
    {
      object (FloodStatus)
    }
  ],
  "nextPageToken": string
}
字段
floodStatuses[]

object (FloodStatus)

所请求区域中的最新洪水状态。目前，此字段由测量仪的位置决定，但将来可能会发生变化。
nextPageToken

string

可选。可作为 pageToken 发送并用于检索下一页的令牌。如果省略此字段，则不存在后续页面。