Package google.research.floodforecasting.v1

Indeks

FloodsApi

Zewnętrzna usługa API do prognozowania powodzi.

BatchGetGaugeModels

rpc BatchGetGaugeModels(BatchGetGaugeModelsRequest) returns (BatchGetGaugeModelsResponse)

Pobieranie metadanych bieżącego modelu hydrologicznego dla wielu wodowskazów.
BatchGetGauges

rpc BatchGetGauges(BatchGetGaugesRequest) returns (BatchGetGaugesResponse)

Pobieranie metadanych wielu wodowskazów.
GetGauge

rpc GetGauge(GetGaugeRequest) returns (Gauge)

Pobieranie metadanych wodowskazu.
GetGaugeModel

rpc GetGaugeModel(GetGaugeModelRequest) returns (GaugeModel)

Pobieranie metadanych bieżącego modelu hydrologicznego dla danego wodowskazu.
GetSerializedPolygon

rpc GetSerializedPolygon(GetSerializedPolygonRequest) returns (SerializedPolygon)

Uzyskiwanie zserializowanego wielokąta. Identyfikatory tych elementów będą widoczne w innych odpowiedziach interfejsu API i będziesz ich tu używać. Na przykład zobacz InundationMap w FloodStatus.
QueryGaugeForecasts

rpc QueryGaugeForecasts(QueryGaugeForecastsRequest) returns (QueryGaugeForecastsResponse)

Zapytania o prognozy dotyczące wodowskazów.
QueryLatestFloodStatusByGaugeIds

rpc QueryLatestFloodStatusByGaugeIds(QueryLatestFloodStatusByGaugeIdsRequest) returns (QueryLatestFloodStatusByGaugeIdsResponse)

Sprawdź najnowszy stan powodzi według identyfikatorów wodowskazów.
SearchGaugesByArea

rpc SearchGaugesByArea(SearchGaugesByAreaRequest) returns (SearchGaugesByAreaResponse)

Wyszukiwanie wodowskazów według obszaru geograficznego.

Uwaga: wskaźniki są czasami dodawane lub usuwane, więc wynik tego interfejsu API nie powinien być zapisywany w pamięci podręcznej ani przechowywany przez dłuższy czas. Za stosunkowo bezpieczny uznaj okres nie dłuższy niż jeden dzień.
SearchLatestFlashFloods

rpc SearchLatestFlashFloods(SearchLatestFlashFloodsRequest) returns (SearchLatestFlashFloodsResponse)

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.
SearchLatestFloodStatusByArea

rpc SearchLatestFloodStatusByArea(SearchLatestFloodStatusByAreaRequest) returns (SearchLatestFloodStatusByAreaResponse)

Wyszukiwanie najnowszych informacji o powodziach według obszaru geograficznego. Uwaga: zwraca informacje o powodziach, których wodowskaz znajduje się na danym obszarze, a nie np. obszar dotknięty powodzią przecinający się z danym obszarem. Może się to zmienić w przyszłości.
SearchLatestSignificantEvents

rpc SearchLatestSignificantEvents(SearchLatestSignificantEventsRequest) returns (SearchLatestSignificantEventsResponse)

Wyszukaj najnowsze ważne wydarzenia.

BatchGetGaugeModelsRequest

Żądanie BatchGetGaugeModels.

Pola
names[]

string

Wymagane. Nazwy modeli wskaźników do pobrania. Format nazwy: gaugeModels/{gauge_id}. Obsługiwana wielkość listy jest ograniczona do 20 000. Jeśli lista zawiera więcej niż 20 tys. elementów,zwracany jest błąd INVALID_REQUEST.

BatchGetGaugeModelsResponse

Odpowiedź funkcji BatchGetGaugeModels.

Pola
gauge_models[]

GaugeModel

Żądane modele wodowskazów.

BatchGetGaugesRequest

Żądanie BatchGetGauges.

Pola
names[]

string

