Method: floodStatus.searchLatestFloodStatusByArea

Telusuri status banjir terbaru menurut area geografis. Catatan: Menampilkan status banjir yang pengukurnya berada dalam area tertentu, bukan misalnya, area yang terpengaruh beririsan dengan area tertentu. Hal ini sewaktu-waktu dapat berubah pada masa mendatang.

Permintaan HTTP

POST https://floodforecasting.googleapis.com/v1/floodStatus:searchLatestFloodStatusByArea

URL ini menggunakan sintaksis gRPC Transcoding.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "cutoffTime": string,
  "pageToken": string,
  "pageSize": integer,

  // Union field area_type can be only one of the following:
  "regionCode": string,
  "loop": {
    object (Loop)
  }
  // End of list of possible types for union field area_type.
  "includeNonQualityVerified": boolean
}
Kolom
cutoffTime

string

Opsional. Opsional. Batas waktu untuk status banjir. Jika diberikan, status banjir terbaru (yang terakhir dipublikasikan) pada saat batas waktu akan ditampilkan. Jika tidak diberikan, status banjir yang dipublikasikan terbaru hingga saat ini akan ditampilkan. Waktu penghentian minimum yang diizinkan adalah 2025-08-01T00.00.00Z. Jika waktu penghentian sebelum waktu ini, error INVALID_ARGUMENT akan ditampilkan. Direpresentasikan sebagai ISO 8601, misalnya, "2025-10-17T10:34:00Z".
pageToken

string

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

integer

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

Kolom union area_type.

area_type hanya dapat berupa salah satu dari hal berikut:
regionCode

string

Wilayah yang akan digunakan untuk mengkueri status banjir. Menggunakan CLDR, misalnya, 'US'.
loop

object (Loop)

Loop untuk mengkueri status banjir.
includeNonQualityVerified

boolean

Opsional. Sertakan dalam hasil alat pengukur yang tidak diverifikasi kualitasnya. Harap gunakan dengan hati-hati. Defaultnya adalah false.

Isi respons

Respons floodStatus.searchLatestFloodStatusByArea.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "floodStatuses": [
    {
      object (FloodStatus)
    }
  ],
  "nextPageToken": string
}
Kolom
floodStatuses[]

object (FloodStatus)

Status banjir terbaru di area yang diminta. Saat ini, hal ini ditentukan oleh lokasi pengukur, dan dapat berubah pada masa mendatang.
nextPageToken

string

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