REST Resource: floodStatus

Tài nguyên: FloodStatus

Trạng thái lũ lụt do hệ thống đưa ra. Thể hiện trạng thái lũ lụt được hệ thống dự báo cho một khu vực, với các thuộc tính như mức độ nghiêm trọng, sự thay đổi trong dự báo, bản đồ ngập lụt và các thuộc tính khác. Hãy xem mục bên dưới để biết thêm thông tin.

Biểu diễn dưới dạng 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
}
Trường
gaugeId

string

Mã của đồng hồ đo mà trạng thái này được cấp.
qualityVerified

boolean

Đúng nếu công cụ đo lường mà trạng thái lũ này được đưa ra không có mô hình, hoặc nếu công cụ đó có mô hình và mô hình đã được xác minh chất lượng. Hãy thận trọng khi giá trị này được đặt thành false.
gaugeLocation

object (LatLng)

Vị trí của đồng hồ đo mà trạng thái này được ban hành.
issuedTime

string

Thời gian cấp trạng thái này dưới dạng chuỗi (ISO 8601), ví dụ: "2023-06-17T10:34:00Z".
forecastTimeRange

object (TimeRange)

Phạm vi thời gian dự đoán.
forecastChange

object (ForecastChange)

Thay đổi giá trị dự đoán từ trạng thái đã biết gần đây nhất sang trạng thái dự đoán. Tính năng này hiện chỉ dùng được cho các mô hình Mức nước.
forecastTrend

enum (ForecastTrend)

Xu hướng của thông tin dự đoán.
mapInferenceType

enum (MapInferenceType)

Loại suy luận dựa trên loại suy luận của bản đồ này.
severity

enum (Severity)

Mức độ nghiêm trọng của trạng thái.
inundationMapSet

object (InundationMapSet)

Tập hợp bản đồ dự báo ngập lụt.
source

string

Tổ chức chịu trách nhiệm về dữ liệu của chỉ số đo lường này, ví dụ: GRDC, CWC, v.v.
serializedNotificationPolygonId

string

Mã nhận dạng của đa giác thông báo chuyển đổi tuần tự, đại diện cho khu vực địa lý mà Google sử dụng để xác định thời điểm thông báo cho người dùng. Dùng serializedPolygons.get để lấy chính đa giác được chuyển đổi tuần tự.

TimeRange

Phạm vi thời gian.

Biểu diễn dưới dạng JSON 
{
  "start": string,
  "end": string
}
Trường
start

string

Bắt đầu phạm vi thời gian. Được biểu thị là ISO 8601, ví dụ: "2023-06-17T10:34:00Z".
end

string

Kết thúc phạm vi thời gian. Được biểu thị là ISO 8601, ví dụ: "2023-06-17T10:34:00Z".

ForecastChange

Sự thay đổi giá trị dự đoán từ trạng thái đã biết gần đây nhất sang trạng thái dự đoán. Tính năng này hiện chỉ dùng được cho các mô hình Mức nước.

Biểu diễn dưới dạng JSON 
{
  "valueChange": {
    object (ValueChange)
  },
  "referenceTimeRange": {
    object (TimeRange)
  }
}
Trường
valueChange

object (ValueChange)

Thay đổi được dự đoán về giá trị.
referenceTimeRange

object (TimeRange)

Phạm vi thời gian của trạng thái xác định gần đây nhất, mà từ đó chúng ta dự đoán sự thay đổi giá trị. Ví dụ: Chúng tôi có thể đặt phạm vi thời gian tham chiếu thành hôm qua và thay đổi giá trị từ 25 đến 30 cm. Tức là mực nước dâng từ 25-30cm so với giá trị của nó ngày hôm qua, chứ không phải so với giá trị hiện tại của nó.

ValueChange

Sự thay đổi được dự đoán trong các giá trị – giới hạn trên và giới hạn dưới.

Biểu diễn dưới dạng JSON 
{
  "lowerBound": number,
  "upperBound": number
}
Trường
lowerBound

number

Giới hạn dưới của sự thay đổi dự báo tính bằng mét. Nếu thay đổi nằm trong khoảng từ 20 đến 30, giá trị này sẽ là 20. Nếu thay đổi nằm trong khoảng từ -30 đến -20, giá trị này sẽ là -30.
upperBound

number

Giới hạn trên của sự thay đổi dự báo tính bằng mét. Nếu thay đổi nằm trong khoảng từ 20 đến 30, thì giá trị này sẽ là 30. Nếu thay đổi nằm trong khoảng từ -30 đến -20, giá trị này sẽ là -20.