Wymagane. Nazwy wskaźników do pobrania. Format nazwy: gauges/{gauge_id}. Obsługiwana wielkość listy jest ograniczona do 100 tys. Jeśli podana lista jest większa niż 100 000 elementów,wywołanie kończy się niepowodzeniem i zwracany jest błąd INVALID_REQUEST.

BatchGetGaugesResponse

Odpowiedź BatchGetGauges.

Pola
gauges[]

Gauge

Żądane wodowskazy.

FlashFloodEvent

powódź błyskawiczna; Oznacza to przedział czasu, który rozpoczyna się o forecast_issue_time i trwa forecast_period_hours. W tym czasie spodziewamy się wystąpienia powodzi błyskawicznej.

Pola
forecast_issue_time

string

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

int32

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

string

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

string

Wielokąt obszaru, na który prawdopodobnie wpłynie powódź błyskawiczna. Identyfikator wielokąta można wysłać do [GetSerializedPolygon][google.research.floodforecasting.v1.GetSerializedPolygon], aby pobrać wielokąt obszaru zdarzenia.
highly_likely_affected_polygon_id

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 [GetSerializedPolygon][google.research.floodforecasting.v1.GetSerializedPolygon], aby pobrać wielokąt obszaru zdarzenia.
event_polygon_id

string

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

FloodStatus

Stan powodzi wydany przez system. Określa prognozowany przez system stan zalania danego obszaru, z atrybutami takimi jak poziom zagrożenia, zmiana prognozy, mapy zalewowe i inne. Więcej informacji znajdziesz poniżej.

Pola
gauge_id

string

Identyfikator wskaźnika, dla którego wydano ten stan.
quality_verified

bool

Wartość „true”, jeśli wodowskaz, dla którego wydano ten stan powodzi, nie ma modelu lub jeśli ma model, który został zweryfikowany pod kątem jakości. Jeśli ta wartość jest ustawiona na „false”, zachowaj ostrożność.
gauge_location

LatLng

Lokalizacja wodowskazu, dla którego wydano ten stan.
issued_time

string

Czas wydania tego stanu w formie ciągu znaków (ISO 8601), np. „2023-06-17T10:34:00Z”.
forecast_time_range

TimeRange

Zakres czasu, dla którego prognoza jest przewidywana.
forecast_change

ForecastChange

Zmiana wartości prognozy od ostatniego znanego stanu do prognozy. Obecnie jest to dostępne tylko w przypadku modeli poziomu wody.
forecast_trend

ForecastTrend

Trend prognozy.
map_inference_type

MapInferenceType

Rodzaj wnioskowania, na podstawie którego utworzono tę mapę.
severity

Severity

Poziom ważności stanu.
inundation_map_set

InundationMapSet

Wnioskowany zestaw map zalania.
source

string

Organizacja odpowiedzialna za dane tego wodowskazu, np. GRDC, CWC itp.
serialized_notification_polygon_id

string

Identyfikator serializowanego wielokąta powiadomienia, który reprezentuje obszar geograficzny używany przez Google do określania, kiedy należy powiadomić użytkowników. Użyj GetSerializedPolygon, aby uzyskać sam serializowany wielokąt.

ForecastChange

Prognozowana zmiana wartości od ostatniego znanego stanu do prognozy. Obecnie jest to dostępne tylko w przypadku modeli poziomu wody.

Pola
value_change

ValueChange

Prognozowana zmiana wartości.
reference_time_range

TimeRange

Zakres czasu ostatniego znanego stanu, na podstawie którego przewidujemy zmianę wartości. Możemy na przykład ustawić zakres czasu odniesienia na „wczoraj” i zmianę wartości na 25–30 cm. Oznacza to, że wzrost poziomu wody o 25–30 cm jest porównywany z wartością z wczoraj, a nie z wartością obecną.

ValueChange

Prognozowana zmiana wartości – górna i dolna granica.

Pola
lower_bound

double

