REST Resource: floodStatus

Zasób: FloodStatus

Informacja o powodzi podana przez system. Reprezentuje stan powodzi prognozowany przez system na danym obszarze wraz z takimi atrybutami, jak stopień nasilenia, zmiana prognozy, mapy zalania i inne. Więcej informacji znajdziesz poniżej.

Zapis JSON 
{
  "gaugeId": string,
  "qualityVerified": boolean,
  "gaugeLocation": {
    object (LatLng)
  },
  "issuedTime": string,
  "forecastTimeRange": {
    object (TimeRange)
  },
  "forecastChange": {
    object (ForecastChange)
  },
  "forecastTrend": enum (ForecastTrend),
  "mapInferenceType": enum (MapInferenceType),
  "severity": enum (Severity),
  "inundationMapSet": {
    object (InundationMapSet)
  },
  "source": string,
  "serializedNotificationPolygonId": string
}
Pola
gaugeId

string

Identyfikator wskaźnika, dla którego przydzielono ten stan.
qualityVerified

boolean

Prawda, jeśli wskaźnik dla tego stanu powodzi nie ma modelu lub jeśli ma on model, a model został zweryfikowany pod kątem jakości. Gdy ta wartość ma wartość Fałsz, zachowaj ostrożność.
gaugeLocation

object (LatLng)

Lokalizacja wskaźnika, dla którego przydzielono ten stan.
issuedTime

string

Godzina przyznania statusu w postaci ciągu znaków (ISO 8601), np. "2023-06-17T10:34:00Z".
forecastTimeRange

object (TimeRange)

Zakres czasowy, dla którego prognozowana jest prognoza.
forecastChange

object (ForecastChange)

Zmiana wartości prognozy z ostatniego znanego stanu na prognozę. Obecnie dostępne tylko w przypadku modeli poziomu wody.
forecastTrend

enum (ForecastTrend)

Trend prognozy.
mapInferenceType

enum (MapInferenceType)

Typ wnioskowania, na podstawie którego została utworzona ta mapa.
severity

enum (Severity)

Waga stanu.
inundationMapSet

object (InundationMapSet)

Zestaw mapy zalania.
source

string

Organizacja odpowiedzialna za dane tego wskaźnika, np. GRDC, CWC itp.
serializedNotificationPolygonId

string

Identyfikator zserializowanego wielokąta powiadomienia, który reprezentuje obszar geograficzny używany przez Google do określania, kiedy powiadamiać użytkowników. Użyj kodu serializedPolygons.get, aby pobrać zserializowany wielokąt.

TimeRange

Zakres czasowy.

Zapis JSON 
{
  "start": string,
  "end": string
}
Pola
start

string

Początek zakresu czasu. Format zgodny ze standardem ISO 8601, np. "2023-06-17T10:34:00Z".
end

string

Koniec zakresu czasu. Format zgodny ze standardem ISO 8601, np. "2023-06-17T10:34:00Z".

ForecastChange

Zmiana prognozowanej wartości z ostatniego znanego stanu na prognozę. Obecnie dostępne tylko w przypadku modeli poziomu wody.

Zapis JSON 
{
  "valueChange": {
    object (ValueChange)
  },
  "referenceTimeRange": {
    object (TimeRange)
  }
}
Pola
valueChange

object (ValueChange)

Prognozowana zmiana wartości.
referenceTimeRange

object (TimeRange)

Zakres czasu ostatniego znanego stanu, z którego prognozujemy zmianę wartości. Możemy na przykład mieć zakres czasu referencyjnego ustawiony na wczoraj, a zmianę wartości o 25–30 cm. Oznacza to, że podniesienie poziomu wody o 25–30 cm jest porównywane z poprzednią wartością, a nie wartością bieżącą.

ValueChange

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

Zapis JSON 
{
  "lowerBound": number,
  "upperBound": number
}
Pola
lowerBound

number

Dolna granica prognozy zmiany w metrach. Jeśli zmiana mieści się w zakresie od 20 do 30, widoczna jest wartość 20. Jeśli zmiana mieści się w zakresie od -30 do -20, ta wartość wynosi -30.
upperBound

number

Górna granica prognozy zmiany w metrach. Jeśli zmiana mieści się w zakresie od 20 do 30, widoczna jest wartość 30. Jeśli zmiana mieści się w zakresie od -30 do -20, ta wartość wynosi -20.

ForecastTrend

Wyliczenie odzwierciedlają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, że wartość prognozowana nie ulegnie zmianie.

MapInferenceType

Wyliczenie, które reprezentuje typy wniosków na mapie.

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

Poziom ważności

Wyliczenie, które przedstawia wagę stanu.

Wartości w polu enum
SEVERITY_UNSPECIFIED Wartość domyślna. Ta wartość nie jest używana.
EXTREME Wskazuje ona prognozowany stan skrajny.
SEVERE Oznacza to prognozowany stan poważny.
ABOVE_NORMAL Oznacza on prognozowany stan powyżej normalnego stanu.
NO_FLOODING To jest prognoza braku powodzi.
UNKNOWN Oznacza to, że nie mamy wystarczająco dużo informacji, aby określić wagę problemu.

InundationMapSet

Zestaw map zalania.

Zapis JSON 
{
  "inundationMaps": [
    {
      object (InundationMap)
    }
  ],
  "inundationMapsTimeRange": {
    object (TimeRange)
  },
  "inundationMapType": enum (InundationMapType)
}
Pola
inundationMaps[]

object (InundationMap)

Mapy zalania, po jednej na każdy poziom zalania.
inundationMapsTimeRange

object (TimeRange)

Zakres czasowy stanu, którego dotyczą mapy zalania.
inundationMapType

enum (InundationMapType)

Typ mapy zalania.

InundationMap

Jedna mapa zalania.

Zapis JSON 
{
  "level": enum (InundationLevel),
  "serializedPolygonId": string
}
Pola
level

enum (InundationLevel)

Poziom mapy zalania – zobacz dokumentację na podstawie typu InundationMapType.
serializedPolygonId

string

Identyfikator serializowanego wielokąta reprezentującego tę mapę ryzyka zalania. Użyj kodu serializedPolygons.get, aby pobrać zserializowany wielokąt.

InundationLevel

Wyliczenie odzwierciedlające poziomy zalania.

Wartości w polu enum
INUNDATION_LEVEL_UNSPECIFIED Wartość domyślna. Ta wartość nie jest używana.
HIGH Zobacz dokumentację opartą na typie InundationMapType.
MEDIUM Zobacz dokumentację opartą na typie InundationMapType.
LOW Zobacz dokumentację opartą na typie InundationMapType.

InundationMapType

Wyliczenie reprezentujące rodzaj mapy zalania.

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 na mapie – wysokie/średnie/niskie prawdopodobieństwo zalania. Wielokąt o wysokim prawdopodobieństwie znajduje się wewnątrz wielokąta o średnim prawdopodobieństwie, a w strefie wielokąta o niskim prawdopodobieństwie.
DEPTH Mapa zróżnicowania typów. Wartość InundationLevel przedstawia głębokość mapy — wysoka/średnia/mała dla danej lokalizacji. Wielokąt o dużej głębokości znajduje się wewnątrz wielokąta o średniej głębokości, a w niewielkiej.

Metody

queryLatestFloodStatusByGaugeIds

 Zapytanie o ostatni stan powodzi za pomocą identyfikatorów wskaźników.

searchLatestFloodStatusByArea

 Wyszukaj najnowszy stan powodzi według obszaru geograficznego.