Method: floodStatus.searchLatestFloodStatusByArea

Pesquise o status mais recente de inundações por área geográfica. Observação: retorna os status de inundações em que o medidor de nível de água está dentro da área especificada, e não, por exemplo, a área afetada que se cruza com a área especificada. Essa oferta promocional está sujeita a alterações 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. O horário limite para os status de inundações. Quando fornecido, os status de inundações mais recentes (últimos publicados) até o horário limite serão retornados. Quando não fornecido, os status de inundações publicados mais recentes serão retornados. O horário limite mínimo permitido é 2025-08-01T00:00:00Z. Se o horário limite 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. Quando a paginação estiver sendo usada, todos os outros parâmetros enviados para floodStatus.searchLatestFloodStatusByArea precisarão corresponder à chamada que informou o token da página.
pageSize

integer

Opcional. O número máximo de status de inundações 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 inundações serão retornados. O valor máximo é 20.000. Valores acima de 20.000 serão forçados 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 pela qual consultar os status de inundações. Usando CLDR, por exemplo, "US".
loop

object (Loop)

O loop pelo qual consultar os status de inundações.
includeNonQualityVerified

boolean

Opcional. Inclua no resultado medidores 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 de inundações mais recentes na área solicitada. Atualmente, isso é determinado pelo local dos medidores, e está sujeito a mudanças 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.