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 厘米的水位升幅是与昨天（而不是现在）升高的值相比较的。

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

1 张洪灾地图。

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

 按地理区域搜索最新的洪灾状况。