Road Risk API

Road Risk API concept

Road Risk API provides weather data and national alerts at the point of destination and along a route.

Road Risk API responds weather data with national alerts along a route that is set up as a massive of points where each point is a pair of latitude, longitude and time. For each point, the API returns air temperature, wind, precipitation, dew point. For the US and EU territories, we also provide road surface temperature and black ice road state. Active national alerts include alert description, national agency name, and the event hazardous level.

Weather forecast is available for 5 days with minute granularity for the 2 hours from the current moment and hourly granularity for the rest. Historical data is accessible for 1 previous year.

Get access

How to request Road Risk API

Method: POST

Header: Content-Type: application/json

API call

https://api.openweathermap.org/data/2.5/roadrisk?appid={API key}
Parameters
lat required Geographical coordinates (latitude) of the point from the specified track
lon required Geographical coordinates (longitude) of the point from the specified track
dt required Date and time for each point of the specified track

Unix time
appid required Your unique API key (you can always find it on your account page under the "API key" tab)
Please note that you can set up the date not earlier than 1 year from the current time and not later than 5 days from the current time.
Example of the request body
                   
{ 
  "track": [
    {
      "lat": 30.680439786468128,
      "lon": -88.81896972656251,
      "dt": 1602702000
    },
    {
      "lat": 30.56699087315334,
      "lon": -89.44519042968751,
      "dt": 1602702000
    }
  ]
}

Road Risk API response

Example of the API response
                   
[
  {
    "dt": 1602702000,
    "coord": [
      7.27,
      44.04
    ],
    "weather": {
      "temp": 278.44,
      "wind_speed": 2.27,
      "wind_deg": 7,
      "precipitation_intensity": 0.38,
      "dew_point": 276.13
    },
    "road": {
            "state": 0,
            "temp": 293.85
        },
    "alerts": [
      {
        "sender_name": "METEO-FRANCE",
        "event": "Moderate thunderstorm warning",
        "event_level": 2
      }
    ]
  },
  {
    "dt": 1602702400,
    "coord": [
      7.37,
      45.04
    ],
    "weather": {
      "temp": 282.44,
      "wind_speed": 1.84,
      "wind_deg": 316,
      "precipitation_intensity": 0,
      "dew_point": 275.99
    },
    "road": {
            "state": 0,
            "temp": 293.85
        },
    "alerts": [
      
    ]
  }
]

Fields in API response

  • dt Date and time from the specified track
  • coord Coordinates from the specified track
  • weather
    • weather.temp Temperature
    • weather.wind_speed Wind speed. Units - metre/sec
    • weather.wind_deg Wind direction, degrees (meteorological)
    • weather.precipitation_intensity Intensity of precipitation, mm/hour
    • weather.dew_point Atmospheric temperature (varying according to pressure and humidity) below which water droplets begin to condense and dew can form
  • road
    • road.state (only for the US and EU territories) Road conditions. It could be one of the following values:
      • 0 - No report,
      • 16 - Black ice warning
    • road.temp (only for the US and EU territories) Road surface temperature
  • alerts
    • alerts.sender_name Name of the alert source
    • alerts.event Alert event name
    • alerts.event_level Level of the alert severity. Available values:
      • 0 - Unknown
      • 1 - Green (no awareness required)
      • 2 - Yellow (potential danger)
      • 3 - Orange (dangerous weather)
      • 4 - Red (very dangerous weather)

List of national weather warning sources

Agency Country
Institute of GeoSciences, Energy, Water and Environment of Albania Albania
National Meteorological Office Algeria
National Weather Service of Argentina Argentina
Australian Bureau of Meteorology Australia
  • Central Institute for Meteorology and Geodynamics
  • Water Balance Department
 Austria
Bahrain Meteorological Directorate Bahrain
Barbados Meteorological Service Barbados
State institution "Republican center for hydrometeorology, control of radioactive contamination and environmental monitoring" (Belhydromet) Belarus
Royal Meteorological Institute Belgium
National Meteorological Service of Belize Belize
National Meteorological Agency (METEO-BENIN) Benin
  • Federal Hydrometeorological Institute of BiH
  • Republic Hydrometeorological Institute
 Bosnia and Herzegovina
Botswana Meteorological Services Botswana
National Meteorological Institute - INMET Brazil
National Institute of Meteorology and Hydrology - Plovdiv branch Bulgaria
Cameroon National Meteorological Service Cameroon
  • Alberta Emergency Management Agency (Government of Alberta, Ministry of Municipal Affairs)
  • Meteorological Service of Canada
  • Quebec Ministry of Public Safety
  • Yukon Emergency Measures Organization
  • Manitoba Emergency Management Organization
 Canada
