REST Resource: floodStatus

Resource: FloodStatus

Status Banjir yang dikeluarkan oleh sistem. Merepresentasikan status banjir yang diperkirakan oleh sistem untuk suatu area, dengan atribut seperti tingkat keparahan, perubahan perkiraan, peta genangan, dan lainnya. Lihat di bawah untuk mengetahui detail selengkapnya.

Representasi 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
}
Kolom
gaugeId

string

ID pengukur untuk status ini.

qualityVerified

boolean

Benar jika pengukur status banjir ini dikeluarkan untuk tidak memiliki model, atau jika memiliki model dan modelnya terverifikasi kualitasnya. Gunakan dengan hati-hati jika nilai ini ditetapkan ke salah (false).

gaugeLocation

object (LatLng)

Lokasi pengukur untuk status ini.

issuedTime

string

Waktu status ini dikeluarkan sebagai string (ISO 8601), mis., "2023-06-17T10:34:00Z".

forecastTimeRange

object (TimeRange)

Rentang waktu yang diprediksi oleh perkiraan.

forecastChange

object (ForecastChange)

Nilai perkiraan berubah dari status terakhir yang diketahui menjadi perkiraan. Saat ini hanya tersedia untuk model Ketinggian Air.

forecastTrend

enum (ForecastTrend)

Tren perkiraan.

mapInferenceType

enum (MapInferenceType)

Jenis inferensi yang digunakan untuk membuat peta ini.

severity

enum (Severity)

Tingkat keparahan status.

inundationMapSet

object (InundationMapSet)

Kumpulan peta genangan yang disimpulkan.

source

string

Organisasi yang bertanggung jawab atas data ukuran ini, misalnya, GRDC, CWC, dll.

serializedNotificationPolygonId

string

ID poligon notifikasi serial, yang mewakili area geografis yang digunakan Google untuk menentukan kapan harus memberi tahu penggunanya. Gunakan serializedPolygons.get untuk mendapatkan poligon yang diserialisasi.

TimeRange

Rentang waktu.

Representasi JSON
{
  "start": string,
  "end": string
}
Kolom
start

string

Awal rentang waktu. Direpresentasikan sebagai ISO 8601, mis., "2023-06-17T10:34:00Z".

end

string

Akhir rentang waktu. Direpresentasikan sebagai ISO 8601, mis., "2023-06-17T10:34:00Z".

ForecastChange

Nilai perkiraan berubah dari status terakhir yang diketahui ke perkiraan. Saat ini hanya tersedia untuk model Ketinggian Air.

Representasi JSON
{
  "valueChange": {
    object (ValueChange)
  },
  "referenceTimeRange": {
    object (TimeRange)
  }
}
Kolom
valueChange

object (ValueChange)

Perkiraan perubahan nilai.

referenceTimeRange

object (TimeRange)

Rentang waktu dari status terakhir yang diketahui, yang menjadi asal prediksi perubahan nilai. Misalnya, kita mungkin memiliki rentang waktu referensi yang ditetapkan ke kemarin, dan nilai berubah 25-30 cm. Artinya kenaikan muka air 25-30 cm dibandingkan dengan nilainya kemarin, bukan dari nilainya sekarang.

ValueChange

Perkiraan perubahan nilai - batas atas dan bawah.

Representasi JSON
{
  "lowerBound": number,
  "upperBound": number
}
Kolom
lowerBound

number

Batas bawah perkiraan berubah dalam meter. Jika perubahannya antara 20 dan 30, nilainya adalah 20. Jika perubahannya antara -30 dan -20, nilainya adalah -30.

upperBound

number

Batas atas perubahan perkiraan dalam meter. Jika perubahannya antara 20 dan 30, nilai ini akan menjadi 30. Jika perubahannya antara -30 dan -20, nilainya adalah -20.

ForecastTrend

Enum yang mewakili tren perkiraan.

Enum
FORECAST_TREND_UNSPECIFIED Nilai default. Nilai ini tidak digunakan.
RISE Ini menunjukkan peningkatan nilai perkiraan.
FALL Hal ini menunjukkan penurunan nilai perkiraan.
NO_CHANGE Hal ini menunjukkan tidak ada perubahan pada nilai yang diperkirakan.

MapInferenceType

Enum yang merepresentasikan jenis inferensi peta.

Enum
MAP_INFERENCE_TYPE_UNSPECIFIED Nilai default. Nilai ini tidak digunakan.
MODEL Hal ini menunjukkan bahwa inferensi ini dibuat menggunakan model.
IMAGE_CLASSIFICATION Hal ini menunjukkan bahwa inferensi ini dibuat menggunakan klasifikasi gambar.

Keparahan

Enum yang mewakili tingkat keparahan status.

Enum
SEVERITY_UNSPECIFIED Nilai default. Nilai ini tidak digunakan.
EXTREME Hal ini menunjukkan status ekstrem yang diperkirakan.
SEVERE Hal ini menunjukkan perkiraan status parah.
ABOVE_NORMAL Hal ini menunjukkan perkiraan status di atas normal.
NO_FLOODING Hal ini menunjukkan perkiraan tidak ada banjir.
UNKNOWN Hal ini menunjukkan bahwa kami tidak memiliki informasi yang cukup untuk menentukan tingkat keparahan.

InundationMapSet

Serangkaian peta genangan.

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

object (InundationMap)

Peta banjir, satu peta untuk setiap tingkat genangan.

inundationMapsTimeRange

object (TimeRange)

Rentang waktu negara bagian yang dirujuk oleh peta banjir.

inundationMapType

enum (InundationMapType)

Jenis peta banjir.

InundationMap

Satu peta banjir.

Representasi JSON
{
  "level": enum (InundationLevel),
  "serializedPolygonId": string
}
Kolom
level

enum (InundationLevel)

Tingkat peta genangan - Lihat dokumentasi berdasarkan InundationMapType.

serializedPolygonId

string

ID poligon serial yang mewakili peta risiko genangan ini. Gunakan serializedPolygons.get untuk mendapatkan poligon yang diserialisasi.

InundationLevel

Enum yang mewakili tingkat genangan.

Enum
INUNDATION_LEVEL_UNSPECIFIED Nilai default. Nilai ini tidak digunakan.
HIGH Lihat dokumentasi berdasarkan InundationMapType.
MEDIUM Lihat dokumentasi berdasarkan InundationMapType.
LOW Lihat dokumentasi berdasarkan InundationMapType.

InundationMapType

Enum yang mewakili jenis peta banjir.

Enum
INUNDATION_MAP_TYPE_UNSPECIFIED Nilai default. Nilai ini tidak digunakan.
PROBABILITY Peta probabilitas jenis. InundationLevel menunjukkan probabilitas peta - probabilitas tinggi/sedang/rendah terjadinya banjir. Poligon probabilitas tinggi berada dalam poligon probabilitas sedang dan poligon probabilitas sedang terdapat dalam poligon probabilitas rendah.
DEPTH Peta kedalaman jenis. InundationLevel menunjukkan kedalaman peta - kedalaman tinggi/sedang/rendah per lokasi. Poligon kedalaman tinggi berada di dalam poligon kedalaman sedang dan poligon kedalaman sedang berada di dalam poligon kedalaman rendah.

Metode

queryLatestFloodStatusByGaugeIds

Buat kueri status banjir terbaru menurut ID pengukur.

searchLatestFloodStatusByArea

Telusuri status banjir terbaru menurut area geografis.