REST Resource: significantEvents

Resource: SignificantEvent

Significant events are predicted flood events with high probability and high impact. They cover places where we don't have quality-verified gauges.

JSON representation
{
  "eventInterval": {
    object (SignificantEventInterval)
  },
  "affectedCountryCodes": [
    string
  ],
  "affectedPopulation": integer,
  "areaKm2": number,
  "gaugeIds": [
    string
  ],
  "eventPolygonId": string
}
Fields
eventInterval

object (SignificantEventInterval)

Start and end time of the event.

affectedCountryCodes[]

string

The affected countries, in ISO 3166 alpha-2 format. The list contains all countries that are predicted to be affected by the event, going forward.

affectedPopulation

integer

The estimated population in the affected area. It represents the population that is predicted to be affected by the event, going forward.

areaKm2

number

The area of the event in km^2. It represents the area that is predicted to be affected by the event, going forward.

gaugeIds[]

string

A list of gauges in the event. The list contains all gauges that are predicted to be affected by the event, going forward.

eventPolygonId

string

A polygon ID that can be sent to [serializedPolygons.get][google.research.floodforecasting.v1.GetSerializedPolygon] to retrieve the polygon of the area of the event.

SignificantEventInterval

A time interval of a significant event.

JSON representation
{
  "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.
}
Fields
startTime

string

The start time of the event. In ISO 8601 format, e.g. "2025-03-17T10:34:00Z".

Union field predicted_end_time. The end time of the event. predicted_end_time can be only one of the following:
endTime

string

The end time of the event. In ISO 8601 format, e.g. "2025-03-25T10:34:00Z".

minimumEndTime

string

The minimum end time of the event. In ISO 8601 format, e.g. "2025-03-25T10:34:00Z". The event is predicted to last longer than the model's lead time. We don't know the actual end time, but the event is predicted to last at least until this time.

Methods

Search for latest significant events.