REST Resource: floodStatus

Recurso: FloodStatus

Un estado de inundación emitido por el sistema. Representa el estado de inundación que prevé el sistema para un área, con atributos como la gravedad, el cambio previsto y los mapas de inundaciones, entre otros. Consulte la siguiente información para obtener más detalles.

Representación 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
}
Campos
gaugeId

string

Es el ID del indicador para el que se emitió este estado.
qualityVerified

boolean

Verdadero si el indicador para el que se emitió este estado de inundación no tiene un modelo o si tiene un modelo y el modelo está verificado de calidad. Úsalo con cuidado cuando este valor se establezca como falso.
gaugeLocation

object (LatLng)

Es la ubicación del indicador para el que se emitió este estado.
issuedTime

string

La hora en que se emitió este estado como string (ISO 8601), p.ej., "2023-06-17T10:34:00Z".
forecastTimeRange

object (TimeRange)

Es el intervalo de tiempo para el que se predice la previsión.
forecastChange

object (ForecastChange)

El valor de previsión cambia del último estado conocido a la previsión. Actualmente, solo está disponible para modelos a nivel del agua.
forecastTrend

enum (ForecastTrend)

La tendencia de la previsión.
mapInferenceType

enum (MapInferenceType)

El tipo de inferencia por el que se creó este mapa.
severity

enum (Severity)

Indica la gravedad del estado.
inundationMapSet

object (InundationMapSet)

El conjunto de mapas de inundaciones inferidos.
source

string

La organización responsable de los datos de este indicador, p.ej., GRDC, CWC, etcétera.
serializedNotificationPolygonId

string

Un ID del polígono de notificaciones serializadas, que representa el área geográfica que usa Google para determinar cuándo alertar a sus usuarios. Usa serializedPolygons.get para obtener el polígono serializado en sí.

TimeRange

Es un intervalo de tiempo.

Representación JSON 
{
  "start": string,
  "end": string
}
Campos
start

string

Inicio del intervalo de tiempo. Se representa como ISO 8601, p.ej., "2023-06-17T10:34:00Z".
end

string

Final del intervalo de tiempo. Se representa como ISO 8601, p.ej., "2023-06-17T10:34:00Z".

ForecastChange

El valor previsto cambia del último estado conocido a la previsión. Actualmente, solo está disponible para modelos a nivel del agua.

Representación JSON 
{
  "valueChange": {
    object (ValueChange)
  },
  "referenceTimeRange": {
    object (TimeRange)
  }
}
Campos
valueChange

object (ValueChange)

Es el cambio previsto en los valores.
referenceTimeRange

object (TimeRange)

Intervalo de tiempo del último estado conocido, a partir del cual predecimos el cambio de valor. Por ejemplo, podemos tener un intervalo de tiempo de referencia establecido en ayer y un cambio de valor de 25 a 30 cm. Esto significa que el aumento del nivel del agua, de 25 a 30 cm, se compara con su valor de ayer, no con su valor actual.

ValueChange

El cambio previsto en los valores; el límite inferior y superior.

Representación JSON 
{
  "lowerBound": number,
  "upperBound": number
}
Campos
lowerBound

number

Es el límite inferior del cambio de pronóstico en metros. Si el cambio está entre 20 y 30, este valor sería 20. Si el cambio está entre -30 y -20, este valor sería -30.
upperBound

number

Es el límite superior del cambio de previsión en metros. Si el cambio está entre 20 y 30, este valor sería 30. Si el cambio está entre -30 y -20, este valor sería -20.

ForecastTrend

Una enumeración que representa la tendencia de la previsión.

Enumeraciones
FORECAST_TREND_UNSPECIFIED Valor predeterminado Este valor no se usa.
RISE Esto indica un aumento en el valor previsto.
FALL Esto indica una caída en el valor previsto.
NO_CHANGE Esto indica que no hay cambios en el valor previsto.

MapInferenceType

Una enumeración que representa tipos de inferencias de mapas.

Enumeraciones
MAP_INFERENCE_TYPE_UNSPECIFIED Valor predeterminado Este valor no se usa.
MODEL Esto indica que esta inferencia se creó usando un modelo.
IMAGE_CLASSIFICATION Esto indica que esta inferencia se creó con una clasificación de imágenes.

Gravedad

Una enumeración que representa la gravedad del estado.

Enumeraciones
SEVERITY_UNSPECIFIED Valor predeterminado Este valor no se usa.
EXTREME Esto indica un estado extremo previsto.
SEVERE Esto indica un estado grave previsto.
ABOVE_NORMAL Esto indica un estado previsto por encima de lo normal.
NO_FLOODING Esto indica un pronóstico de que no habrá inundaciones.
UNKNOWN Esto indica que no tenemos suficiente información para determinar la gravedad.

InundationMapSet

Es un conjunto de mapas de inundaciones.

Representación JSON 
{
  "inundationMaps": [
    {
      object (InundationMap)
    }
  ],
  "inundationMapsTimeRange": {
    object (TimeRange)
  },
  "inundationMapType": enum (InundationMapType)
}
Campos
inundationMaps[]

object (InundationMap)

Los mapas de inundaciones, uno para cada nivel de inundación.
inundationMapsTimeRange

object (TimeRange)

El intervalo de tiempo del estado al que hacen referencia los mapas de inundaciones.
inundationMapType

enum (InundationMapType)

Es el tipo de mapa de inundaciones.

InundationMap

Un mapa de inundaciones.

Representación JSON 
{
  "level": enum (InundationLevel),
  "serializedPolygonId": string
}
Campos
level

enum (InundationLevel)

El nivel del mapa de inundaciones. Consulta la documentación basada en InundationMapType.
serializedPolygonId

string

Es un ID del polígono serializado que representa este mapa de riesgo de inundación. Usa serializedPolygons.get para obtener el polígono serializado en sí.

InundationLevel

Una enumeración que representa los niveles de inundación.

Enumeraciones
INUNDATION_LEVEL_UNSPECIFIED Valor predeterminado Este valor no se usa.
HIGH Consulta la documentación basada en InundationMapType.
MEDIUM Consulta la documentación basada en InundationMapType.
LOW Consulta la documentación basada en InundationMapType.

InundationMapType

Una enumeración que representa el tipo de mapa de inundaciones.

Enumeraciones
INUNDATION_MAP_TYPE_UNSPECIFIED Valor predeterminado Este valor no se usa.
PROBABILITY Es un mapa de probabilidad de tipo. El valor de InundationLevel representa la probabilidad de una inundación en el mapa, es decir, alta, media o baja. El polígono de probabilidad alta está contenido dentro del polígono de probabilidad media y el polígono de probabilidad media se encuentra dentro del polígono de baja probabilidad.
DEPTH Un mapa de profundidad de tipos. El valor de InundationLevel representa la profundidad del mapa (profundidad alta, media o baja por ubicación). El polígono de profundidad alta se encuentra dentro del de profundidad media, mientras que el de profundidad media se encuentra dentro del de baja profundidad.

Métodos

queryLatestFloodStatusByGaugeIds

 Consulta el estado de inundación más reciente mediante los IDs de los indicadores.

searchLatestFloodStatusByArea

 Buscar el estado de inundación más reciente por área geográfica.