Method: floodStatus.searchLatestFloodStatusByArea

Cerca lo stato più recente delle inondazioni per area geografica. Nota: restituisce gli stati delle inondazioni il cui misuratore si trova all'interno dell'area specificata, anziché, ad esempio, l'area interessata che interseca l'area specificata. Ciò può cambiare in futuro.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione 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
}
Campi
cutoffTime

string

Facoltativo. L'ora limite per gli stati delle inondazioni. Se fornito, verranno restituiti gli stati delle inondazioni più recenti (ultima pubblicazione) alla data e all'ora limite. Se non viene fornito, verranno restituiti gli stati delle inondazioni pubblicati più di recente. L'ora limite minima consentita è 2025-08-01T00:00:00Z. Se l'ora limite è precedente a questa data e ora, verrà restituito un errore INVALID_ARGUMENT. Rappresentato in formato ISO 8601, ad esempio "2025-10-17T10:34:00Z".
pageToken

string

Facoltativo. Un token di pagina, ricevuto da una precedente chiamata floodStatus.searchLatestFloodStatusByArea. Forniscilo per recuperare la pagina successiva. Quando esegui la paginazione, tutti gli altri parametri forniti a floodStatus.searchLatestFloodStatusByArea devono corrispondere alla chiamata che ha fornito il token di pagina.
pageSize

integer

Facoltativo. Il numero massimo di stati delle inondazioni da restituire. Il servizio potrebbe restituire un numero inferiore di stati delle inondazioni. Se non specificato, verranno restituiti al massimo 20.000 stati delle inondazioni. Il valore massimo è 20.000; i valori superiori a 20.000 verranno forzati a 20.000.

Campo unione area_type.

area_type può essere solo uno dei seguenti tipi:
regionCode

string

La regione in base alla quale eseguire una query sugli stati delle inondazioni. Utilizzando CLDR, ad esempio "US".
loop

object (Loop)

Il ciclo in base al quale eseguire una query sugli stati delle inondazioni.
includeNonQualityVerified

boolean

Facoltativo. Includi nel risultato gli indicatori non verificati per la qualità. Utilizza con cautela. Il valore predefinito è false.

Corpo della risposta

La risposta di floodStatus.searchLatestFloodStatusByArea.

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

Rappresentazione JSON 
{
  "floodStatuses": [
    {
      object (FloodStatus)
    }
  ],
  "nextPageToken": string
}
Campi
floodStatuses[]

object (FloodStatus)

Gli stati delle inondazioni più recenti nell'area richiesta. Al momento, questo valore è determinato dalla posizione degli indicatori ed è soggetto a modifiche in futuro.
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.