Method: floodStatus.searchLatestFloodStatusByArea

Recherchez l'état des inondations les plus récentes par zone géographique. Remarque : Renvoie les états d'inondation dont la jauge se trouve dans la zone donnée, par opposition à la zone touchée qui croise la zone donnée, par exemple. Cette offre est susceptible d'évoluer à l'avenir.

Requête HTTP

POST https://floodforecasting.googleapis.com/v1/floodStatus:searchLatestFloodStatusByArea

L'URL utilise la syntaxe de transcodage gRPC.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "cutoffTime": string,
  "pageToken": string,
  "pageSize": integer,

  // Union field area_type can be only one of the following:
  "regionCode": string,
  "loop": {
    object (Loop)
  }
  // End of list of possible types for union field area_type.
  "includeNonQualityVerified": boolean
}
Champs
cutoffTime

string

Facultatif. Facultatif. Heure limite pour les états d'inondation. Si des informations sont fournies, les derniers états d'inondation (derniers états publiés) à la date limite seront renvoyés. Si aucune date n'est fournie, les derniers états d'inondation publiés à ce jour seront renvoyés. La date limite minimale autorisée est le 1er août 2025 à 00h00 UTC. Si l'heure limite est antérieure à cette heure, une erreur INVALID_ARGUMENT sera renvoyée. Représenté au format ISO 8601, par exemple : "2025-10-17T10:34:00Z".
pageToken

string

Facultatif. Jeton de page reçu d'un appel floodStatus.searchLatestFloodStatusByArea précédent. Fournissez-le pour récupérer la page suivante. Lors de la pagination, tous les autres paramètres fournis à floodStatus.searchLatestFloodStatusByArea doivent correspondre à l'appel ayant fourni le jeton de page.
pageSize

integer

Facultatif. Nombre maximal d'états d'inondation à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur. Si aucune valeur n'est spécifiée, 20 000 statuts d'inondation au maximum sont renvoyés. La valeur maximale est 20 000. Les valeurs supérieures sont réduites à 20 000.

Champ d'union area_type.

area_type ne peut être qu'un des éléments suivants :
regionCode

string

Région pour laquelle interroger les états des inondations. Utilisez CLDR, par exemple : 'US'.
loop

object (Loop)

Boucle par laquelle interroger les états d'inondation.
includeNonQualityVerified

boolean

Facultatif. Incluez dans les résultats les jauges dont la qualité n'a pas été vérifiée. Veuillez l'utiliser avec précaution. La valeur par défaut est "false".

Corps de la réponse

Réponse de floodStatus.searchLatestFloodStatusByArea.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "floodStatuses": [
    {
      object (FloodStatus)
    }
  ],
  "nextPageToken": string
}
Champs
floodStatuses[]

object (FloodStatus)

Les derniers états des inondations dans la zone demandée. Actuellement, cela dépend de l'emplacement des jauges, mais cela peut changer à l'avenir.
nextPageToken

string

Facultatif. Jeton pouvant être envoyé en tant que pageToken pour récupérer la page suivante. Si ce champ est omis, il n'y a pas d'autres pages.