ForecastTrend

Một giá trị enum đại diện cho xu hướng của thông tin dự đoán.

Enum
FORECAST_TREND_UNSPECIFIED Giá trị mặc định. Giá trị này chưa được sử dụng.
RISE Điều này cho biết giá trị dự báo tăng.
FALL Điều này cho biết giá trị dự đoán giảm.
NO_CHANGE Điều này cho thấy giá trị dự đoán không thay đổi.

MapInferenceType

Một enum đại diện cho các loại suy luận ánh xạ.

Enum
MAP_INFERENCE_TYPE_UNSPECIFIED Giá trị mặc định. Giá trị này chưa được sử dụng.
MODEL Điều này cho thấy rằng suy luận này được tạo ra bằng một mô hình.
IMAGE_CLASSIFICATION Điều này cho thấy rằng suy luận này được tạo ra bằng cách sử dụng phân loại hình ảnh.

Mức độ nghiêm trọng

Một giá trị enum thể hiện mức độ nghiêm trọng của trạng thái.

Enum
SEVERITY_UNSPECIFIED Giá trị mặc định. Giá trị này chưa được sử dụng.
EXTREME Điều này cho biết trạng thái cực đoan được dự báo.
SEVERE Điều này cho biết một trạng thái nghiêm trọng được dự báo.
ABOVE_NORMAL Điều này cho biết trạng thái được dự báo trên mức bình thường.
NO_FLOODING Giá trị này cho biết thông tin dự báo không có lũ lụt.
UNKNOWN Điều này cho thấy rằng chúng tôi không có đủ thông tin để xác định mức độ nghiêm trọng.

InundationMapSet

Một nhóm bản đồ dự báo ngập lụt.

Biểu diễn dưới dạng JSON 
{
  "inundationMaps": [
    {
      object (InundationMap)
    }
  ],
  "inundationMapsTimeRange": {
    object (TimeRange)
  },
  "inundationMapType": enum (InundationMapType)
}
Trường
inundationMaps[]

object (InundationMap)

Lập bản đồ dự báo ngập lụt, trong đó thể hiện một bản đồ cho mỗi cấp độ ngập lụt.
inundationMapsTimeRange

object (TimeRange)

Phạm vi thời gian của trạng thái mà bản đồ dự báo ngập lụt.
inundationMapType

enum (InundationMapType)

Loại bản đồ dự báo ngập lụt.

InundationMap

Một bản đồ dự báo ngập lụt.

Biểu diễn dưới dạng JSON 
{
  "level": enum (InundationLevel),
  "serializedPolygonId": string
}
Trường
level

enum (InundationLevel)

Mức độ của bản đồ dự báo ngập lụt – Xem tài liệu dựa trên InundationMapType.
serializedPolygonId

string

Mã nhận dạng của đa giác chuyển đổi tuần tự biểu thị bản đồ nguy cơ ngập lụt này. Dùng serializedPolygons.get để lấy chính đa giác được chuyển đổi tuần tự.

InundationLevel

Một giá trị enum thể hiện mức độ ngập lụt.

Enum
INUNDATION_LEVEL_UNSPECIFIED Giá trị mặc định. Giá trị này chưa được sử dụng.
HIGH Xem tài liệu dựa trên InundationMapType.
MEDIUM Xem tài liệu dựa trên InundationMapType.
LOW Xem tài liệu dựa trên InundationMapType.

InundationMapType

Một giá trị enum đại diện cho loại bản đồ dự báo ngập lụt.

Enum
INUNDATION_MAP_TYPE_UNSPECIFIED Giá trị mặc định. Giá trị này chưa được sử dụng.
PROBABILITY Bản đồ xác suất loại. Inundationlevel biểu thị xác suất của bản đồ - xác suất ngập lụt cao/trung bình/thấp. Đa giác có xác suất cao được chứa trong đa giác có xác suất trung bình và đa giác xác suất trung bình được chứa trong đa giác có xác suất thấp.
DEPTH Bản đồ loại độ sâu. InundationLevel thể hiện độ sâu của bản đồ – độ sâu cao/trung bình/thấp cho mỗi vị trí. Đa giác độ sâu cao được chứa trong đa giác độ sâu trung bình và đa giác độ sâu trung bình được chứa trong đa giác độ sâu thấp.

Phương thức

queryLatestFloodStatusByGaugeIds

 Truy vấn tình trạng lũ lụt mới nhất theo mã nhận dạng đồng hồ đo.

searchLatestFloodStatusByArea

 Tìm kiếm tình trạng lũ lụt mới nhất theo khu vực địa lý.