Method: flashFloods.search

Wyszukaj powodzie błyskawiczne. Zwraca najnowsze aktywne lub prognozowane powodzie błyskawiczne. Więcej informacji znajdziesz na stronie https://support.google.com/flood-hub/answer/16811681.

Żądanie HTTP

POST https://floodforecasting.googleapis.com/v1/flashFloods:search

Adres URL używa składni transkodowania gRPC.

Treść żądania

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

Zapis JSON 
{
  "countryCodes": [
    string
  ],
  "pageSize": integer,
  "pageToken": string
}
Pola
countryCodes[]

string

Opcjonalnie. Kody krajów, w których chcesz wyszukiwać błyskawiczne powodzie. W formacie ISO 3166 alfa-2, np. „PL”. Jeśli nie podasz kraju, zwrócimy informacje o powodziach błyskawicznych we wszystkich krajach.
pageSize

integer

Opcjonalnie. Maksymalna liczba zdarzeń do zwrócenia. Usługa może zwrócić mniej niż ta wartość. Jeśli nie podano tego argumentu, zwracanych jest maksymalnie 10 tys. zdarzeń. Maksymalna wartość to 10 000. Wartości powyżej 10 000 zostaną ograniczone do 10 000.
pageToken

string

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

Treść odpowiedzi

Odpowiedź [flashFloods.search][google.research.floodforecasting.v1.SearchLatestFlashFloods].

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

Zapis JSON 
{
  "flashFloodEvents": [
    {
      object (FlashFloodEvent)
    }
  ],
  "nextPageToken": string
}
Pola
flashFloodEvents[]

object (FlashFloodEvent)

Zdarzenia związane z powodziami błyskawicznymi znalezione na podstawie kryteriów żądania.
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.

FlashFloodEvent

Powódź błyskawiczna. Oznacza to przedział czasu od forecastIssueTime do forecastPeriodHours, w którym spodziewamy się wystąpienia powodzi błyskawicznej.

Zapis JSON 
{
  "forecastIssueTime": string,
  "forecastPeriodHours": integer,
  "affectedCountryCodes": [
    string
  ],
  "likelyAffectedPolygonId": string,
  "highlyLikelyAffectedPolygonId": string,
  "eventPolygonId": string
}
Pola
forecastIssueTime

string

Czas, w którym wydano tę prognozę. Reprezentowana w formacie ISO 8601, np. „2025-10-17T10:34:00Z”.
forecastPeriodHours

integer

Okres ważności prognozy (w godzinach).
affectedCountryCodes[]

string

Kraje, w których przewiduje się wystąpienie zdarzenia, w formacie ISO 3166 alfa-2, np. „US”.
likelyAffectedPolygonId

string

Wielokąt obszaru, który prawdopodobnie zostanie dotknięty powodzią błyskawiczną. Identyfikator wielokąta można wysłać do [serializedPolygons.get][google.research.floodforecasting.v1.GetSerializedPolygon], aby pobrać wielokąt obszaru zdarzenia.
highlyLikelyAffectedPolygonId

string

Wielokąt obszaru, na którym istnieje duże prawdopodobieństwo wystąpienia powodzi błyskawicznej. Identyfikator wielokąta można wysłać do [serializedPolygons.get][google.research.floodforecasting.v1.GetSerializedPolygon], aby pobrać wielokąt obszaru zdarzenia.
eventPolygonId

string

Identyfikator wielokąta obszaru granicznego wydarzenia. Jest to suma wielokątów o dużym i bardzo dużym prawdopodobieństwie. Identyfikator wielokąta można wysłać do [serializedPolygons.get][google.research.floodforecasting.v1.GetSerializedPolygon], aby pobrać wielokąt obszaru granicznego zdarzenia.