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

Идентификатор датчика, для которого выдан этот статус.

qualityVerified

boolean

Верно, если у манометра, для которого был выдан этот статус затопления, нет модели или если у него есть модель и модель проверена на качество. Пожалуйста, используйте с осторожностью, если для этого значения установлено значение false.

gaugeLocation

object ( LatLng )

Местоположение датчика, для которого выдан данный статус.

issuedTime

string

Время, когда этот статус был выдан в виде строки (ISO 8601), например «2023-06-17T10:34:00Z».

forecastTimeRange

object ( TimeRange )

Временной диапазон, на который прогнозируется прогноз.

forecastChange

object ( ForecastChange )

Значение прогноза изменяется от последнего известного состояния к прогнозу. В настоящее время доступно только для моделей Water Level.

forecastTrend

enum ( ForecastTrend )

Тенденция прогноза.

mapInferenceType

enum ( MapInferenceType )

Тип вывода, по которому была создана эта карта.

severity

enum ( Severity )

Тяжесть статуса.

inundationMapSet

object ( InundationMapSet )

Набор предполагаемых карт затопления.

source

string

Организация, ответственная за данные этого датчика, например, GRDC, CWC и т. д.

serializedNotificationPolygonId

string

Идентификатор сериализованного многоугольника уведомлений, который представляет географическую область, которую Google использует, чтобы определить, когда предупреждать своих пользователей. Используйте serializedPolygons.get , чтобы получить сам сериализованный многоугольник.

Временной диапазон

Временной диапазон.

JSON-представление 
{
  "start": string,
  "end": string
}
Поля
start

string

Начало временного диапазона. Представлено как ISO 8601, например, «2023-06-17T10:34:00Z».

end

string

Конец временного диапазона. Представлено как ISO 8601, например «2023-06-17T10:34:00Z».

ПрогнозИзменить

Прогнозируемое значение изменяется от последнего известного состояния до прогнозируемого. В настоящее время доступно только для моделей Water Level.

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.

ПрогнозТренд

Перечисление, которое представляет тенденцию прогноза.

Перечисления
FORECAST_TREND_UNSPECIFIED Значение по умолчанию. Это значение не используется.
RISE Это свидетельствует о росте прогнозируемой стоимости.
FALL Это свидетельствует о падении прогнозируемой стоимости.
NO_CHANGE Это указывает на отсутствие изменений в прогнозируемом значении.

MapInferenceType

Перечисление, которое представляет типы выводов карты.

Перечисления
MAP_INFERENCE_TYPE_UNSPECIFIED Значение по умолчанию. Это значение не используется.
MODEL Это указывает на то, что этот вывод был создан с использованием модели.
IMAGE_CLASSIFICATION Это указывает на то, что этот вывод был создан с использованием классификации изображений.

Серьезность

Перечисление, которое представляет серьезность состояния.

Перечисления
SEVERITY_UNSPECIFIED Значение по умолчанию. Это значение не используется.
EXTREME Это указывает на прогнозируемое экстремальное состояние.
SEVERE Это указывает на прогнозируемое тяжелое состояние.
ABOVE_NORMAL Это указывает на прогнозируемое состояние выше нормы.
NO_FLOODING Это указывает на прогноз об отсутствии паводков.
UNKNOWN Это означает, что у нас недостаточно информации для определения серьезности.

НаводнениеMapSet

Набор карт затопления.

JSON-представление 
{
  "inundationMaps": [
    {
      object (InundationMap)
    }
  ],
  "inundationMapsTimeRange": {
    object (TimeRange)
  },
  "inundationMapType": enum (InundationMapType)
}
Поля
inundationMaps[]

object ( InundationMap )

Карты затопления, по одной для каждого уровня затопления.

inundationMapsTimeRange

object ( TimeRange )

Временной диапазон штата, к которому относятся карты затопления.

inundationMapType

enum ( InundationMapType )

Тип карты затопления.

Карта наводнений

Одна карта затопления.

JSON-представление 
{
  "level": enum (InundationLevel),
  "serializedPolygonId": string
}
Поля
level

enum ( InundationLevel )

Уровень карты затопления — см. документацию на основе InundationMapType.

serializedPolygonId

string

Идентификатор сериализованного многоугольника, представляющего эту карту риска наводнений. Используйте serializedPolygons.get , чтобы получить сам сериализованный многоугольник.

Уровень наводнения

Перечисление, которое представляет уровни наводнения.

Перечисления
INUNDATION_LEVEL_UNSPECIFIED Значение по умолчанию. Это значение не используется.
HIGH См. документацию на основе InundationMapType.
MEDIUM См. документацию на основе InundationMapType.
LOW См. документацию на основе InundationMapType.

Тип карты наводнения

Перечисление, представляющее тип карты затопления.

Перечисления
INUNDATION_MAP_TYPE_UNSPECIFIED Значение по умолчанию. Это значение не используется.
PROBABILITY Карта типа вероятности. InundationLevel представляет вероятность карты — высокая/средняя/низкая вероятность наводнения. Многоугольник высокой вероятности содержится в многоугольнике средней вероятности, а многоугольник средней вероятности содержится в многоугольнике низкой вероятности.
DEPTH Карта глубины типа. InundationLevel представляет глубину карты — высокую/среднюю/низкую глубину для каждой локации. Многоугольник большой глубины содержится в многоугольнике средней глубины, а многоугольник средней глубины содержится в многоугольнике низкой глубины.

Методы

queryLatestFloodStatusByGaugeIds

 Запросить статус последнего наводнения по идентификаторам датчиков.

searchLatestFloodStatusByArea

 Поиск последнего статуса наводнений по географическому региону.