Method: floodStatus.queryLatestFloodStatusByGaugeIds

依水位計 ID 查詢最新洪水狀態。

HTTP 要求

GET https://floodforecasting.googleapis.com/v1/floodStatus:queryLatestFloodStatusByGaugeIds

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

查詢參數

參數
gaugeIds[]

string

必要欄位。量規 ID 清單。支援的清單大小上限為 20,000。如果提供的清單超過 20,000 個項目，系統會傳回 INVALID_REQUEST 錯誤。
cutoffTime

string

(選用步驟) (選用步驟) 洪水狀態的截止時間。如果提供這項資訊，系統會傳回截至截止時間的最新 (上次發布) 淹水狀態。如未提供，系統會傳回目前發布的最新淹水狀態。可接受的最早截止時間為 2025 年 8 月 1 日 00:00:00 (UTC)。如果截止時間早於這個時間，系統會傳回 INVALID_ARGUMENT 錯誤。以 ISO 8601 格式表示，例如 "2025-10-17T10:34:00Z".

要求主體

要求主體必須為空白。

回應主體

floodStatus.queryLatestFloodStatusByGaugeIds 的回應。

如果成功，回應主體會含有以下結構的資料：

JSON 表示法 
{
  "floodStatuses": [
    {
      object (FloodStatus)
    }
  ]
}
欄位
floodStatuses[]

object (FloodStatus)

所要求水位計的最新洪水狀態。