Method: flashFloods.search

Telusuri banjir bandang. Menampilkan peristiwa banjir bandang terbaru yang saat ini aktif atau diperkirakan akan terjadi. Lihat https://support.google.com/flood-hub/answer/16811681 untuk mengetahui detail selengkapnya.

Permintaan HTTP

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

URL ini menggunakan sintaksis gRPC Transcoding.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "countryCodes": [
    string
  ],
  "pageSize": integer,
  "pageToken": string
}
Kolom
countryCodes[]

string

Opsional. Kode negara untuk menelusuri banjir bandang. Dalam format alpha-2 ISO 3166, misalnya "US". Jika tidak diberikan, banjir bandang untuk semua negara akan ditampilkan.
pageSize

integer

Opsional. Jumlah maksimum peristiwa yang akan ditampilkan. Layanan mungkin menampilkan lebih sedikit dari nilai ini. Jika tidak ditentukan, paling banyak 10.000 peristiwa akan ditampilkan. Nilai maksimum adalah 10.000; nilai di atas 10.000 akan dikonversi menjadi 10.000.
pageToken

string

Opsional. Token halaman, yang diterima dari panggilan flashFloods.search sebelumnya. Berikan ini untuk mengambil halaman selanjutnya. Saat melakukan penomoran halaman, semua parameter lain yang disediakan untuk flashFloods.search harus sesuai dengan panggilan yang memberikan token halaman.

Isi respons

Respons [flashFloods.search][google.research.floodforecasting.v1.SearchLatestFlashFloods].

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "flashFloodEvents": [
    {
      object (FlashFloodEvent)
    }
  ],
  "nextPageToken": string
}
Kolom
flashFloodEvents[]

object (FlashFloodEvent)

Peristiwa banjir bandang yang ditemukan berdasarkan kriteria permintaan.
nextPageToken

string

Opsional. Token yang dapat dikirim sebagai pageToken untuk mengambil halaman berikutnya. Jika kolom ini dihilangkan, tidak akan ada halaman berikutnya.

FlashFloodEvent

Peristiwa banjir bandang. Rentang waktu ini dimulai pada forecastIssueTime dan berlangsung selama forecastPeriodHours, dan dalam rentang waktu ini kami memperkirakan akan terjadi banjir bandang.

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

string

Waktu saat prakiraan ini dikeluarkan. Ditampilkan sebagai ISO 8601, misalnya, "2025-10-17T10:34:00Z".
forecastPeriodHours

integer

Durasi masa berlaku prakiraan (dalam jam).
affectedCountryCodes[]

string

Negara yang diprediksi akan terpengaruh oleh peristiwa tersebut, dalam format alpha-2 ISO 3166, misalnya "US".
likelyAffectedPolygonId

string

Poligon area yang kemungkinan akan terpengaruh oleh banjir bandang. ID poligon dapat dikirim ke [serializedPolygons.get][google.research.floodforecasting.v1.GetSerializedPolygon] untuk mengambil poligon area peristiwa.
highlyLikelyAffectedPolygonId

string

Poligon area yang kemungkinan besar akan terpengaruh oleh banjir bandang. ID poligon dapat dikirim ke [serializedPolygons.get][google.research.floodforecasting.v1.GetSerializedPolygon] untuk mengambil poligon area peristiwa.
eventPolygonId

string

ID poligon area batas acara. Ini adalah gabungan poligon yang mungkin dan sangat mungkin. ID poligon dapat dikirim ke [serializedPolygons.get][google.research.floodforecasting.v1.GetSerializedPolygon] untuk mengambil poligon area perbatasan peristiwa.