Method: floodStatus.searchLatestFloodStatusByArea

Sprawdź najnowszy stan powodzi według obszaru geograficznego. Uwaga: zwraca stany powodzi, których wodowskaz znajduje się na danym obszarze, a nie np. obszar dotknięty powodzią, który przecina dany obszar. W przyszłości może to się zmienić.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis 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
}
Pola
cutoffTime

string

Opcjonalnie. Ostateczny termin dla stanów powodzi. Jeśli podasz te informacje, zwrócimy najnowsze (ostatnio opublikowane) stany powodzi w momencie odcięcia. Jeśli nie podasz tej wartości, zostaną zwrócone najnowsze opublikowane stany powodzi. Minimalna dozwolona data odcięcia to 2025-08-01T00:00:00Z. Jeśli czas odcięcia przypada przed tym czasem, zwracany jest błąd INVALID_ARGUMENT. W formacie ISO 8601, np. „2025-10-17T10:34:00Z”.
pageToken

string

Opcjonalnie. Token strony otrzymany z poprzedniego wywołania floodStatus.searchLatestFloodStatusByArea. Podaj ten token, aby pobrać kolejną stronę. Podczas paginacji wszystkie inne parametry przekazane do funkcji floodStatus.searchLatestFloodStatusByArea muszą być zgodne z wywołaniem, które dostarczyło token strony.
pageSize

integer

Opcjonalnie. Maksymalna liczba zwracanych stanów powodzi. Usługa może zwrócić mniej niż ta wartość. Jeśli nie podano tego argumentu, zwracanych jest maksymalnie 20 000 stanów powodzi. Maksymalna wartość to 20 000. Wartości powyżej 20 000 zostaną ograniczone do 20 000.

Pole zbiorcze area_type.

Pole area_type może mieć tylko jedną z tych wartości:
regionCode

string

Region, według którego chcesz wyszukiwać stany powodzi. Używaj kodów ze standardowego repozytorium danych (Common Locale Data Repository, CLDR), np. „US”.
loop

object (Loop)

Pętla, za pomocą której można wysyłać zapytania o stany powodzi.
includeNonQualityVerified

boolean

Opcjonalnie. Uwzględnij w wyniku wskaźniki, które nie zostały zweryfikowane pod kątem jakości. Używaj z rozwagą. Domyślną wartością jest false (fałsz).

Treść odpowiedzi

Odpowiedź floodStatus.searchLatestFloodStatusByArea.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "floodStatuses": [
    {
      object (FloodStatus)
    }
  ],
  "nextPageToken": string
}
Pola
floodStatuses[]

object (FloodStatus)

Najnowsze informacje o powodziach na wybranym obszarze. Obecnie zależy to od lokalizacji wskaźników, ale w przyszłości może się zmienić.
nextPageToken

string

Opcjonalnie. Token, który można wysłać jako pageToken, aby pobrać następną stronę. Jeśli pominiesz to pole, nie będzie kolejnych stron.