REST Resource: floodStatus

Ressource: FloodStatus

État d'inondation émis par le système. Représente l'état d'inondation prévu par le système pour une zone, avec des attributs tels que la gravité, l'évolution des prévisions, les cartes des inondations, etc. Pour en savoir plus, reportez-vous aux informations ci-dessous.

Représentation 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
}
Champs
gaugeId

string

Identifiant de la jauge pour laquelle cet état a été émis.

qualityVerified

boolean

"True" si la jauge pour laquelle l'état d'inondation a été émis ne possède pas de modèle, ou s'il possède un modèle dont la qualité a été vérifiée. Utilisez cette option avec prudence lorsque cette valeur est définie sur "false".

gaugeLocation

object (LatLng)

Emplacement de la jauge pour laquelle cet état a été émis.

issuedTime

string

Heure à laquelle cet état a été émis, sous forme de chaîne (ISO 8601), par exemple : "2023-06-17T10:34:00Z".

forecastTimeRange

object (TimeRange)

Période sur laquelle porte la prévision.

forecastChange

object (ForecastChange)

La valeur de prévision passe du dernier état connu à la prévision. Actuellement disponible uniquement pour les modèles de niveau d'eau.

forecastTrend

enum (ForecastTrend)

Tendance de la prévision.

mapInferenceType

enum (MapInferenceType)

Type d'inférence par lequel cette carte a été créée.

severity

enum (Severity)

Gravité de l'état.

inundationMapSet

object (InundationMapSet)

Carte des inondations déduites.

source

string

L'organisation responsable des données de cette jauge, par exemple, GRDC, CWC, etc.

serializedNotificationPolygonId

string

ID du polygone de notification sérialisé, qui représente la zone géographique utilisée par Google pour déterminer quand alerter ses utilisateurs. Utilisez serializedPolygons.get pour obtenir le polygone sérialisé lui-même.

TimeRange

Une période.

Représentation JSON
{
  "start": string,
  "end": string
}
Champs
start

string

Début de la période. Représenté au format ISO 8601, par exemple "2023-06-17T10:34:00Z".

end

string

Fin de la période. Représenté au format ISO 8601, par exemple "2023-06-17T10:34:00Z".

ForecastChange

La valeur prévue passe du dernier état connu à la prévision. Actuellement disponible uniquement pour les modèles de niveau d'eau.

Représentation JSON
{
  "valueChange": {
    object (ValueChange)
  },
  "referenceTimeRange": {
    object (TimeRange)
  }
}
Champs
valueChange

object (ValueChange)

Variation prévue des valeurs.

referenceTimeRange

object (TimeRange)

Période du dernier état connu à partir duquel nous prédisons le changement de valeur. Prenons l'exemple d'une période de référence définie sur "hier" et d'un changement de valeur compris entre 25 et 30 cm. Cela signifie que l'augmentation du niveau de l'eau de 25 à 30 cm est comparée à sa valeur d'hier, et non à sa valeur actuelle.

ValueChange

Variation des valeurs prévue (limites supérieure et inférieure).

Représentation JSON
{
  "lowerBound": number,
  "upperBound": number
}
Champs
lowerBound

number

Limite inférieure de l'évolution de la prévision en mètres. Si l'écart est compris entre 20 et 30, cette valeur sera de 20. Si l'écart est compris entre -30 et -20, cette valeur est -30.

upperBound

number

Limite supérieure de l'évolution de la prévision, en mètres. Si l'écart est compris entre 20 et 30, cette valeur est de 30. Si l'écart est compris entre -30 et -20, cette valeur est -20.

ForecastTrend

Énumération représentant la tendance de la prévision.

Enums
FORECAST_TREND_UNSPECIFIED Valeur par défaut. Cette valeur n'est pas utilisée.
RISE Cela indique une hausse de la valeur prévue.
FALL Cela indique une baisse de la valeur prévue.
NO_CHANGE Cela indique qu'il n'y a aucun changement dans la valeur prévue.

MapInferenceType

Énumération représentant les types d'inférences de carte.

Enums
MAP_INFERENCE_TYPE_UNSPECIFIED Valeur par défaut. Cette valeur n'est pas utilisée.
MODEL Cela indique que cette inférence a été créée à l'aide d'un modèle.
IMAGE_CLASSIFICATION Cela indique que cette inférence a été créée à l'aide d'une classification d'images.

Gravité

Énumération représentant la gravité de l'état.

Enums
SEVERITY_UNSPECIFIED Valeur par défaut. Cette valeur n'est pas utilisée.
EXTREME Cela indique un état extrême prévu.
SEVERE Cela indique un état grave prévu.
ABOVE_NORMAL Cela indique que les prévisions sont supérieures à la normale.
NO_FLOODING Cela indique une prévision d'absence d'inondations.
UNKNOWN Cela indique que nous ne disposons pas d'informations suffisantes pour déterminer le niveau de gravité.

InundationMapSet

Un ensemble de cartes d'inondations.

Représentation JSON
{
  "inundationMaps": [
    {
      object (InundationMap)
    }
  ],
  "inundationMapsTimeRange": {
    object (TimeRange)
  },
  "inundationMapType": enum (InundationMapType)
}
Champs
inundationMaps[]

object (InundationMap)

Cartes des inondations, une pour chaque niveau d'inondation

inundationMapsTimeRange

object (TimeRange)

Période de l'État auquel les cartes d'inondations se réfèrent.

inundationMapType

enum (InundationMapType)

Type de carte des inondations.

InundationMap

Une carte des inondations.

Représentation JSON
{
  "level": enum (InundationLevel),
  "serializedPolygonId": string
}
Champs
level

enum (InundationLevel)

Niveau de la carte des inondations : consultez la documentation concernant le type de carte Inundation.

serializedPolygonId

string

ID du polygone sérialisé représentant cette carte du risque d'inondations. Utilisez serializedPolygons.get pour obtenir le polygone sérialisé lui-même.

InundationLevel

Énumération représentant les niveaux d'inondation.

Enums
INUNDATION_LEVEL_UNSPECIFIED Valeur par défaut. Cette valeur n'est pas utilisée.
HIGH Consultez la documentation sur le type InundationMapType.
MEDIUM Consultez la documentation sur le type InundationMapType.
LOW Consultez la documentation sur le type InundationMapType.

InundationMapType

Énumération représentant le type de carte des inondations.

Enums
INUNDATION_MAP_TYPE_UNSPECIFIED Valeur par défaut. Cette valeur n'est pas utilisée.
PROBABILITY Carte de probabilité de type. Le niveau InundationLevel représente la probabilité de la carte, à savoir la probabilité élevée/moyenne/faible d'inondations. Le polygone à forte probabilité se trouve dans le polygone à probabilité moyenne, et le polygone à probabilité moyenne se trouve dans le polygone à faible probabilité.
DEPTH Carte de type "profondeur". Le niveau InundationLevel représente la profondeur de la carte (profondeur élevée, moyenne ou faible pour chaque lieu). Le polygone de grande profondeur est inclus dans le polygone de profondeur moyenne, et le polygone de profondeur moyenne se trouve dans celui de faible profondeur.

Méthodes

queryLatestFloodStatusByGaugeIds

Interrogez le dernier état d'inondation par ID de jauge.

searchLatestFloodStatusByArea

Recherchez l'état des inondations le plus récent par zone géographique.