Road Weather Conditions

URL Path

https://data.api.xweather.com/roadweather/conditions/

Data Coverage

US, Canada, Japan, Europe, Australia, New Zealand

Update Interval

6 hours; 15 min the first +2 hours

Time Range

+24 hours

Access Multiplier

The /roadweather/conditions endpoint is powered by the advanced and precise Vaisala Xweather road weather forecasts. This innovative endpoint delivers essential information on road conditions through a summary index (green, yellow, or red), enabling users to gauge driving safety at a glance, the road surface condition (dry, wet, snow, ice) and road surface temperature.

Road weather forecasts are available at 15-minute intervals for the first 2 hours, then hourly intervals for up to 24 hours.

For comprehensive road weather insights, including water, snow, and ice thickness, hydroplane and turnover probabilities, visibility, and fog probabilities, the Road Weather Analytics endpoint is available. Enhance your application's capabilities with this cutting-edge road weather endpoint to help users make better-informed decisions and promote safer driving experiences.

Requests

Every request to the endpoint must include one of the supported actions in the url.

https://data.api.xweather.com/roadweather/conditions/{action}?client_id={client_id}&client_secret={client_secret}&{params}

Supported Actions

The following actions are supported with the /roadweather/conditions endpoint:

Action	Description
:id	Type: stringTypically used for passing a geographical location name or identifier such as city name, lat/long, or even US and Canadian postal codes. Learn more.
route	Type: stringAllows you to pass several coordinates along a custom route to return data points at each location. Learn more.

Response

The following is an example of what each object in the response will consist of. Depending on your requested action, the response may contain multiple instances of this object within an array.

Properties

id (string)

The ID of the requested location.

dataSource (string)

An ID string of the data source provider utilized for the data set

road (object)

An object containing the nearby road information. Null if unavailable.

road.type (string)

The type of road. Can be:
- primary
- secondary
- tertiary
- bridge

road.name (string)

The road name. Null if unavailable.

loc (object)

The location of the record.

loc.lat (number)

The latitude coordinate of the record.

loc.long (number)

The place or nearest place to the record.

place (object)

Object containing information about the place or nearest place to the record.

place.name (string)

The place or nearest place to the record.

place.state (string)

The state abbreviation in which the response is located. This may be null or an empty string depending on the country.

place.country (string)

The 2 letter ISO-3166 country abbreviation in which the response is located.

periods (array)

An array of the road weather forecast periods

periods.#.timestamp (number)

The unix timestamp in seconds of the valid date/time of the forecast

periods.#.dateTimeISO (string)

The date and time of the forecast in ISO-8601 format

periods.#.summary (string)

A summary of road conditions broken down as:
- GREEN = dry roads with no issues
- YELLOW = Potential for wet roads, extend caution
- RED = Potential adverse road conditions.

periods.#.summaryIndex (number)

A numerical version of the road conditions summary:
- 0 = GREEN
- 1 = YELLOW
- 2 = RED

Available to all Flex Subscribers.

periods.#.roadSurface (object)

An object containing advanced road surface information.

periods.#.roadSurface.condition (string)

The condition of the road surface. Will be one of the following:
- DRY
- MOIST
- WET
- SLUSH
- SNOW
- ICE

periods.#.roadSurface.tempC (number)

The temperature of the road surface in degrees Celsius.

periods.#.roadSurface.tempF (number)

The temperature of the road surface in degrees Fahrenheit.

profile (object)

Object containing information about the location or event.

profile.elevM (number)

The elevation of the location in meters.

profile.elevFT (number)

The elevation of the location in feet.

profile.tz (string)

Timezone name of the location, such as America/New_York.

