REST Resource: floodStatus

Risorsa: FloodStatus

Uno stato di inondazione emesso dal sistema. Rappresenta lo stato di inondazione previsto dal sistema per un'area, con attributi come gravità, modifica prevista, mappe di inondazione e altri. Per ulteriori dettagli, continua a leggere.

Rappresentazione 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
}
Campi
gaugeId

string

ID dell'indicatore per il quale è stato emesso questo stato.
qualityVerified

boolean

True se il misuratore per cui è stato emesso lo stato di inondazione non ha un modello o se è presente un modello e il modello è con qualità verificata. Da utilizzare con cautela quando questo valore è impostato su false.
gaugeLocation

object (LatLng)

La posizione del misuratore per cui è stato emesso questo stato.
issuedTime

string

L'ora in cui questo stato è stato emesso come stringa (ISO 8601), ad esempio "2023-06-17T10:34:00Z".
forecastTimeRange

object (TimeRange)

L'intervallo di tempo per il quale è prevista la previsione.
forecastChange

object (ForecastChange)

Il valore di previsione passa dall'ultimo stato noto alla previsione. Attualmente disponibile solo per i modelli di livello dell'acqua.
forecastTrend

enum (ForecastTrend)

La tendenza della previsione.
mapInferenceType

enum (MapInferenceType)

Il tipo di inferenza da cui è stata creata questa mappa.
severity

enum (Severity)

La gravità dello stato.
inundationMapSet

object (InundationMapSet)

L'insieme di mappe di inondazione dedotta.
source

string

L'organizzazione responsabile dei dati di questo indicatore, ad esempio GRDC, CWC e così via.
serializedNotificationPolygonId

string

L'ID del poligono di notifica serializzato, che rappresenta l'area geografica utilizzata da Google per determinare quando avvisare i suoi utenti. Usa serializedPolygons.get per recuperare il poligono serializzato stesso.

TimeRange

Un intervallo di tempo.

Rappresentazione JSON 
{
  "start": string,
  "end": string
}
Campi
start

string

L'inizio dell'intervallo di tempo. Rappresentato come ISO 8601, ad es. "2023-06-17T10:34:00Z".
end

string

La fine dell'intervallo di tempo. Rappresentato come ISO 8601, ad es. "2023-06-17T10:34:00Z".

ForecastChange

La variazione del valore previsto dall'ultimo stato noto alla previsione. Attualmente disponibile solo per i modelli di livello dell'acqua.

Rappresentazione JSON 
{
  "valueChange": {
    object (ValueChange)
  },
  "referenceTimeRange": {
    object (TimeRange)
  }
}
Campi
valueChange

object (ValueChange)

La variazione di valori prevista.
referenceTimeRange

object (TimeRange)

Intervallo di tempo dell'ultimo stato noto, da cui è prevista la variazione del valore. Ad esempio, potremmo avere un intervallo di tempo di riferimento impostato su ieri e una variazione di valore di 25-30 cm. Ciò significa che l'aumento del livello dell'acqua di 25-30 cm è stato confrontato con il suo valore di ieri, non rispetto a quello attuale.

ValueChange

La modifica prevista nei valori: un limite superiore e un limite inferiore.

Rappresentazione JSON 
{
  "lowerBound": number,
  "upperBound": number
}
Campi
lowerBound

number

Il limite inferiore della variazione di previsione in metri. Se la variazione è compresa tra 20 e 30, questo valore sarà 20. Se la variazione è compresa tra -30 e -20, questo valore sarà -30.
upperBound

number

Il limite superiore della variazione di previsione in metri. Se la variazione è compresa tra 20 e 30, questo valore sarà 30. Se la variazione è compresa tra -30 e -20, questo valore sarà -20.

ForecastTrend

Un'enumerazione che rappresenta la tendenza della previsione.

Enum
FORECAST_TREND_UNSPECIFIED Valore predefinito. Questo valore non è utilizzato.
RISE Ciò indica un aumento del valore previsto.
FALL Indica una diminuzione del valore previsto.
NO_CHANGE Questo indica che non è stata prevista alcuna variazione nel valore previsto.

MapInferenceType

Un'enumerazione che rappresenta i tipi di inferenze sulla mappa.

Enum
MAP_INFERENCE_TYPE_UNSPECIFIED Valore predefinito. Questo valore non è utilizzato.
MODEL Ciò indica che questa inferenza è stata creata utilizzando un modello.
IMAGE_CLASSIFICATION Ciò indica che questa inferenza è stata creata utilizzando una classificazione delle immagini.

Gravità

Un'enumerazione che rappresenta la gravità dello stato.

Enum
SEVERITY_UNSPECIFIED Valore predefinito. Questo valore non è utilizzato.
EXTREME Indica uno stato estremo previsto.
SEVERE Questo indica uno stato previsto grave.
ABOVE_NORMAL Indica uno stato previsto superiore al normale.
NO_FLOODING Questo indica una previsione di assenza di inondazioni.
UNKNOWN Ciò indica che non disponiamo di informazioni sufficienti per determinare la gravità.

InundationMapSet

Un insieme di mappe di inondazione.

Rappresentazione JSON 
{
  "inundationMaps": [
    {
      object (InundationMap)
    }
  ],
  "inundationMapsTimeRange": {
    object (TimeRange)
  },
  "inundationMapType": enum (InundationMapType)
}
Campi
inundationMaps[]

object (InundationMap)

Le mappe di inondazione, una per ogni livello di inondazione.
inundationMapsTimeRange

object (TimeRange)

L'intervallo di tempo dello stato a cui fanno riferimento le mappe di inondazione.
inundationMapType

enum (InundationMapType)

Il tipo di mappa di inondazione.

InundationMap

Una mappa di inondazione.

Rappresentazione JSON 
{
  "level": enum (InundationLevel),
  "serializedPolygonId": string
}
Campi
level

enum (InundationLevel)

Il livello della mappa di inondazione: consulta la documentazione basata su InundationMapType.
serializedPolygonId

string

Un ID del poligono serializzato che rappresenta questa mappa del rischio di inondazione. Usa serializedPolygons.get per recuperare il poligono serializzato stesso.

InundationLevel

Un'enumerazione che rappresenta i livelli di inondazione.

Enum
INUNDATION_LEVEL_UNSPECIFIED Valore predefinito. Questo valore non è utilizzato.
HIGH Consulta la documentazione basata su InundationMapType.
MEDIUM Consulta la documentazione basata su InundationMapType.
LOW Consulta la documentazione basata su InundationMapType.

InundationMapType

Un'enumerazione che rappresenta il tipo di mappa di inondazione.

Enum
INUNDATION_MAP_TYPE_UNSPECIFIED Valore predefinito. Questo valore non è utilizzato.
PROBABILITY Una mappa di probabilità di tipo. Il livello InundationLevel rappresenta la probabilità della mappa: probabilità alta/media/bassa di inondazione. Il poligono ad alta probabilità si trova all'interno di quello a probabilità media, mentre il poligono a probabilità media si trova all'interno di quello a probabilità media.
DEPTH Una mappa con profondità di tipo. InundationLevel rappresenta la profondità della mappa (alta/media/bassa profondità per località). Il poligono ad alta profondità si trova all'interno del poligono di profondità media, mentre il poligono di media profondità si trova all'interno di quello a bassa profondità.

Metodi

queryLatestFloodStatusByGaugeIds

 Esegui una query sullo stato di inondazione più recente tramite ID misuratore.

searchLatestFloodStatusByArea

 Cerca lo stato di inondazione più recente per area geografica.