Method: floodStatus.searchLatestFloodStatusByArea

Cerca lo stato più recente delle inondazioni per area geografica. Nota: restituisce lo stato delle inondazioni la cui misurazione rientra nell'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. Facoltativo. L'ora limite per gli stati di inondazione. Se forniti, verranno restituiti gli stati di inondazione più recenti (ultimi pubblicati) alla data e all'ora limite. Se non viene fornito, verranno restituiti gli ultimi stati di alluvione pubblicati fino a questo momento. Il termine minimo consentito è 2025-08-01T00:00:00Z. Se l'ora limite è precedente a questo orario, verrà restituito un errore INVALID_ARGUMENT. Rappresentato come 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. Durante 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 di inondazione da restituire. Il servizio potrebbe restituire un numero inferiore a questo valore. Se non specificato, verranno restituiti al massimo 20.000 stati di inondazione. 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:

regionCode

string

La regione in base alla quale eseguire query sugli stati di alluvione. Utilizzando CLDR, ad es. 'US'.

loop

object (Loop)

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

includeNonQualityVerified

boolean

Facoltativo. Includi nei grafici dei risultati quelli non verificati in termini di qualità. Utilizzalo 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 ultimi stati di allerta alluvione 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.