Meteorological Directorate of Chile Chile
National Civil Aviation Agency (ANAC Congo) Congo
National Meteorological Institute of Costa Rica Costa Rica
State Hydrometeorological Institute (DHMZ) Croatia
Meteorological Department Curacao Curacao and Sint Maarten
Republic of Cyprus - Department of Meteorology Cyprus
Czech Hydrometeorological Institute Czech Republic
Danish Meteorological Institute Denmark
Ecuadoran Institute for Meteorology and Hydrology (INAMHI) Ecuador
Egyptian Meteorological Authority Egypt
Estonian Environment Agency Estonia
Eswatini Meteorological Service Eswatini
Finnish Meteorological Institute Finland
Meteo-France France
General Directorate of Meteorology of Gabon Gabon
German Meteorological Office Germany
Ghana Meteorological Agency Ghana
Hellenic National Meteorological Service Greece
National Meteorological Agency of Guinea Guinea
Hydrometeorological Service of Guyana Guyana
Hong Kong Observatory Hong Kong China
Hungarian Meteorological Service Hungary
Icelandic Meteorological Office Iceland
India Meteorological Department India
  • Agency for Meteorology Climatology and Geophysics of Republic Indonesia (BMKG)
  • InaTEWS BMKG
 Indonesia
Ireland: Met Eireann - Irish Meteorological Service Ireland
Israel Meteorological Service Israel
Italian Air Force National Meteorological Service Italy
Airport, aeronautical and meteorological operating and development company (SODEXAM) Ivory Coast
Meteorological Service of Jamaica Jamaica
Japan Meteorological Business Support Center Japan
Jordanian Meteorological Department Jordan
National Hydrometeorological Service of the Republic of Kazakhstan (Kazhydromet) Kazakhstan
Kenya Meteorological Department Kenya
Kuwait Meteorological Department Kuwait
Latvian Environment, Geology and Meteorology Center Latvia
Lesotho Meteorological Services Lesotho
Libyan National Meteorological Center Libya
Lithuanian Hydrometeorological Service under the Ministry of Environment of the Republic of Lithuania (LHMS) Lithuania
Luxembourg Airport Administration Luxembourg
Macao Meteorological and Geophysical Bureau Macao China
METEO Madagascar Madagascar
Malawi Department of Climate Change and Meteorological Services Malawi
Maldives Meteorological Service Maldives
National Meteorological Office of Mauritania Mauritania
Mauritius Meteorological Services Mauritius
CONAGUA - National Meteorological Service of Mexico Mexico
State Hydrometeorological Service of Moldova Moldova
National Agency Meteorology and the Environmental Monitoring of Mongolia Mongolia
National Institute of Meteorology of Mozambique Mozambique
Myanmar Department of Meteorology and Hydrology Myanmar
Royal Netherlands Meteorological Institute (KNMI) Netherlands
  • Meteorological Service of New Zealand Limited
  • National Emergency Management Agency
  • Fire and Emergency New Zealand
  • Civil Defence Emergency Management (CDEM) Groups
 New Zealand
New Zealand Emergency Mobile Alert New Zealand
National Meteorological Directorate of Niger Niger
Nigerian Meteorological Agency (NiMet) Nigeria
National Hydrometeorological Service - Republic of Macedonia North Macedonia
  • Norwegian Meteorological Institute
  • Norwegian Water Resources and Energy Directorate
 Norway
Directorate of Meteorology and Hydrology Paraguay
Philippine Atmospheric Geophysical and Astronomical Services Administration Philippines
Institute of Meteorology and Water Management (IMGW-PIB) Poland
Portuguese Institute of Sea and Atmosphere, I.P. Portugal
Qatar Meteorology Department Qatar
Korea Meteorological Administration, Weather Information Republic of Korea
National Meteorological Administration Romania
Hydrometcenter of Russia Russia-EN
Russian Federal Service for Hydrometeorology and Environmental Monitoring Russia-RU
National Center for Meteorology - Kingdom of Saudi Arabia Saudi Arabia
Republic Hydrometeorological Service of Serbia Serbia
Seychelles Meteorological Authority Seychelles
Meteorological Service Singapore Singapore
Slovak Hydrometeorological Institute Slovakia
National Meteorological Service of Slovenia Slovenia
Solomon Islands Meteorological Service Solomon Islands
South African Weather Service (SAWS) South Africa
State Meteorological Agency (AEMET) Spain
Sudan Meteorological Authority Sudan
Swedish Meteorological and Hydrological Institute Sweden
MeteoSwiss Switzerland
Tanzania Meteorological Authority Tanzania
Thai Meteorological Department Thailand
National Directorate of Meteorology and Geophysics of Timor-Leste Timor-Leste
Trinidad and Tobago Meteorological Service Trinidad and Tobago
Ukrainian Hydrometeorological Center Ukraine
UK Met Office United Kingdom of Great Britain and Northern Ireland
Uruguayan Institute of Meteorology Uruguay
  • Environmental Protection Agency (EPA), Air Quality Alerts
  • Integrated Public Alerrt and Warning System (IPAWS)
  • National Oceanic and Atmospheric Administration (NOAA), National Tsunami Warning Center
  • National Oceanic and Atmospheric Administration (NOAA), National Weather Service
  • National Oceanic and Atmospheric Administration (NOAA), National Weather Service - Marine Zones
  • U.S. Geological Survey (USGS), Volcano Hazard Program
 United States
National Oceanic and Atmospheric Administration USA
Yemeni Civil Aviation and Meteorology Authority (CAMA) Yemen
Meteorological Department Zambia Zambia
Meteorological Services Department Zimbabwe
We use cookies to personalize content and to analyze our traffic. Please decide if you are willing to accept cookies from our website.
Advanced Settings