REST Resource: floodStatus

資源：FloodStatus

系統核發的洪水狀態。代表系統預測的區域洪水狀態，屬性包含嚴重程度、預測變化、洪水地圖和其他屬性。詳情請見下面的說明。

JSON 表示法 
{
  "gaugeId": string,
  "qualityVerified": boolean,
  "gaugeLocation": {
    object (LatLng)
  },
  "issuedTime": string,
  "forecastTimeRange": {
    object (TimeRange)
  },
  "forecastChange": {
    object (ForecastChange)
  },
  "forecastTrend": enum (ForecastTrend),
  "mapInferenceType": enum (MapInferenceType),
  "severity": enum (Severity),
  "inundationMapSet": {
    object (InundationMapSet)
  },
  "source": string,
  "serializedNotificationPolygonId": string
}
欄位
gaugeId

string

核發此狀態的度量表 ID。
qualityVerified

boolean

如果發出這項洪水狀態的測量結果沒有模型，或是設有模型且模型已通過品質驗證，則為 True。這個值設為 false 時請小心使用。
gaugeLocation

object (LatLng)

核發此狀態的測量位置。
issuedTime

string

此狀態發出為字串 (ISO 8601) 的時間，例如"2023-06-17T10:34:00Z".
forecastTimeRange

object (TimeRange)

預測作業所預測的時間範圍。
forecastChange

object (ForecastChange)

預測值會從上次已知的狀態變更為預測值。目前僅適用於水位模型。
forecastTrend

enum (ForecastTrend)

預測趨勢。
mapInferenceType

enum (MapInferenceType)

由建立此地圖的推論類型。
severity

enum (Severity)

狀態的嚴重性。
inundationMapSet

object (InundationMapSet)

推論地圖集。
source

string

負責計算此計量資料的機構，例如GRDC、CWC 等
serializedNotificationPolygonId

string

序列化通知多邊形 ID，代表 Google 用來判斷警示使用者時機的地理區域。使用 serializedPolygons.get 取得序列化的多邊形本身。

TimeRange

時間範圍。

JSON 表示法 
{
  "start": string,
  "end": string
}
欄位
start

string

時間範圍的開始時間。以 ISO 8601 表示，例如"2023-06-17T10:34:00Z".
end

string

時間範圍的結束時間。以 ISO 8601 表示，例如"2023-06-17T10:34:00Z".

ForecastChange

預測值會從上次已知的狀態變更為預測值。目前僅適用於水位模型。

JSON 表示法 
{
  "valueChange": {
    object (ValueChange)
  },
  "referenceTimeRange": {
    object (TimeRange)
  }
}
欄位
valueChange

object (ValueChange)

預測值的變化。
referenceTimeRange

object (TimeRange)

上次已知狀態的時間範圍，可用來預測該狀態的值變化。舉例來說，將參照時間範圍設為昨天，值則設為 25 到 30 公分。也就是說，系統會將水位上升 25-30 公分 (25-30 公分) 的值和昨天的值進行比較，

ValueChange

預測值變化 - 上限和下限。

JSON 表示法 
{
  "lowerBound": number,
  "upperBound": number
}
欄位
lowerBound

number

預測結果的下限 (以公尺為單位)。如果變更介於 20 到 30 之間，這個值會是 20；如果變動範圍介於 -30 到 -20 之間，這個值會是 -30。
upperBound

number

預測結果變更上限 (以公尺為單位)。如果變更介於 20 到 30 之間，這個值會是 30；如果變動範圍介於 -30 到 -20 之間，這個值會是 -20。

ForecastTrend

代表預測趨勢的列舉。

列舉
FORECAST_TREND_UNSPECIFIED 預設值。這個值未使用。
RISE 這表示預測值增加。
FALL 這表示預測值下滑。
NO_CHANGE 這表示預測值沒有變化。

MapInferenceType

列舉代表地圖推論類型的列舉。

列舉
MAP_INFERENCE_TYPE_UNSPECIFIED 預設值。這個值未使用。
MODEL 這表示推論是使用模型建立。
IMAGE_CLASSIFICATION 這表示推論是以圖片分類建立。

嚴重性

表示狀態嚴重性的列舉。

列舉
SEVERITY_UNSPECIFIED 預設值。這個值未使用。
EXTREME 這代表預測的極端狀態。
SEVERE 這表示預測狀態嚴重。
ABOVE_NORMAL 這表示預測值高於正常狀態。
NO_FLOODING 這代表沒有發生洪水的情況。
UNKNOWN 這表示我們沒有足夠的資訊判斷嚴重程度。

InundationMapSet

一組洪水對應圖。

JSON 表示法 
{
  "inundationMaps": [
    {
      object (InundationMap)
    }
  ],
  "inundationMapsTimeRange": {
    object (TimeRange)
  },
  "inundationMapType": enum (InundationMapType)
}
欄位
inundationMaps[]

object (InundationMap)

洪水對應，一個代表各個洪水等級。
inundationMapsTimeRange

object (TimeRange)

洪水地圖所參照狀態的時間範圍。
inundationMapType

enum (InundationMapType)

洪水地圖的類型。

InundationMap

一個洪水地圖。

JSON 表示法 
{
  "level": enum (InundationLevel),
  "serializedPolygonId": string
}
欄位
level

enum (InundationLevel)

洪流地圖的等級 - 請參閱以 InundationMapType 為基礎的說明文件。
serializedPolygonId

string

代表此異常風險圖的序列化多邊形 ID。使用 serializedPolygons.get 取得序列化的多邊形本身。

InundationLevel

表示中等強度等級的列舉。

列舉
INUNDATION_LEVEL_UNSPECIFIED 預設值。這個值未使用。
HIGH 請參閱以 InundationMapType 為基礎的說明文件。
MEDIUM 請參閱以 InundationMapType 為基礎的說明文件。
LOW 請參閱以 InundationMapType 為基礎的說明文件。

InundationMapType

列舉代表復原對應類型的列舉。

列舉
INUNDATION_MAP_TYPE_UNSPECIFIED 預設值。這個值未使用。
PROBABILITY 類型機率的對應。InundationLevel 是指發生洪水的機率高/中/低機率的地圖機率。中機率多邊形會包含在中機率多邊形內，而中機率多邊形也包含在低機率多邊形內。
DEPTH 類型深度圖。InundationLevel 代表地圖深度，- 每個位置的高/中/低深度。高深度多邊形包含在中等深度多邊形中，而中等深度多邊形就包含在低深度多邊形中。

方法

queryLatestFloodStatusByGaugeIds

 依測量 ID 查詢最新的洪水狀態。

searchLatestFloodStatusByArea

 依地理區域搜尋最新的洪水狀態。