Dolna granica zmiany prognozy w metrach. Jeśli zmiana wynosi od 20 do 30, ta wartość będzie wynosić 20. Jeśli zmiana mieści się w przedziale od -30 do -20, ta wartość wyniesie -30.
upper_bound

double

Górna granica zmiany prognozy w metrach. Jeśli zmiana mieści się w przedziale od 20 do 30, ta wartość wyniesie 30. Jeśli zmiana mieści się w przedziale od –30 do –20, ta wartość wyniesie –20.

ForecastTrend

Wyliczenie reprezentujące trend prognozy.

Wartości w polu enum
FORECAST_TREND_UNSPECIFIED Wartość domyślna. Ta wartość nie jest używana.
RISE Oznacza to wzrost prognozowanej wartości.
FALL Oznacza to spadek prognozowanej wartości.
NO_CHANGE Oznacza to brak zmiany prognozowanej wartości.

InundationMap

1 mapa zalania.

Pola
level

InundationLevel

Poziom mapy zalania – zapoznaj się z dokumentacją dotyczącą typu InundationMapType.
serialized_polygon_id

string

Identyfikator serializowanego wielokąta reprezentującego tę mapę ryzyka zalania. Użyj GetSerializedPolygon, aby uzyskać sam serializowany wielokąt.

InundationLevel

Wyliczenie reprezentujące poziomy zalania.

Wartości w polu enum
INUNDATION_LEVEL_UNSPECIFIED Wartość domyślna. Ta wartość nie jest używana.
HIGH Zapoznaj się z dokumentacją na podstawie typu InundationMapType.
MEDIUM Zapoznaj się z dokumentacją na podstawie typu InundationMapType.
LOW Zapoznaj się z dokumentacją na podstawie typu InundationMapType.

InundationMapSet

zestaw map zalewowych,

Pola
inundation_maps[]

InundationMap

Mapy zalania, po jednej dla każdego poziomu zalania.
inundation_maps_time_range

TimeRange

Zakres czasu, do którego odnoszą się mapy zalewów.
inundation_map_type

InundationMapType

Typ mapy zalania.

InundationMapType

Wyliczenie reprezentujące typ mapy zalewowej.

Wartości w polu enum
INUNDATION_MAP_TYPE_UNSPECIFIED Wartość domyślna. Ta wartość nie jest używana.
PROBABILITY Mapa prawdopodobieństwa typu. Wartość InundationLevel reprezentuje prawdopodobieństwo zalania na mapie – wysokie, średnie lub niskie. Wielokąt wysokiego prawdopodobieństwa jest zawarty w wielokącie średniego prawdopodobieństwa, a ten z kolei jest zawarty w wielokącie niskiego prawdopodobieństwa.
DEPTH Mapa typu głębokość. Wartość InundationLevel reprezentuje głębokość mapy – wysoka/średnia/niska głębokość w danym miejscu. Wielokąt o wysokiej głębokości jest zawarty w wielokącie o średniej głębokości, a ten z kolei w wielokącie o niskiej głębokości.

MapInferenceType

Wyliczenie reprezentujące typy wniosków z mapy.

Wartości w polu enum
MAP_INFERENCE_TYPE_UNSPECIFIED Wartość domyślna. Ta wartość nie jest używana.
MODEL Oznacza to, że to wnioskowanie zostało utworzone przy użyciu modelu.
IMAGE_CLASSIFICATION Oznacza to, że wnioskowanie zostało utworzone na podstawie klasyfikacji obrazu.

Poziom ważności

Wyliczenie, które reprezentuje ważność stanu.

Wartości w polu enum
SEVERITY_UNSPECIFIED Wartość domyślna. Ta wartość nie jest używana.
EXTREME Oznacza to prognozowany stan ekstremalny.
SEVERE Oznacza to prognozowany stan poważny.
ABOVE_NORMAL Oznacza to prognozowany stan powyżej normy.
NO_FLOODING Oznacza to, że nie jest prognozowana powódź.
UNKNOWN Oznacza to, że nie mamy wystarczających informacji, aby określić poziom ważności.

