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

一个多边形 ID，可以发送到 [serializedPolygons.get][google.research.floodforecasting.v1.GetSerializedPolygon]，以检索事件区域的多边形。
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”。预测事件的持续时间将超过模型的提前期。我们不知道实际的结束时间，但预测事件至少会持续到此时间。

方法
搜索最新的重大事件。