Method: floodStatus.searchLatestFloodStatusByArea

Pesquise o status mais recente de inundações por área geográfica. Observação: retorna status de inundação cujo gauge está dentro da área especificada, e não, por exemplo, a área afetada que se cruza com a área especificada. Isso está sujeito a mudanças no futuro.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação 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
}
Campos
cutoffTime

string

Opcional. Opcional. O horário limite para os status de enchente. Quando fornecidos, os status de enchente mais recentes (últimos publicados) até o horário de corte serão retornados. Quando não é fornecido, os status de enchente publicados mais recentes são retornados. O tempo mínimo permitido é 2025-08-01T00:00:00Z. Se o horário de corte for anterior a esse horário, um erro INVALID_ARGUMENT será retornado. Representado como ISO 8601, por exemplo, "2025-10-17T10:34:00Z".
pageToken

string

Opcional. Um token de página recebido de uma chamada floodStatus.searchLatestFloodStatusByArea anterior. Forneça isso para recuperar a página subsequente. Ao paginar, todos os outros parâmetros fornecidos para floodStatus.searchLatestFloodStatusByArea precisam corresponder à chamada que forneceu o token da página.
pageSize

integer

Opcional. O número máximo de status de inundação a serem retornados. O serviço pode retornar um valor inferior a este. Se não for especificado, no máximo 20.000 status de enchente serão retornados. O valor máximo é 20.000. Valores acima disso serão convertidos para 20.000.

Campo de união area_type.

area_type pode ser apenas de um dos tipos a seguir:
regionCode

string

A região para consultar os status de enchente. Usando CLDR, por exemplo, 'US'.
loop

object (Loop)

O loop para consultar os status de inundação.
includeNonQualityVerified

boolean

Opcional. Inclua no resultado indicadores que não foram verificados quanto à qualidade. Use com cuidado. O padrão é false

Corpo da resposta

A resposta de "floodStatus.searchLatestFloodStatusByArea".

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "floodStatuses": [
    {
      object (FloodStatus)
    }
  ],
  "nextPageToken": string
}
Campos
floodStatuses[]

object (FloodStatus)

Os status mais recentes de inundações na área solicitada. No momento, isso é determinado pela localização dos indicadores, mas pode mudar no futuro.
nextPageToken

string

Opcional. Um token que pode ser enviado como pageToken para recuperar a próxima página. Se esse campo for omitido, não haverá páginas subsequentes.