Overview

Note

Any attributes not listed on this page should not be in use, they are in beta and might be deprecated or changed at a later date.

Severe Weather Events Category Subscriptions

Our API provides standardized severe weather events from many sources that can be compiled for "situational awareness", allowing managers to monitor the whole picture across all types of local, regional, and national alerts.

In addition to subscribing to any of the Severe Weather Events below, you can create Custom Insight conditions based on any of the data points listed in subscribed Data Layers, such that an event will trigger whenever they are met.

Accessing Severe Weather Events

Quickly access Severe Weather Events using our Events API and get prepared before a Severe Weather Event happens.

Event Title

Various weather conditions have different levels of risk. Therefore, the title of our predefined categories use the common multi-tier system mentioned below. It is highly recommended to follow this standard as well when defining your custom insights.

These are the common level, in increasing order:

Level

Description

Outlook

Issued daily to indicate that a hazardous event may occur in the next seven days and is intended to provide information to those who need considerable lead time to prepare for the event.

Advisory

Issued when a hazardous event is occurring, imminent, or likely (generally greater than 80% probability of occurrence), of a "less serious" nature such that may cause significant inconvenience, and if caution is not exercised could threaten life or property.

Emergency

Issued when an event that by itself cannot pose a threat to life or property, but may indirectly cause other events to happen that may pose a threat to life or property.

Watch

Issued when the risk of a hazardous event has increased significantly, (50 to 80% certainty that warning thresholds will be met) but its occurrence, location, or timing is still uncertain and is intended to provide enough lead time to set plans in motion can do so.

Warning

Issued when a hazardous event is occurring, imminent, or likely (generally greater than 80% probability of occurrence), thereby posing a threat to life or property.

Statement

Issued as a follow-up message to a warning, watch, or emergency, that may update, extend, or cancel the message it is following up or a notification of significant weather for which no type of advisory, watch, or warning exists.

Event Description

Usually, when reporting a weather event the following are expected to be described:

  • WHAT is going to happen?
  • WHERE will it take place?
  • WHEN will it occur?
  • IMPACTS that can be expected?
  • ACTIONS precautionary or in preparedness needed?

It is common and recommended to note each with a preceding asterisk and three periods affixed, such as * WHAT..., for improved readability.

Below is an example of a weather announcement description, as reported by the NWS:

* WHAT...For the High Surf Warning, dangerously large breakingwaves of 10 to 15 feet expected in the surf zone. For the HighRip Current Risk, dangerous rip currents expected.* WHERE...In Alabama, Mobile Coastal and Baldwin CoastalCounties. In Florida, Escambia Coastal and Santa Rosa CoastalCounties.* WHEN...For the High Surf Warning, from 6 AM Wednesday to 6 PMCDT Thursday. For the High Rip Current Risk, through Thursdayafternoon.* IMPACTS...Breaking waves can sweep people off jetties anddocks, and into dangerous seas. Life-threatening swimmingconditions and significant beach erosion can be expected. Ripcurrents can sweep even the best swimmers away from shore intodeeper water.

Event Severity

The code denoting the intensity of impact:

Level

Description

extreme

Extraordinary threat to life or property

severe

Significant threat to life or property

moderate

Possible threat to life or property

minor

Minimal to no known threat to life or property

unknown

Severity unknown

Event Urgency

The code denoting the time available to prepare:

Level

Description

immediate

Responsive action SHOULD be taken immediately

expected

Responsive action SHOULD be taken soon (within next hour)

future

Responsive action SHOULD be taken in the near future

past

Responsive action is no longer required

unknown

Urgency not known

Event Certainty

The code denoting the confidence in the observation or prediction:

Level

Description

observed

Determined to have occurred or to be ongoing

likely

Likely (p > ~50%)

possible

Possible but not likely (p <= ~50%)

unlikely

Not expected to occur (p ~ 0)

unknown

Certainty unknown

Event Response

An action code denoting the appropriate handling:

Action

Description

Shelter

Take shelter in place or as instructed

Evacuate

Relocate as instructed

Prepare

Make preparations as instructed

Execute

Execute a pre-planned activity as instructed

Avoid

Avoid the subject event as instructed

Monitor

Attend to information sources as instructed

Assess

Evaluate the information in this message

All Clear

The subject event no longer poses a threat or concern, follow-up as instructed

None

No action recommended

Event Instruction

A text details the extended human-readable instructions, for example: "Slow down and use caution while traveling. The latest road conditions for the state you are calling from can be obtained by calling 5 1 1."

Event Geocodes and Locations

geocodes is an array of geographically-based strings that describe the event target area, as mentioned in the geocodeType attribute, whereas location is a GeoJSON Geometry representing the entire coverage area (can be a Point, Polygon or MultiPolygon).