REST Resource: significantEvents

資源：SignificantEvent

重大事件是指預測發生機率高且影響重大的洪水事件，涵蓋沒有經過品質驗證的測量儀器所在位置。

JSON 表示法 
{
  "eventInterval": {
    object (SignificantEventInterval)
  },
  "affectedCountryCodes": [
    string
  ],
  "affectedPopulation": integer,
  "areaKm2": number,
  "gaugeIds": [
    string
  ],
  "eventPolygonId": string,
  "eventTrackingIds": [
    string
  ]
}
欄位
eventInterval

object (SignificantEventInterval)

活動的開始和結束時間。
affectedCountryCodes[]

string

受影響的國家/地區，採用 ISO 3166 alpha-2 格式。這份清單包含預計會受到事件影響的所有國家/地區。
affectedPopulation

integer

受影響區域的預估人口數，代表預計會受到事件影響的人口數。
areaKm2

number

活動區域的面積，以平方公里為單位。代表預計會受到事件影響的區域。
gaugeIds[]

string

活動中的計量表清單。這份清單包含預計會受到活動影響的所有計量表。
eventPolygonId

string

可傳送至 [serializedPolygons.get][google.research.floodforecasting.v1.GetSerializedPolygon] 的多邊形 ID，用於擷取事件區域的多邊形。
eventTrackingIds[]

string

用於追蹤這項事件的 ID。
注意事項：
1. 合併的活動可能有多個 ID。
2. 我們無法保證追蹤 ID 在整個事件生命週期內都會完整保留，但會盡力而為。
背景：我們有內部評分和門檻設定，可定義重大事件。如果事件先超過門檻，然後低於門檻，接著又超過門檻，系統會在第二次超過門檻時指派新的追蹤 ID。

SignificantEventInterval

重大事件的時間間隔。

JSON 表示法 
{
  "startTime": string,

  // Union field predicted_end_time can be only one of the following:
  "endTime": string,
  "minimumEndTime": string
  // End of list of possible types for union field predicted_end_time.
}
欄位
startTime

string

活動的開始時間，採用 ISO 8601 格式，例如「2025-03-17T10:34:00Z」。
聯集欄位 predicted_end_time。活動的結束時間。predicted_end_time 只能是下列其中一項：
endTime

string

活動的結束時間。採用 ISO 8601 格式，例如「2025-03-25T10:34:00Z」。
minimumEndTime

string

活動的最早結束時間。採用 ISO 8601 格式，例如「2025-03-25T10:34:00Z」。預計活動時間會超過模型的交貨時間。我們不知道實際結束時間，但預計活動至少會持續到這個時間。

方法
搜尋近期發生的重大事件。