[
  {
    "id": "79wefx4",
    "dataSource": "vaisala-road-wx",
    "road": {
      "type": "primary",
      "name": "Washington Avenue South"
    },
    "loc": {
      "lat": 44.97997,
      "long": -93.26384
    },
    "place": {
      "name": "minneapolis",
      "state": "mn",
      "country": "us"
    },
    "periods": [
      {
        "timestamp": 1702596600,
        "dateTimeISO": "2023-12-14T17:30:00-06:00",
        "summary": "GREEN",
        "summaryIndex": 0,
        "roadSurface": {
          "condition": "DRY",
          "tempC": 4.8,
          "tempF": 40.64
        }
      },
      {
        "timestamp": 1702597500,
        "dateTimeISO": "2023-12-14T17:45:00-06:00",
        "summary": "GREEN",
        "summaryIndex": 0,
        "roadSurface": {
          "condition": "DRY",
          "tempC": 4.5,
          "tempF": 40.1
        }
      },
      {
        "timestamp": 1702598400,
        "dateTimeISO": "2023-12-14T18:00:00-06:00",
        "summary": "GREEN",
        "summaryIndex": 0,
        "roadSurface": {
          "condition": "DRY",
          "tempC": 4.2,
          "tempF": 39.56
        }
      },
      {
        "timestamp": 1702599300,
        "dateTimeISO": "2023-12-14T18:15:00-06:00",
        "summary": "GREEN",
        "summaryIndex": 0,
        "roadSurface": {
          "condition": "DRY",
          "tempC": 3.9,
          "tempF": 39.02
        }
      },
      {
        "timestamp": 1702600200,
        "dateTimeISO": "2023-12-14T18:30:00-06:00",
        "summary": "GREEN",
        "summaryIndex": 0,
        "roadSurface": {
          "condition": "DRY",
          "tempC": 3.6,
          "tempF": 38.48
        }
      },
      {
        "timestamp": 1702601100,
        "dateTimeISO": "2023-12-14T18:45:00-06:00",
        "summary": "GREEN",
        "summaryIndex": 0,
        "roadSurface": {
          "condition": "DRY",
          "tempC": 3.4,
          "tempF": 38.12
        }
      },
      {
        "timestamp": 1702602000,
        "dateTimeISO": "2023-12-14T19:00:00-06:00",
        "summary": "GREEN",
        "summaryIndex": 0,
        "roadSurface": {
          "condition": "DRY",
          "tempC": 2.8,
          "tempF": 37.04
        }
      },
      {
        "timestamp": 1702605600,
        "dateTimeISO": "2023-12-14T20:00:00-06:00",
        "summary": "GREEN",
        "summaryIndex": 0,
        "roadSurface": {
          "condition": "DRY",
          "tempC": 1.8,
          "tempF": 35.24
        }
      },
      {
        "timestamp": 1702609200,
        "dateTimeISO": "2023-12-14T21:00:00-06:00",
        "summary": "GREEN",
        "summaryIndex": 0,
        "roadSurface": {
          "condition": "DRY",
          "tempC": 1.2,
          "tempF": 34.16
        }
      },
      {
        "timestamp": 1702612800,
        "dateTimeISO": "2023-12-14T22:00:00-06:00",
        "summary": "GREEN",
        "summaryIndex": 0,
        "roadSurface": {
          "condition": "DRY",
          "tempC": 0.8,
          "tempF": 33.44
        }
      },
      {
        "timestamp": 1702616400,
        "dateTimeISO": "2023-12-14T23:00:00-06:00",
        "summary": "GREEN",
        "summaryIndex": 0,
        "roadSurface": {
          "condition": "DRY",
          "tempC": 0.5,
          "tempF": 32.9
        }
      },
      {
        "timestamp": 1702620000,
        "dateTimeISO": "2023-12-15T00:00:00-06:00",
        "summary": "GREEN",
        "summaryIndex": 0,
        "roadSurface": {
          "condition": "DRY",
          "tempC": 0.4,
          "tempF": 32.72
        }
      },
      {
        "timestamp": 1702623600,
        "dateTimeISO": "2023-12-15T01:00:00-06:00",
        "summary": "GREEN",
        "summaryIndex": 0,
        "roadSurface": {
          "condition": "DRY",
          "tempC": 0.9,
          "tempF": 33.62
        }
      },
      {
        "timestamp": 1702627200,
        "dateTimeISO": "2023-12-15T02:00:00-06:00",
        "summary": "GREEN",
        "summaryIndex": 0,
        "roadSurface": {
          "condition": "DRY",
          "tempC": 1.5,
          "tempF": 34.7
        }
      },
      {
        "timestamp": 1702630800,
        "dateTimeISO": "2023-12-15T03:00:00-06:00",
        "summary": "GREEN",
        "summaryIndex": 0,
        "roadSurface": {
          "condition": "DRY",
          "tempC": 1.8,
          "tempF": 35.24
        }
      },
      {
        "timestamp": 1702634400,
        "dateTimeISO": "2023-12-15T04:00:00-06:00",
        "summary": "GREEN",
        "summaryIndex": 0,
        "roadSurface": {
          "condition": "DRY",
          "tempC": 1.9,
          "tempF": 35.42
        }
      },
      {
        "timestamp": 1702638000,
        "dateTimeISO": "2023-12-15T05:00:00-06:00",
        "summary": "GREEN",
        "summaryIndex": 0,
        "roadSurface": {
          "condition": "DRY",
          "tempC": 1.8,
          "tempF": 35.24
        }
      },
      {
        "timestamp": 1702641600,
        "dateTimeISO": "2023-12-15T06:00:00-06:00",
        "summary": "GREEN",
        "summaryIndex": 0,
        "roadSurface": {
          "condition": "DRY",
          "tempC": 1.9,
          "tempF": 35.42
        }
      },
      {
        "timestamp": 1702645200,
        "dateTimeISO": "2023-12-15T07:00:00-06:00",
        "summary": "GREEN",
        "summaryIndex": 0,
        "roadSurface": {
          "condition": "DRY",
          "tempC": 2.3,
          "tempF": 36.14
        }
      },
      {
        "timestamp": 1702648800,
        "dateTimeISO": "2023-12-15T08:00:00-06:00",
        "summary": "GREEN",
        "summaryIndex": 0,
        "roadSurface": {
          "condition": "DRY",
          "tempC": 2.5,
          "tempF": 36.5
        }
      },
      {
        "timestamp": 1702652400,
        "dateTimeISO": "2023-12-15T09:00:00-06:00",
        "summary": "GREEN",
        "summaryIndex": 0,
        "roadSurface": {
          "condition": "DRY",
          "tempC": 3.4,
          "tempF": 38.12
        }
      },
      {
        "timestamp": 1702656000,
        "dateTimeISO": "2023-12-15T10:00:00-06:00",
        "summary": "GREEN",
        "summaryIndex": 0,
        "roadSurface": {
          "condition": "DRY",
          "tempC": 4.8,
          "tempF": 40.64
        }
      },
      {
        "timestamp": 1702659600,
        "dateTimeISO": "2023-12-15T11:00:00-06:00",
        "summary": "GREEN",
        "summaryIndex": 0,
        "roadSurface": {
          "condition": "DRY",
          "tempC": 6.3,
          "tempF": 43.34
        }
      },
      {
        "timestamp": 1702663200,
        "dateTimeISO": "2023-12-15T12:00:00-06:00",
        "summary": "GREEN",
        "summaryIndex": 0,
        "roadSurface": {
          "condition": "MOIST",
          "tempC": 6.1,
          "tempF": 42.98
        }
      }
    ],
    "profile": {
      "elevM": 242,
      "elevFT": 793.96,
      "tz": "America/Chicago"
    }
  }
]

Endpoints