Method: flashFloods.search

Busca inundaciones repentinas. Devuelve los eventos de inundación repentina activos o previstos más recientes. Consulta https://support.google.com/flood-hub/answer/16811681 para obtener más detalles.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación de gRPC.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON
{
  "countryCodes": [
    string
  ],
  "pageSize": integer,
  "pageToken": string
}
Campos
countryCodes[]

string

Opcional. Son los códigos de país para buscar inundaciones repentinas. En formato ISO 3166 alfa-2, p.ej., "US". Si no se proporciona, se mostrarán las inundaciones repentinas de todos los países.

pageSize

integer

Opcional. Es la cantidad máxima de eventos que se devolverán. El servicio puede mostrar menos que este valor. Si no se especifica, se devolverán, como máximo, 10,000 eventos. El valor máximo es 10,000,y los valores superiores se convertirán a 10,000.

pageToken

string

Opcional. Un token de página, recibido desde una llamada flashFloods.search anterior. Proporciona esto para recuperar la página siguiente. Cuando se realiza la paginación, todos los demás parámetros proporcionados a flashFloods.search deben guardar correspondencia con la llamada que proporcionó el token de la página.

Cuerpo de la respuesta

Es la respuesta de [flashFloods.search][google.research.floodforecasting.v1.SearchLatestFlashFloods].

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON
{
  "flashFloodEvents": [
    {
      object (FlashFloodEvent)
    }
  ],
  "nextPageToken": string
}
Campos
flashFloodEvents[]

object (FlashFloodEvent)

Son los eventos de inundaciones repentinas que se encontraron según los criterios de la solicitud.

nextPageToken

string

Opcional. Es un token que se puede enviar como pageToken para recuperar la página siguiente. Si se omite este campo, no habrá páginas siguientes.

FlashFloodEvent

Evento de inundación repentina. Representa un período que comienza en forecastIssueTime y dura forecastPeriodHours, dentro del cual esperamos que ocurra una inundación repentina.

Representación JSON
{
  "forecastIssueTime": string,
  "forecastPeriodHours": integer,
  "affectedCountryCodes": [
    string
  ],
  "likelyAffectedPolygonId": string,
  "highlyLikelyAffectedPolygonId": string,
  "eventPolygonId": string
}
Campos
forecastIssueTime

string

Es la fecha y hora en que se emitió este pronóstico. Se representa como ISO 8601, p.ej., "2025-10-17T10:34:00Z".

forecastPeriodHours

integer

Período durante el que es válida la previsión (en horas).

affectedCountryCodes[]

string

Son los países que se prevé que se verán afectados por el evento, en formato ISO 3166 alfa-2, p.ej., "US".

likelyAffectedPolygonId

string

Es el polígono del área que probablemente se verá afectada por una inundación repentina. El ID del polígono se puede enviar a [serializedPolygons.get][google.research.floodforecasting.v1.GetSerializedPolygon] para recuperar el polígono del área del evento.

highlyLikelyAffectedPolygonId

string

Es el polígono del área que es muy probable que se vea afectada por una inundación repentina. El ID del polígono se puede enviar a [serializedPolygons.get][google.research.floodforecasting.v1.GetSerializedPolygon] para recuperar el polígono del área del evento.

eventPolygonId

string

Es el ID del polígono del área fronteriza del evento. Es la unión de los polígonos de probabilidad alta y muy alta. El ID del polígono se puede enviar a [serializedPolygons.get][google.research.floodforecasting.v1.GetSerializedPolygon] para recuperar el polígono del área fronteriza del evento.