Prognoza

Prognoza dla jednego wodowskazu w przypadku kilku okresów wyprzedzenia. Na przykład prognoza może być wydana o 17:00 i zawierać prognozy na 18:00, 19:00, 20:00 itd.

Uwaga: niektóre zakresy prognozy mogą być wcześniejsze niż czas wydania. Może się to zdarzyć np. z powodu opóźnień w danych wejściowych modelu. W powyższym przykładzie czas wydania może wynosić 17:00, a zakresy prognozy mogą dotyczyć 16:00, 17:00, 18:00 itd.

Uwaga: zakresy różnią się długością i odległością między nimi. Oto kilka przykładów możliwych zakresów:

  1. [17:00–17:00], [18:00–18:00], [19:00–19:00]

  2. [1 marca, godz. 0:00 – 2 marca, godz. 0:00], [2 marca, godz. 0:00 – 3 marca, godz. 0:00], [3 marca, godz. 0:00 – 4 marca, godz. 0:00]

Pola
forecast_ranges[]

ForecastTimedValue

Prognoza składa się z kilku „zakresów prognozy”, czyli różnych wartości prognozy dotyczących różnych zakresów czasu. Jeśli początek i koniec zakresu są równe, oznacza to, że jest to moment w czasie.
gauge_id

string

Identyfikator wskaźnika, którego dotyczy ta prognoza.
issued_time

string

Czas wydania prognozy (ISO 8601), np. „2023-06-17T10:34:00Z”. Czas wydania to czas wygenerowania prognozy.

ForecastSet

Zestaw prognoz dotyczących wodowskazu.

Pola
forecasts[]

Forecast

prognozy,

ForecastTimedValue

Wartość prognozy dotycząca zakresu czasu. Jednostki są zdefiniowane przez powiązany z nią GaugeModel. Jeśli czas rozpoczęcia i zakończenia są równe, oznacza to, że jest to moment w czasie.

Pola
value

double

Wartość prognozy.
forecast_start_time

string

Początek przedziału.
forecast_end_time

string

Koniec przedziału.

Wskaźnik

Metadane wodowskazu.

Pola
location

LatLng

Fizyczna lokalizacja urządzenia pomiarowego.
site_name

string

Nazwa witryny, w której znajduje się ten wskaźnik, w języku angielskim. Nie jest to niepowtarzalny identyfikator. W pobliskich lokalizacjach może być kilka urządzeń pomiarowych o tej samej nazwie. Wartość nie zawsze jest używana.
source

string

Organizacja odpowiedzialna za dane tego wodowskazu, np. GRDC, CWC itp.
river

string

Nazwa rzeki, na której znajduje się wodowskaz, w języku angielskim. Wartość nie zawsze jest używana.
country_code

string

Kod kraju, w którym znajduje się urządzenie pomiarowe (ISO 3166 Alpha-2).
gauge_id

string

Identyfikator miernika.
quality_verified

bool

To pole ma wartość „true”, jeśli wskaźnik nie ma modelu lub jeśli ma model, który został zweryfikowany pod kątem jakości. Jeśli ta wartość jest ustawiona na „false”, zachowaj ostrożność.
has_model

bool

To pole ma wartość „true”, jeśli wskaźnik ma model. Jeśli wskaźnik ma model, można uzyskać jego GaugeModel za pomocą GetGaugeModel lub BatchGetGaugeModels, a także prognozy za pomocą QueryGaugeForecasts.

GaugeModel

Metadane modelu wodowskazu.

Pola
gauge_id

string

Identyfikator miernika.
gauge_model_id

string

Identyfikator modelu wodowskazu. Co jakiś czas model wodowskazu może się zmienić. W takim przypadku przypiszemy nowy identyfikator i nowe progi do nowego modelu. Zachowaj ostrożność podczas porównywania starych i nowych prognoz, jeśli zostały one wygenerowane przez różne modele.
thresholds

