按水位计 ID 查询最新洪水状态。
HTTP 请求
GET https://floodforecasting.googleapis.com/v1/floodStatus:queryLatestFloodStatusByGaugeIds
网址采用 gRPC 转码语法。
查询参数
| 参数 | |
|---|---|
gaugeIds[] |
必需。指标 ID 列表。支持的名单规模上限为 2 万。如果提供的列表包含的元素超过 20,000 个,则会失败并显示 INVALID_REQUEST 错误。 |
cutoffTime |
可选。可选。洪灾状态的截止时间。如果提供,则返回截至截止时间为止的最新(上次发布)洪水状态。如果未提供,则返回截至目前为止最新发布的洪水状态。允许的最早截止时间为 2025-08-01T00:00:00Z。如果截止时间早于此时间,系统会返回 INVALID_ARGUMENT 错误。以 ISO 8601 格式表示,例如 "2025-10-17T10:34:00Z". |
请求正文
请求正文必须为空。
响应正文
floodStatus.queryLatestFloodStatusByGaugeIds 的响应。
如果成功,响应正文将包含结构如下的数据:
| JSON 表示法 |
|---|
{
"floodStatuses": [
{
object ( |
| 字段 | |
|---|---|
floodStatuses[] |
所请求水位计的最新洪水状态。 |