Method: flashFloods.search

Recherchez les crues subites. Renvoie les derniers événements de crue éclair actifs ou prévus. Pour en savoir plus, consultez https://support.google.com/flood-hub/answer/16811681.

Requête HTTP

POST https://floodforecasting.googleapis.com/v1/flashFloods:search

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 
{
  "countryCodes": [
    string
  ],
  "pageSize": integer,
  "pageToken": string
}
Champs
countryCodes[]

string

Facultatif. Codes pays pour lesquels rechercher des crues soudaines. Au format ISO 3166 alpha-2, par exemple "US". Si vous ne l'indiquez pas, les crues soudaines pour tous les pays seront renvoyées.
pageSize

integer

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

string

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

Corps de la réponse

Réponse de [flashFloods.search][google.research.floodforecasting.v1.SearchLatestFlashFloods].

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

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

object (FlashFloodEvent)

Événements d'inondation soudaine trouvés en fonction des critères de la demande.
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.

FlashFloodEvent

Un événement de crue éclair. Il s'agit d'une période commençant à forecastIssueTime et durant forecastPeriodHours, au cours de laquelle nous prévoyons une crue soudaine.

Représentation JSON 
{
  "forecastIssueTime": string,
  "forecastPeriodHours": integer,
  "affectedCountryCodes": [
    string
  ],
  "likelyAffectedPolygonId": string,
  "highlyLikelyAffectedPolygonId": string,
  "eventPolygonId": string
}
Champs
forecastIssueTime

string

Heure à laquelle cette prévision a été émise. Représentée au format ISO 8601, par exemple "2025-10-17T10:34:00Z".
forecastPeriodHours

integer

Durée de validité des prévisions (en heures).
affectedCountryCodes[]

string

Pays qui devraient être touchés par l'événement, au format ISO 3166 alpha-2 (par exemple, "US").
likelyAffectedPolygonId

string

Polygone de la zone susceptible d'être touchée par une crue subite. L'ID du polygone peut être envoyé à [serializedPolygons.get][google.research.floodforecasting.v1.GetSerializedPolygon] pour récupérer le polygone de la zone de l'événement.
highlyLikelyAffectedPolygonId

string

Polygone de la zone qui est très susceptible d'être touchée par une crue subite. L'ID du polygone peut être envoyé à [serializedPolygons.get][google.research.floodforecasting.v1.GetSerializedPolygon] pour récupérer le polygone de la zone de l'événement.
eventPolygonId

string

ID du polygone de la zone de bordure de l'événement. Il s'agit de l'union des polygones "Probable" et "Très probable". L'ID du polygone peut être envoyé à [serializedPolygons.get][google.research.floodforecasting.v1.GetSerializedPolygon] pour récupérer le polygone de la zone frontalière de l'événement.