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 cm にできます。これは、25 ~ 30 cm の水位の上昇を、現在の値ではなく昨日の値と比較したことを意味します。

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)

浸水マップ(洪水レベルごとに 1 つ)。

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 型の depth のマップ。InundationLevel は、地図の深度(場所ごとに高/中/低深度)を表します。高深度ポリゴンは中深度ポリゴン内に収容され、中深度ポリゴンは低深度ポリゴン内に収容されます。

メソッド

queryLatestFloodStatusByGaugeIds

ゲージ ID で最新の洪水状況をクエリします。

searchLatestFloodStatusByArea

地域別の最新の洪水状況を検索できます。