Method: flashFloods.search

Cerca inondazioni improvvise. Restituisce gli eventi di alluvione improvvisa più recenti attualmente attivi o previsti. Per maggiori dettagli, visita la pagina https://support.google.com/flood-hub/answer/16811681.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "countryCodes": [
    string
  ],
  "pageSize": integer,
  "pageToken": string
}
Campi
countryCodes[]

string

Facoltativo. I codici paese per la ricerca di inondazioni improvvise. Nel formato ISO 3166 alpha-2, ad esempio "US". Se non viene fornito alcun valore, verranno restituite le inondazioni improvvise per tutti i paesi.
pageSize

integer

Facoltativo. Il numero massimo di eventi da restituire. Il servizio potrebbe restituire un numero inferiore a questo valore. Se non specificato, verranno restituiti al massimo 10.000 eventi. Il valore massimo è 10.000; i valori superiori a 10.000 verranno forzati a 10.000.
pageToken

string

Facoltativo. Un token di pagina, ricevuto da una precedente chiamata flashFloods.search. Forniscilo per recuperare la pagina successiva. Durante la paginazione, tutti gli altri parametri forniti a flashFloods.search devono corrispondere alla chiamata che ha fornito il token di pagina.

Corpo della risposta

La risposta di [flashFloods.search][google.research.floodforecasting.v1.SearchLatestFlashFloods].

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "flashFloodEvents": [
    {
      object (FlashFloodEvent)
    }
  ],
  "nextPageToken": string
}
Campi
flashFloodEvents[]

object (FlashFloodEvent)

Gli eventi di inondazione improvvisa trovati in base ai criteri della richiesta.
nextPageToken

string

Facoltativo. Un token che può essere inviato come pageToken per recuperare la pagina successiva. Se questo campo viene omesso, non verranno visualizzate altre pagine.

FlashFloodEvent

Un evento di inondazione improvvisa. Rappresenta un periodo di tempo che inizia alle ore forecastIssueTime e dura forecastPeriodHours, durante il quale prevediamo che si verifichi un'inondazione improvvisa.

Rappresentazione JSON 
{
  "forecastIssueTime": string,
  "forecastPeriodHours": integer,
  "affectedCountryCodes": [
    string
  ],
  "likelyAffectedPolygonId": string,
  "highlyLikelyAffectedPolygonId": string,
  "eventPolygonId": string
}
Campi
forecastIssueTime

string

L'ora in cui è stata emessa questa previsione. Rappresentato come ISO 8601, ad es. "2025-10-17T10:34:00Z".
forecastPeriodHours

integer

Per quanto tempo è valida la previsione (in ore).
affectedCountryCodes[]

string

I paesi per i quali è previsto un impatto dell'evento, nel formato ISO 3166 alpha-2, ad esempio "US".
likelyAffectedPolygonId

string

Il poligono dell'area che probabilmente sarà interessata da un'inondazione improvvisa. L'ID poligono può essere inviato a [serializedPolygons.get][google.research.floodforecasting.v1.GetSerializedPolygon] per recuperare il poligono dell'area dell'evento.
highlyLikelyAffectedPolygonId

string

Il poligono dell'area che ha un'alta probabilità di essere interessata da un'inondazione improvvisa. L'ID poligono può essere inviato a [serializedPolygons.get][google.research.floodforecasting.v1.GetSerializedPolygon] per recuperare il poligono dell'area dell'evento.
eventPolygonId

string

L'ID poligono dell'area di confine dell'evento. Si tratta dell'unione dei poligoni probabili e molto probabili. L'ID poligono può essere inviato a [serializedPolygons.get][google.research.floodforecasting.v1.GetSerializedPolygon] per recuperare il poligono dell'area di confine dell'evento.