REST Resource: floodStatus

Recurso: FloodStatus

Um status de inundação emitido pelo sistema. Representa o status de inundação previsto pelo sistema para uma área, com atributos como gravidade, mudança prevista, mapas de inundação e outros. Veja mais detalhes abaixo.

Representação 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

O ID do medidor para o qual esse status foi emitido.

qualityVerified

boolean

Verdadeiro se o medidor para o qual esse status de inundação foi emitido não tem um modelo ou se ele tem um modelo com a qualidade verificada. Use com cuidado quando esse valor for definido como falso.

gaugeLocation

object (LatLng)

O local do medidor para o qual esse status foi emitido.

issuedTime

string

A hora em que esse status foi emitido como uma string (ISO 8601), por exemplo, "2023-06-17T10:34:00Z".

forecastTimeRange

object (TimeRange)

É o período de previsão da previsão.

forecastChange

object (ForecastChange)

O valor da previsão muda do último estado conhecido para a previsão. Atualmente disponível apenas para modelos de nível de água.

forecastTrend

enum (ForecastTrend)

É a tendência da previsão.

mapInferenceType

enum (MapInferenceType)

O tipo de inferência usado para criar este mapa.

severity

enum (Severity)

A gravidade do status.

inundationMapSet

object (InundationMapSet)

O conjunto de mapas de inundação inferido.

source

string

A organização responsável pelos dados deste medidor, por exemplo, GRDC, CWC etc.

serializedNotificationPolygonId

string

ID do polígono de notificação serializado, que representa a área geográfica que o Google usa para determinar quando alertar os usuários. Use serializedPolygons.get para receber o próprio polígono serializado.

TimeRange

Um período.

Representação JSON
{
  "start": string,
  "end": string
}
Campos
start

string

O início do período. Representado como ISO 8601, por exemplo, "2023-06-17T10:34:00Z".

end

string

Fim do período. Representado como ISO 8601, por exemplo, "2023-06-17T10:34:00Z".

ForecastChange

A alteração do valor previsto do último estado conhecido para a previsão. Atualmente disponível apenas para modelos de nível de água.

Representação JSON
{
  "valueChange": {
    object (ValueChange)
  },
  "referenceTimeRange": {
    object (TimeRange)
  }
}
Campos
valueChange

object (ValueChange)

A alteração prevista nos valores.

referenceTimeRange

object (TimeRange)

Intervalo de tempo do último estado conhecido, de onde prevemos a mudança de valor. Por exemplo, podemos ter um período de referência definido como ontem e uma mudança de valor de 25 a 30 cm. Isso significa que o aumento no nível da água de 25 a 30 cm é comparado ao valor de ontem, não do valor atual.

ValueChange

A alteração prevista nos valores - um limite superior e inferior.

Representação JSON
{
  "lowerBound": number,
  "upperBound": number
}
Campos
lowerBound

number

O limite inferior da mudança prevista em metros. Se a alteração estiver entre 20 e 30, esse valor será 20. Se a alteração estiver entre -30 e -20, esse valor será -30.

upperBound

number

O limite superior da mudança prevista em metros. Se a alteração estiver entre 20 e 30, esse valor será 30. Se a alteração estiver entre -30 e -20, esse valor será -20.

ForecastTrend

Um tipo enumerado que representa a tendência da previsão.

Enums
FORECAST_TREND_UNSPECIFIED Valor padrão. Esse valor não é usado.
RISE Isso indica um aumento no valor previsto.
FALL Isso indica uma queda no valor previsto.
NO_CHANGE Isso indica que não há mudança no valor previsto.

MapInferenceType

Um enum que representa os tipos de inferências de mapa.

Enums
MAP_INFERENCE_TYPE_UNSPECIFIED Valor padrão. Esse valor não é usado.
MODEL Isso indica que essa inferência foi criada usando um modelo.
IMAGE_CLASSIFICATION Isso indica que essa inferência foi criada usando uma classificação de imagem.

Gravidade

Um enum que representa a gravidade do status.

Enums
SEVERITY_UNSPECIFIED Valor padrão. Esse valor não é usado.
EXTREME Isso indica um status extremo previsto.
SEVERE Isso indica um status grave previsto.
ABOVE_NORMAL Indica um status previsto acima do normal.
NO_FLOODING Isso indica uma previsão de ausência de inundação.
UNKNOWN Isso indica que não temos informações suficientes para determinar a gravidade.

InundationMapSet

Um conjunto de mapas de inundação.

Representação JSON
{
  "inundationMaps": [
    {
      object (InundationMap)
    }
  ],
  "inundationMapsTimeRange": {
    object (TimeRange)
  },
  "inundationMapType": enum (InundationMapType)
}
Campos
inundationMaps[]

object (InundationMap)

São os mapas de inundação, um para cada nível.

inundationMapsTimeRange

object (TimeRange)

O intervalo de tempo do estado ao qual os mapas de inundação se referem.

inundationMapType

enum (InundationMapType)

O tipo do mapa de inundação.

InundationMap

Um mapa de inundação.

Representação JSON
{
  "level": enum (InundationLevel),
  "serializedPolygonId": string
}
Campos
level

enum (InundationLevel)

O nível do mapa de inundação - Consulte a documentação baseada em InundationMapType.

serializedPolygonId

string

ID do polígono serializado que representa esse mapa de risco de inundação. Use serializedPolygons.get para receber o próprio polígono serializado.

InundationLevel

Um enum que representa os níveis de inundação.

Enums
INUNDATION_LEVEL_UNSPECIFIED Valor padrão. Esse valor não é usado.
HIGH Consulte a documentação baseada em InundationMapType.
MEDIUM Consulte a documentação baseada em InundationMapType.
LOW Consulte a documentação baseada em InundationMapType.

InundationMapType

Um enum que representa o tipo do mapa de inundação.

Enums
INUNDATION_MAP_TYPE_UNSPECIFIED Valor padrão. Esse valor não é usado.
PROBABILITY Um mapa do tipo de probabilidade. O nível InundationLevel representa a probabilidade do mapa, alta/média/baixa de inundação. O polígono de probabilidade média está dentro do polígono de probabilidade média, e o polígono de probabilidade média está no polígono de probabilidade baixa.
DEPTH Um mapa de profundidade de tipo. O InundationLevel representa a profundidade do mapa, ou seja, alta/média/baixa por local. O polígono de alta profundidade está dentro do polígono de profundidade média, e o polígono de profundidade média está dentro do polígono de baixa profundidade.

Métodos

queryLatestFloodStatusByGaugeIds

Consulte o status mais recente da inundação pelos IDs do medidor.

searchLatestFloodStatusByArea

Pesquise o status mais recente de inundação por área geográfica.