Unscheduled Events
Live coverage of breaking events such as severe weather and terrorism. The API updates minute to minute to ensure accuracy.
Last updated
Was this helpful?
Live coverage of breaking events such as severe weather and terrorism. The API updates minute to minute to ensure accuracy.
Last updated
Was this helpful?
Severe weather is any dangerous meteorological phenomenon with the potential to cause damage, serious social disruption, or loss of human life. Types of severe weather phenomena vary, depending on the latitude, altitude, topography, and atmospheric conditions.
Severe weather warnings or alerts which may lead to disruption. Severe weather alerts include storms, extreme temperature, flood, etc. For example, a for southeastern Webster Parish in northwestern Louisiana alerts people that a severe thunderstorm along with damage in the nearby area is likely to occur in the upcoming hour.
Severe weather storm events can change over time. Events like hurricanes, tornados and other storms move across different locations and change in strength as time goes on. This can be reflected by different warning events in our system. It’s possible to have multiple warnings about the same weather condition:
The bad weather condition lasts longer than expected. For example, a in east Tennessee that the potential threat may last until 3 PM. Another that indicates additional rainfall may occur on the day and the following day, and the road closures will remain in place.
Multiple areas can be affected. For example, On March 14th, several regions in South Dakota have issued blizzard warnings, such as , , , and .
Warnings may be issued hours or days in advance. The event (warning) state will change to cancelled if the potential threat no longer exist. For example the storm didn't hit as expected. Past events with an active state mean the event has happened.
Severe weather data is updated in near real time with event details being refreshed on average every 15 mins.
PredictHQ provides historical severe weather data that can be used for purposes like training a demand forecasting model.
LABELS
This category is classified into three buckets with the following labels used to identify the type of severe weather.
Storm
storm, tornado, blizzard, dust, hurricane, cyclone, rain, wind, typhoon, sand
Extreme Temperature
cold-wave, heat-wave, air-quality, snow
Flood
flood
Start date
Yes
End date
Yes
Start time
Yes
The weather warnings’ start time indicate when the warning starts to be effective.
End time
Yes
The weather warnings’ end time indicate when the warning expires.
Timezone
Yes
Note: Datetime is in UTC
Severe weather is an area event. with the latitude and longitude is pointing to the center of the impacted area.
Severe weather events have no entities available.
PHQ Rank
Severe weather events have PHQ Rank available.
CAP features evaluate the event from three aspects: urgency, severity and certainty. For example, a warning about an extreme (severity) weather condition that is likely (certainty) to happen immediately (urgency) will have a higher rank. The table below shows the weight of each value of severity, urgency, and certainty when calculating the PHQ Rank.
For example, An event with an urgency of immediate (15), a severity of severe (36), and a certainty of observed (35) would have a PHQ Rank of 86.
Urgency
Immediate
Expected
Future
Past
Responsive action should be taken immediately
Responsive action should be taken soon (within next hour)
Responsive action should be taken in the near future
Responsive action is no longer required
15
13
10
8
Severity
Extreme
Severe
Moderate
Minor
Extraordinary threat to life or property
Significant threat to life or property
Possible threat to life or property
Minimal to no known threat to life or property
40
36
21
5
Certainty
Observed
Likely
Possible
Unlikely
Determined to have occurred or to be ongoing
Likely
Possible but not likely
Not expected to occur
35
31
10
0
Local Rank
Severe weather events have no Local Rank available as they impact an entire area instead of a specific point.
PHQ Attendance
Severe weather events have no PHQ Attendance available as the rank/impact only reflects its influence on an area, rather than a specific amount of attendees at a specific location.
Disaster events are major adverse events resulting from natural processes of the Earth, for example, earthquakes, volcanoes, tsunamis, etc. The reduction and/or limitation of social activities that are forced by COVID-19 pandemic is also classified under the disaster category.
These events tend to be high-impact disasters noticed at a regional or country level.
Labels
This category is classified into three buckets with the following labels used to identify the type of disasters.
Hydrological_geophysical
earthquake, avalanche, landslide, volcano, tsunami, ashfall
Note: Earthquake coverage typically includes magnitude 4 and above earthquakes.
Climatological
fire, wildfire, drought
Lockdown
Start date
Yes
End date
Yes
Disaster events may or may not have an end date & time.
Start time
Yes
End time
Yes
Timezone
Yes
Note: Datetime is in UTC
Disaster is an area event with the latitude and longitude pointing to the center of the impacted area.
Disaster events have no entities available.
PHQ Rank
Disaster events have PHQ Rank available, which indicates the severity of the disasters.
The lockdown events consider the level of restriction, the maximum number of people allowed in a public social gathering, etc.
Local Rank
Disaster events have no Local Rank available as they impact an entire area instead of a specific point.
PHQ Attendance
Disasters events have no PHQ Attendance available as the rank/impact only reflects its influence on an area, rather than a specific amount of attendees at a specific location.
Airport delays are events that indicate a scheduled flight getting delayed at a specified airport at a specified time.
Labels
All airport delays events have both airport and delay labels.
Start date
Yes
End date
Yes
Start time
Yes
End time
Yes
All airport delays events are expected to have an end time as it indicates when the delay is expired.
Timezone
Yes
Note: Datetime is in UTC
All airport delays are point events, the latitude and longitude are pointing to the specific airport.
Airport delays have venue entities available.
PHQ Rank
Airport delays events have PHQ Rank available, indicating the severity of the delay that affects passengers’ travel plans.
Minimal airport delays events have a PHQ Rank of 20.
Moderate airport delays events have a PHQ Rank of 40.
Significant airport delays events have a PHQ Rank of 70.
Severe airport delays events have a PHQ Rank of 90.
Local Rank
Airport delays events have no Local Rank available as they impact an entire area instead of a specific point. To be specific, the fact of the flight delay happens in an airport, but the impact is applying to a region where the passengers are from.
PHQ Attendance
Airport delays events have no PHQ Attendance available as the rank/impact only reflects its influence on an area, rather than a specific amount of attendees at a specific location.
This category will cover events related to infectious diseases. Some events will refer to localised outbreaks, some to nationwide epidemics, some to government mandated restrictions due to COVID-19.
Labels
This category is classified into three buckets with the following labels used to identify the type of health warnings.
Epidemic
Pandemic, epidemic or epidemic-hazard, for example, COVID-19, Cholera, etc
biological-hazard
Diseases and insect infestations, for example, food poisoning warnings, infection warnings, etc.
Government mandated restrictions
There are seven government mandated events in the US on a state level. These events indicate if a government body has mandated that the activity stays open or closed during a specified period of time.
If no end time is specified on government mandated restriction events, the event has yet to end.
bars-open / bars-closed : Bars and other drinking establishment that serves alcoholic beverages are open or closed.
restaurant-open / restaurant-closed : On-site dining facilities are open or closed.
retail-open / retail-closed : On-premise / physical activity of selling goods and services to consumers are open or closed.
recreation-open / recreation-closed : Activity or recreation engaged in out of doors, most commonly in natural settings (gyms, pools, beaches, camping grounds) are open or closed.
entertainment-open / entertainment-closed : an event, performance, location or activity designed to entertain others (casinos, movie theaters, museums, galleries and aquariums) are open or closed.
personal-care-open / personal-care-closed : Both physical assistance and/or prompting and supervising the performance of direct personal care tasks as determined by the consumer's needs (salons, barbers, nail salons) are open or closed.
worship-open / worship-closed : Any building where congregations gather for prayer are open or closed.
Start date
Yes
End date
Yes
Government mandated restrictions may have an end date if it’s available, it should cover the whole period in which restrictions are in place or have been lifted.
Start time
Yes
The pandemic or epidemic hazard events use the official announcement time as the start time.
End time
No
Timezone
Yes
Note: Datetime is in UTC
Health warnings events are area events. It may scope to a city, a region or a country depending on the impact. The latitude and longitude relates to the center of the impacted area.
Health warnings events have no entities available.
PHQ Rank
Health warnings events have PHQ Rank available.
It considers the severity of the disease, for example, the number of infected, death, area range, etc.
All government mandated restrictions have a PHQ Rank of 90 as it affects all residents in the impacted area.
Local Rank
Health warnings events have no Local Rank available as they impact an entire area instead of a specific point.
PHQ Attendance
Health warnings events have no PHQ Attendance available as the rank/impact only reflects its influence, rather than a specific amount of attendees at a specific location.
An act of terrorism committed using violence against civilians, with the intention/effect of causing mass / widespread fear and intimidation, in order to attain political, religious or ideological goals.
Note attempted (but failed) terror attacks are also included. This category focuses more in areas outside of designated warzones, as war zones are in a constant state of conflict.
Labels
Labels for a terror event provide more information about the event. The most common 5 labels are:
attack: An aggressive and violent act against a person or place with weapons or armed force.
arson: The terrorism acts also result in a fire damage, it may it may be combined with a shooting, bombing, etc.
Start date
Yes
End date
Yes
Terror events may have an end date and time available.
Start time
Yes
End time
Yes
Timezone
Yes
Note: Datetime is in UTC
Terror events may have venue entities available such as if the attack happens in a building.
PHQ Rank
Terror events have PHQ Rank available. It indicates the severity of the terrorism act, from the number of injured, fatalities, also if the location is a tourism country vs the war-torn country.
Local Rank
Terror events have no Local Rank available as they impact an entire area instead of a specific point. To be specific, the terrorism acts may happen at a specific location, but the impact is applying to all residents in the nearby area.
PHQ Attendance
Terror events have no PHQ Attendance available as the rank/impact only reflects its influence on an area, rather than a specific amount of attendees at a specific location.
The PHQ Rank indicates the severity of the bad weather, with using the data. CAP is an international non-proprietary digital message format for all-hazard emergency events. The benefit of using CAP is there is consistency in how it is implemented in different countries, making it easier to use. CAP alerts can be geographically targeted to a defined warning area.
The government mandated stay-at-home orders during the COVID-19 pandemic that restrict or reduce social activities on different levels. Lockdown events have health, lockdown and disaster labels. For example, , .
The natural disaster events consider information, number of injured, deaths, evacuated, etc.
bombing : The terrorism acts where the main injury or damage is caused by dropping or detonating a bomb somewhere, for example, .
hostage-crisis: The terrorism acts when the hostage occurs, for example, , a terror threat, etc.
shooting: The terrorism acts where the main injury or damage is caused by shooting, for example, . If the shooting is on a larger scale, the mass-shooting label will be added, for example, .
Terror events are tracked as an event with a scope of locality. In terms of geographic information we return a latitude/longitude for the event and the address of the event. However, terror events can apply to a wider area, for example, .