Events API

This endpoint will allow you to query for weather events (from any of the data layers in your current plan) by specifying:

location - GeoJSON of a Point, LineString, or Polygon up to 10 Million square KM (limited to Severe Weather Events).
triggers - pre-defined categories like "fires" or custom Insight rules
buffer - KM around location, such that the response includes all values on observations or predictions.

Note that an Insight triggers can only be coupled with a Location that is currently monitored by an Alert.

Event

An event object has the following attributes, in accordance with Common Alerting Protocols like the OASIS standard:

Attribute	Description
`insight`	The conditions that started the subject event - either an `insightId` or a pre-defined category like `fires`
`startTime`	The expected time of the beginning of the subject event
`endTime`	The expected time of the end of the subject event
`updateTime`	The updated time of the subject event
`severity`	The code denoting the intensity of impact
`certainty`	The code denoting the confidence in the observation or prediction
`urgency`	The code denoting the time available to prepare
`eventValues`	In addition to the common values listed below, certain event types may have distinct values - as described under the relevant Severe Weather section. `title` A brief human-readable description of the conditions that occasioned this event `origin` The text identifying the source of the subject event, e.g., a met operator or a specific device/sensor `location` The location of the subject event, in a GeoJSON geometry format `distance` The distance from the queried location (according to the precision), measures in KM `direction` The direction from the queried location, measure in degrees counter-clockwise from due north `description` (optional) An extended, human-readable description of the hazard or event that occasioned this message `instruction` (optional) An extended, human-readable instruction to targeted recipients
`triggerValues`	The sub-set of `eventValues` for which the subject event was resolved in the query.