Method: flashFloods.search

Tìm kiếm lũ quét. Trả về các sự kiện lũ quét mới nhất hiện đang diễn ra hoặc được dự báo. Hãy xem https://support.google.com/flood-hub/answer/16811681 để biết thêm thông tin.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu với cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "countryCodes": [
    string
  ],
  "pageSize": integer,
  "pageToken": string
}
Trường
countryCodes[]

string

Không bắt buộc. Mã quốc gia để tìm kiếm lũ quét. Ở định dạng ISO 3166 alpha-2, ví dụ: "US". Nếu bạn không cung cấp, lũ quét cho tất cả quốc gia sẽ được trả về.
pageSize

integer

Không bắt buộc. Số lượng sự kiện tối đa cần trả về. Dịch vụ có thể trả về ít hơn giá trị này. Nếu không chỉ định, tối đa 10.000 sự kiện sẽ được trả về. Giá trị tối đa là 10.000; các giá trị lớn hơn 10.000 sẽ được chuyển đổi thành 10.000.
pageToken

string

Không bắt buộc. Mã thông báo trang nhận được từ một lệnh gọi flashFloods.search trước đó. Cung cấp thông tin này để truy xuất trang tiếp theo. Khi phân trang, tất cả các tham số khác được cung cấp cho flashFloods.search phải khớp với lệnh gọi đã cung cấp mã thông báo trang.

Nội dung phản hồi

Phản hồi của [flashFloods.search][google.research.floodforecasting.v1.SearchLatestFlashFloods].

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "flashFloodEvents": [
    {
      object (FlashFloodEvent)
    }
  ],
  "nextPageToken": string
}
Trường
flashFloodEvents[]

object (FlashFloodEvent)

Các sự kiện lũ quét được tìm thấy dựa trên tiêu chí yêu cầu.
nextPageToken

string

Không bắt buộc. Một mã thông báo có thể được gửi dưới dạng pageToken để truy xuất trang tiếp theo. Nếu bạn bỏ qua trường này, thì sẽ không có trang tiếp theo.

FlashFloodEvent

Sự kiện lũ quét. Đây là một khung thời gian bắt đầu từ forecastIssueTime và kéo dài trong forecastPeriodHours, trong khoảng thời gian này, chúng tôi dự kiến sẽ xảy ra lũ quét.

Biểu diễn dưới dạng JSON 
{
  "forecastIssueTime": string,
  "forecastPeriodHours": integer,
  "affectedCountryCodes": [
    string
  ],
  "likelyAffectedPolygonId": string,
  "highlyLikelyAffectedPolygonId": string,
  "eventPolygonId": string
}
Trường
forecastIssueTime

string

Thời điểm dự báo này được đưa ra. Được biểu thị dưới dạng ISO 8601, ví dụ: "2025-10-17T10:34:00Z".
forecastPeriodHours

integer

Thời gian dự báo có hiệu lực (tính bằng giờ).
affectedCountryCodes[]

string

Các quốc gia được dự đoán sẽ chịu ảnh hưởng của sự kiện, ở định dạng ISO 3166 alpha-2, ví dụ: "US".
likelyAffectedPolygonId

string

Đa giác của khu vực có khả năng bị ảnh hưởng bởi lũ quét. Bạn có thể gửi mã nhận dạng đa giác đến [serializedPolygons.get][google.research.floodforecasting.v1.GetSerializedPolygon] để truy xuất đa giác của khu vực xảy ra sự kiện.
highlyLikelyAffectedPolygonId

string

Đa giác của khu vực có khả năng cao bị ảnh hưởng bởi lũ quét. Bạn có thể gửi mã nhận dạng đa giác đến [serializedPolygons.get][google.research.floodforecasting.v1.GetSerializedPolygon] để truy xuất đa giác của khu vực xảy ra sự kiện.
eventPolygonId

string

Mã đa giác của khu vực biên giới của sự kiện. Đây là hợp của các đa giác có khả năng và có khả năng cao. Bạn có thể gửi mã nhận dạng đa giác đến [serializedPolygons.get][google.research.floodforecasting.v1.GetSerializedPolygon] để truy xuất đa giác của khu vực biên giới của sự kiện.