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

이 홍수 상태가 발행된 게이지에 모델이 없거나 모델이 있으며 모델의 품질이 검증된 경우 참입니다. 이 값이 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~30cm일 수 있습니다. 즉, 수위가 25~30cm 상승하면 현재 수위가 아니라 어제 수위와 비교됩니다.

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

 지역별로 최근 홍수 상태를 검색합니다.