Thresholds

Progi wskaźnika.
gauge_value_unit

GaugeValueUnit

Jednostka wartości modelu wskaźnika.
quality_verified

bool

Określa, czy ten model został zweryfikowany pod kątem jakości. Jeśli ta wartość jest ustawiona na „false”, zachowaj ostrożność.

GaugeValueUnit

Możliwe jednostki wartości wskaźnika.

Wartości w polu enum
GAUGE_VALUE_UNIT_UNSPECIFIED Wartość domyślna. Ta wartość nie jest używana.
METERS metry,
CUBIC_METERS_PER_SECOND metry sześcienne na sekundę.

GetGaugeModelRequest

Żądanie GetGaugeModel.

Pola
name

string

Wymagane. Nazwa modelu miernika do pobrania. Format nazwy: gaugeModels/{gauge_id}.

GetGaugeRequest

Żądanie GetGauge.

Pola
name

string

Wymagane. Nazwa miernika do pobrania. Format nazwy: gauges/{gauge_id}.

GetSerializedPolygonRequest

Żądanie GetSerializedPolygon.

Pola
name

string

Wymagane. Nazwa serializowanego wielokąta do pobrania. Format nazwy: serializedPolygons/{polygon_id}

Loop

Pętla na mapie. Reprezentuje prosty wielokąt sferyczny. Składa się z jednego łańcucha wierzchołków, w którym pierwszy wierzchołek jest niejawnie połączony z ostatnim.

Pola
vertices[]

LatLng

Wymagane. Wierzchołki pętli.

QueryGaugeForecastsRequest

Żądanie QueryGaugeForecasts.

Pola
gauge_ids[]

string

Wymagane. Lista identyfikatorów mierników. Obsługiwany rozmiar listy jest ograniczony do 500. Jeśli podana lista jest większa niż 500, zwracany jest błąd INVALID_REQUEST.
issued_time_start

string

Opcjonalnie. Najwcześniejszy czas wydania prognozy w formacie ciągu znaków (ISO 8601), np. „2023-06-17T10:34:00Z” lub ciąg znaków daty, np. „2023-10-13”. Godzina rozpoczęcia nie może być wcześniejsza niż „2023-10-01”. Domyślna wartość to tydzień temu.
issued_time_end

string

Opcjonalnie. Najnowszy czas wydania prognozy w formie ciągu znaków (ISO 8601), np. „2023-06-17T10:34:00Z” lub ciągu znaków daty, np. „2023-10-13”. Wartość domyślna to teraz.

QueryGaugeForecastsResponse

Odpowiedź funkcji QueryGaugeForecasts.

Pola
forecasts

map<string, ForecastSet>

Mapa identyfikatorów wodowskazów do zestawów prognoz.

QueryLatestFloodStatusByGaugeIdsRequest

Żądanie QueryLatestFloodStatusByGaugeIds.

Pola
gauge_ids[]

string

Wymagane. Lista identyfikatorów mierników. Obsługiwana wielkość listy jest ograniczona do 20 000. Jeśli lista zawiera więcej niż 20 tys. elementów,zwracany jest błąd INVALID_REQUEST.
cutoff_time

string

Opcjonalnie. Ostateczny termin dla stanów powodzi. Jeśli podasz te informacje, zwrócimy najnowsze (ostatnio opublikowane) stany powodziowe z godziny odcięcia. Jeśli nie podasz tej wartości, zostaną zwrócone najnowsze opublikowane stany powodzi. Minimalny dozwolony ostateczny termin to 2025-08-01T00:00:00Z. Jeśli ostateczny termin jest wcześniejszy niż ten czas, zwracany jest błąd INVALID_ARGUMENT. W formacie ISO 8601, np. „2025-10-17T10:34:00Z”.

QueryLatestFloodStatusByGaugeIdsResponse

