Upcoming Hazard API
The Upcoming Hazard API provides hazard assessments for the current day (maximum) based on environmental conditions at specified geographic locations. This API is crucial for users needing immediate upcoming risk evaluations to inform safety-related decisions.
The Upcoming Hazard API focuses on identifying and quantifying immediate environmental risks, such as extreme temperatures or wind conditions, providing users with actionable insights to manage and mitigate potential hazards in real-time.
- Hazard Variables
- Geographic Coverage
- Risk Levels
This endpoint returns all hazard information seen below.
Â
See variables
| Hazard Variable | Description |
|---|---|
| Humidex | Assesses heat hazards based on perceived temperature. |
| Windchill | Evaluates cold hazards based on wind and temperature. |
This endpoint offers global coverage, enabling hazard assessments for any geographic location worldwide.
Risk levels are dynamically calculated based on current conditions. See the detailed breakdown for specific thresholds.
Â
Humidex Risk Level Table
| Risk Index Value | Risk Zone Description | Numeric Range | Risk Description |
|---|---|---|---|
| 0 | No Risk | Humidex < 20 | No discomfort |
| 1 | Low Risk | 20 ≤ Humidex < 30 | Little discomfort |
| 2 | Moderate Risk | 30 ≤ Humidex < 40 | Some discomfort |
| 3 | High Risk | 40 ≤ Humidex < 45 | Great discomfort; avoid exertion |
| 4 | Very High Risk | Humidex ≥ 45 | Dangerous; heat stroke possible |
Windchill Risk Level Table
| Risk Index Value | Risk Zone Description | Numeric Range | Risk Description |
|---|---|---|---|
| 0 | No Risk | Windchill ≥ 0 | No discomfort |
| 1 | Low Risk | -9 ≤ Windchill < 0 | Slight increase in discomfort |
| 2 | Moderate Risk | -27 ≤ Windchill < -9 | Increased discomfort, with risk of hypothermia and frostbite |
| 3 | High Risk | -39 ≤ Windchill < -27 | Exposed skin can freeze in 10 to 30 minutes |
| 4 | Very High Risk | -47 ≤ Windchill < -39 | Exposed skin can freeze in 5 to 10 minutes |
| 5 | Severe Risk | -54 ≤ Windchill < -47 | Exposed skin can freeze in 2 to 5 minutes |
| 6 | Extreme Risk | Windchill < -54 | Exposed skin can freeze in less than 2 minutes |
Methodology​
The API dynamically calculates risk levels by analyzing the temperature, humidity, and wind data for the current day (i.e., 00:00 to 23:00 of local time, not UTC).
- Real-Time Data: Utilizes forecasted NOAA 0.25 weather for the current day (00:00 to 23:00 local time)
- Threshold-Based Analysis: Uses predefined thresholds to categorize hazard levels, allowing for immediate risk communication.
Inputs​
The API accepts the following parameters:
latitude&longitude: Geographical coordinates in decimal degrees where the hazard assessment is desired.
Interactive Endpoint​
You can access and interact with the API endpoints using our API Endpoint Directory.