Odpowiedź funkcji QueryLatestFloodStatusByGaugeIds.

Pola
flood_statuses[]

FloodStatus

Najnowsze stany powodzi dla wybranych wodowskazów.

SearchGaugesByAreaRequest

Żądanie SearchGaugesByArea.

Pola
page_size

int32

Opcjonalnie. Maksymalna liczba zwracanych wskaźników. Usługa może zwrócić mniej niż ta wartość. Jeśli nie określono inaczej, zwracanych będzie maksymalnie 50 tys. wskaźników. Maksymalna wartość to 50 000. Wartości powyżej 50 000 zostaną ograniczone do 50 000.
page_token

string

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

Pole zbiorcze search_by.

Pole search_by może mieć tylko jedną z tych wartości:
region_code

string

Wyszukiwanie wszystkich wodowskazów w regionie według kodu regionu. Użyj strony https://cldr.unicode.org/ (lista https://www.iana.org/assignments/language-subtag-registry/language-subtag-registry).
loop

Loop

Wyszukaj wszystkie wskaźniki w pętli (prosty wielokąt sferyczny, patrz Loop).
include_non_quality_verified

bool

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).
include_gauges_without_hydro_model

bool

Opcjonalnie. Uwzględnij w wynikach wodowskazy, które nie mają wewnętrznego modelu hydrologicznego Google. Domyślną wartością jest false (fałsz).

SearchGaugesByAreaResponse

Odpowiedź SearchGaugesByArea.

Pola
gauges[]

Gauge

Mierniki znalezione w żądanym obszarze.
next_page_token

string

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

SearchLatestFlashFloodsRequest

Żądanie [SearchLatestFlashFloods][google.research.floodforecasting.v1.SearchLatestFlashFloods].

Pola
country_codes[]

string

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

int32

Opcjonalnie. Maksymalna liczba zdarzeń do zwrócenia. Usługa może zwrócić mniej niż ta wartość. Jeśli nie podasz tej wartości, zwrócimy maksymalnie 10 tys. zdarzeń. Maksymalna wartość to 10 000. Wartości powyżej 10 000 zostaną ograniczone do tej wartości.
page_token

string

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

SearchLatestFlashFloodsResponse

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

Pola
flash_flood_events[]

FlashFloodEvent

Zdarzenia związane z powodziami błyskawicznymi znalezione na podstawie kryteriów żądania.
next_page_token

string

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

SearchLatestFloodStatusByAreaRequest

Żądanie SearchLatestFloodStatusByArea.

Pola
cutoff_time

string

Opcjonalnie. Ostateczny termin dla stanów powodzi. Jeśli podasz te informacje, zwrócimy najnowsze (ostatnio opublikowane) stany powodziowe z godziny odcięcia. Jeśli nie podasz tej wartości, zostaną zwrócone najnowsze opublikowane stany powodzi. Minimalny dozwolony ostateczny termin to 2025-08-01T00:00:00Z. Jeśli ostateczny termin jest wcześniejszy niż ten czas, zwracany jest błąd INVALID_ARGUMENT. W formacie ISO 8601, np. „2025-10-17T10:34:00Z”.
page_token

string

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

int32

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ą zmienione na 20 000.

Pole zbiorcze area_type.

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

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

Loop

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

bool

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).

SearchLatestFloodStatusByAreaResponse

Odpowiedź funkcji SearchLatestFloodStatusByArea.

Pola
flood_statuses[]

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ć.
next_page_token

string

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

SearchLatestSignificantEventsRequest

Żądanie SearchLatestSignificantEvents.

Pola
page_size

int32

Wymagane. Maksymalna liczba zdarzeń do zwrócenia. Usługa może zwrócić mniej niż ta wartość. Jeśli nie podasz tej wartości, zwrócimy maksymalnie 1000 zdarzeń. Wartość maksymalna to 1000. Wartości powyżej 1000 zostaną ograniczone do 1000. Obecnie API nie wymusza maksymalnej wartości, ale w przyszłości będzie to robić.
page_token

string

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

SearchLatestSignificantEventsResponse

Odpowiedź funkcji SearchLatestSignificantEvents.

Pola
significant_events[]

SignificantEvent

Ważne wydarzenia.
next_page_token

string

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

SerializedPolygon

Zserializowany wielokąt.

Pola
polygon_id

string

Identyfikator wielokąta.
kml

string

Ciąg tekstowy KML reprezentujący wielokąt.

SignificantEvent

Poważne zdarzenia to przewidywane powodzie o wysokim prawdopodobieństwie i dużym wpływie. Obejmują one miejsca, w których nie mamy zweryfikowanych pod względem jakości urządzeń pomiarowych.

Pola
event_interval

SignificantEventInterval

czas rozpoczęcia i zakończenia wydarzenia;
affected_country_codes[]

string

Kraje, których dotyczy problem, w formacie ISO 3166 alfa-2. Lista zawiera wszystkie kraje, na które zdarzenie będzie miało wpływ w przyszłości.
affected_population

int32

Szacunkowa liczba ludności na obszarze dotkniętym katastrofą. Jest to populacja, na którą według prognoz będzie miało wpływ dane wydarzenie.
area_km2

float

Obszar wydarzenia w km². Jest to obszar, na który według prognoz będzie mieć wpływ dane zdarzenie.
gauge_ids[]

string

Lista wskaźników w zdarzeniu. Lista zawiera wszystkie wskaźniki, na które zdarzenie będzie miało wpływ w przyszłości.
event_polygon_id

string

Identyfikator wielokąta, który można wysłać do [GetSerializedPolygon][google.research.floodforecasting.v1.GetSerializedPolygon], aby pobrać wielokąt obszaru zdarzenia.
event_tracking_ids[]

string

Identyfikatory używane do śledzenia tego zdarzenia w czasie.
Zastrzeżenia:
1. W przypadku scalonych wydarzeń może istnieć wiele identyfikatorów.
2. Nie ma gwarancji, że identyfikator śledzenia będzie w pełni zachowany przez cały okres istnienia zdarzenia. Jest to tylko próba.
 Informacje ogólne: mamy wewnętrzne ustawienia oceniania i progów, które służą do definiowania istotnych zdarzeń. Jeśli zdarzenie przekroczy nasze progi, a potem spadnie poniżej nich i ponownie je przekroczy, za drugim razem otrzyma nowy identyfikator śledzenia.

SignificantEventInterval

Przedział czasu, w którym wystąpiło ważne wydarzenie.

Pola
start_time

string

Godzina rozpoczęcia wydarzenia. W formacie ISO 8601, np. „2025-03-17T10:34:00Z”.
Pole zbiorcze predicted_end_time. Godzina zakończenia wydarzenia. predicted_end_time może mieć tylko jedną z tych wartości:
end_time

string

Godzina zakończenia wydarzenia. W formacie ISO 8601, np. „2025-03-25T10:34:00Z”.
minimum_end_time

string

Minimalny czas zakończenia wydarzenia. W formacie ISO 8601, np. „2025-03-25T10:34:00Z”. wydarzenie ma trwać dłużej niż czas realizacji modelu; Nie znamy dokładnej godziny zakończenia, ale przewidujemy, że wydarzenie potrwa co najmniej do tego czasu.

Progi

Progi modelu miernika.

Pola
warning_level

double

Poziom ostrzegawczy.
danger_level

double

Poziom zagrożenia.
extreme_danger_level

double

Poziom ekstremalnego zagrożenia. Nie zawsze jest widoczny.

TimeRange

zakres czasu,

Pola
start

string

Początek zakresu czasu. W formacie ISO 8601, np. „2023-06-17T10:34:00Z”.
end

string

Koniec zakresu czasu. W formacie ISO 8601, np. „2023-06-17T10:34:00Z”.