Road Weather Analytics
https://data.api.xweather.com/roadweather/analytics/The roadweather/analytics endpoint is powered by the advanced and precise Vaisala Xweather road weather forecasts and provides complete access to the Vaisala Xweather road weather forecasts. With the Road Weather Analytics add-on, the API further details the road surface condition (dry, wet, snow, ice) and road surface temperature, comprehensive road weather insights, including water, snow, and ice thickness, hydroplane and turnover probabilities, visibility, and fog probabilities. 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/analytics/{action}?client_id={client_id}&client_secret={client_secret}&{params}Supported Actions
The following actions are supported with the /roadweather/analytics 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
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
Available with a Road Weather Addon.
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.
periods.#.roadSurface.waterFilmThicknessMM (number)
The estimated water film thickness on the road surface in millimeters.
periods.#.roadSurface.waterFilmThicknessIN (number)
The estimated water film thickness on the road surface in inches.
periods.#.roadSurface.snowThicknessCM (number)
The estimated snow thickness on the road surface in centimeters.
periods.#.roadSurface.snowThicknessIN (number)
The estimated snow thickness on the road surface in inches.
periods.#.roadSurface.iceThicknessMM (number)
The estimated ice thickness on the road surface in millimeters.
periods.#.roadSurface.iceThicknessIN (number)
The estimated ice thickness on the road surface in inches.
periods.#.roadSurface.conditionProbability (object)
Object of probabilities of the road surface conditions.
periods.#.roadSurface.conditionProbability.dry (number)
The probability the road surface is dry, from 0 to 100.
periods.#.roadSurface.conditionProbability.wet (number)
The probability the road surface is wet, from 0 to 100.
periods.#.roadSurface.conditionProbability.snow (number)
The probability the road surface is snow covered, from 0 to 100.
periods.#.roadSurface.conditionProbability.ice (number)
The probability the road surface is ice covered, from 0 to 100.
periods.#.riskProbability (object)
Object of risk probabilities.
periods.#.riskProbability.truckRollover (number)
The risk probability of a truck rollover, from 0 to 100.
periods.#.riskProbability.hydroplane (number)
The risk probability of hydroplaning (also known as aquaplaning), from 0 to 100.
periods.#.riskProbability.lowVisFog (number)
The risk probability of low visibility due to fog, from 0 to 100.
periods.#.riskProbability.lowVisBlowingSnow (number)
The risk probability of low visibility due to blowing snow, from 0 to 100.
periods.#.weatherConditions ()
Object of the atmospheric weather conditions
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,
"waterFilmThicknessMM": 0,
"waterFilmThicknessIN": 0,
"snowThicknessCM": 0,
"snowThicknessIN": 0,
"iceThicknessMM": 0,
"iceThicknessIN": 0,
"conditionProbability": {
"dry": 100,
"wet": 0,
"snow": 0,
"ice": 0
}
},
"riskProbability": {
"truckRollover": 0,
"hydroplane": 0,
"lowVisFog": 0,
"lowVisBlowingSnow": 0
},
"weatherConditions": null
},
{
"timestamp": 1702597500,
"dateTimeISO": "2023-12-14T17:45:00-06:00",
"summary": "GREEN",
"summaryIndex": 0,
"roadSurface": {
"condition": "DRY",
"tempC": 4.5,
"tempF": 40.1,
"waterFilmThicknessMM": 0,
"waterFilmThicknessIN": 0,
"snowThicknessCM": 0,
"snowThicknessIN": 0,
"iceThicknessMM": 0,
"iceThicknessIN": 0,
"conditionProbability": {
"dry": 100,
"wet": 0,
"snow": 0,
"ice": 0
}
},
"riskProbability": {
"truckRollover": 0,
"hydroplane": 0,
"lowVisFog": 0,
"lowVisBlowingSnow": 0
},
"weatherConditions": null
},
{
"timestamp": 1702598400,
"dateTimeISO": "2023-12-14T18:00:00-06:00",
"summary": "GREEN",
"summaryIndex": 0,
"roadSurface": {
"condition": "DRY",
"tempC": 4.2,
"tempF": 39.56,
"waterFilmThicknessMM": 0,
"waterFilmThicknessIN": 0,
"snowThicknessCM": 0,
"snowThicknessIN": 0,
"iceThicknessMM": 0,
"iceThicknessIN": 0,
"conditionProbability": {
"dry": 100,
"wet": 0,
"snow": 0,
"ice": 0
}
},
"riskProbability": {
"truckRollover": 0,
"hydroplane": 0,
"lowVisFog": 0,
"lowVisBlowingSnow": 0
},
"weatherConditions": null
},
{
"timestamp": 1702599300,
"dateTimeISO": "2023-12-14T18:15:00-06:00",
"summary": "GREEN",
"summaryIndex": 0,
"roadSurface": {
"condition": "DRY",
"tempC": 3.9,
"tempF": 39.02,
"waterFilmThicknessMM": 0,
"waterFilmThicknessIN": 0,
"snowThicknessCM": 0,
"snowThicknessIN": 0,
"iceThicknessMM": 0,
"iceThicknessIN": 0,
"conditionProbability": {
"dry": 100,
"wet": 0,
"snow": 0,
"ice": 0
}
},
"riskProbability": {
"truckRollover": 0,
"hydroplane": 0,
"lowVisFog": 0,
"lowVisBlowingSnow": 0
},
"weatherConditions": null
},
{
"timestamp": 1702600200,
"dateTimeISO": "2023-12-14T18:30:00-06:00",
"summary": "GREEN",
"summaryIndex": 0,
"roadSurface": {
"condition": "DRY",
"tempC": 3.6,
"tempF": 38.48,
"waterFilmThicknessMM": 0,
"waterFilmThicknessIN": 0,
"snowThicknessCM": 0,
"snowThicknessIN": 0,
"iceThicknessMM": 0,
"iceThicknessIN": 0,
"conditionProbability": {
"dry": 100,
"wet": 0,
"snow": 0,
"ice": 0
}
},
"riskProbability": {
"truckRollover": 0,
"hydroplane": 0,
"lowVisFog": 0,
"lowVisBlowingSnow": 0
},
"weatherConditions": null
},
{
"timestamp": 1702601100,
"dateTimeISO": "2023-12-14T18:45:00-06:00",
"summary": "GREEN",
"summaryIndex": 0,
"roadSurface": {
"condition": "DRY",
"tempC": 3.4,
"tempF": 38.12,
"waterFilmThicknessMM": 0,
"waterFilmThicknessIN": 0,
"snowThicknessCM": 0,
"snowThicknessIN": 0,
"iceThicknessMM": 0,
"iceThicknessIN": 0,
"conditionProbability": {
"dry": 100,
"wet": 0,
"snow": 0,
"ice": 0
}
},
"riskProbability": {
"truckRollover": 0,
"hydroplane": 0,
"lowVisFog": 0,
"lowVisBlowingSnow": 0
},
"weatherConditions": null
},
{
"timestamp": 1702602000,
"dateTimeISO": "2023-12-14T19:00:00-06:00",
"summary": "GREEN",
"summaryIndex": 0,
"roadSurface": {
"condition": "DRY",
"tempC": 2.8,
"tempF": 37.04,
"waterFilmThicknessMM": 0,
"waterFilmThicknessIN": 0,
"snowThicknessCM": 0,
"snowThicknessIN": 0,
"iceThicknessMM": 0,
"iceThicknessIN": 0,
"conditionProbability": {
"dry": 100,
"wet": 0,
"snow": 0,
"ice": 0
}
},
"riskProbability": {
"truckRollover": 0,
"hydroplane": 0,
"lowVisFog": 0,
"lowVisBlowingSnow": 0
},
"weatherConditions": null
},
{
"timestamp": 1702605600,
"dateTimeISO": "2023-12-14T20:00:00-06:00",
"summary": "GREEN",
"summaryIndex": 0,
"roadSurface": {
"condition": "DRY",
"tempC": 1.8,
"tempF": 35.24,
"waterFilmThicknessMM": 0,
"waterFilmThicknessIN": 0,
"snowThicknessCM": 0,
"snowThicknessIN": 0,
"iceThicknessMM": 0,
"iceThicknessIN": 0,
"conditionProbability": {
"dry": 100,
"wet": 0,
"snow": 0,
"ice": 0
}
},
"riskProbability": {
"truckRollover": 0,
"hydroplane": 0,
"lowVisFog": 0,
"lowVisBlowingSnow": 0
},
"weatherConditions": null
},
{
"timestamp": 1702609200,
"dateTimeISO": "2023-12-14T21:00:00-06:00",
"summary": "GREEN",
"summaryIndex": 0,
"roadSurface": {
"condition": "DRY",
"tempC": 1.2,
"tempF": 34.16,
"waterFilmThicknessMM": 0,
"waterFilmThicknessIN": 0,
"snowThicknessCM": 0,
"snowThicknessIN": 0,
"iceThicknessMM": 0,
"iceThicknessIN": 0,
"conditionProbability": {
"dry": 100,
"wet": 0,
"snow": 0,
"ice": 0
}
},
"riskProbability": {
"truckRollover": 0,
"hydroplane": 0,
"lowVisFog": 0,
"lowVisBlowingSnow": 0
},
"weatherConditions": null
},
{
"timestamp": 1702612800,
"dateTimeISO": "2023-12-14T22:00:00-06:00",
"summary": "GREEN",
"summaryIndex": 0,
"roadSurface": {
"condition": "DRY",
"tempC": 0.8,
"tempF": 33.44,
"waterFilmThicknessMM": 0,
"waterFilmThicknessIN": 0,
"snowThicknessCM": 0,
"snowThicknessIN": 0,
"iceThicknessMM": 0,
"iceThicknessIN": 0,
"conditionProbability": {
"dry": 100,
"wet": 0,
"snow": 0,
"ice": 0
}
},
"riskProbability": {
"truckRollover": 0,
"hydroplane": 0,
"lowVisFog": 0,
"lowVisBlowingSnow": 0
},
"weatherConditions": null
},
{
"timestamp": 1702616400,
"dateTimeISO": "2023-12-14T23:00:00-06:00",
"summary": "GREEN",
"summaryIndex": 0,
"roadSurface": {
"condition": "DRY",
"tempC": 0.5,
"tempF": 32.9,
"waterFilmThicknessMM": 0,
"waterFilmThicknessIN": 0,
"snowThicknessCM": 0,
"snowThicknessIN": 0,
"iceThicknessMM": 0,
"iceThicknessIN": 0,
"conditionProbability": {
"dry": 100,
"wet": 0,
"snow": 0,
"ice": 0
}
},
"riskProbability": {
"truckRollover": 0,
"hydroplane": 0,
"lowVisFog": 0,
"lowVisBlowingSnow": 0
},
"weatherConditions": null
},
{
"timestamp": 1702620000,
"dateTimeISO": "2023-12-15T00:00:00-06:00",
"summary": "GREEN",
"summaryIndex": 0,
"roadSurface": {
"condition": "DRY",
"tempC": 0.4,
"tempF": 32.72,
"waterFilmThicknessMM": 0,
"waterFilmThicknessIN": 0,
"snowThicknessCM": 0,
"snowThicknessIN": 0,
"iceThicknessMM": 0,
"iceThicknessIN": 0,
"conditionProbability": {
"dry": 100,
"wet": 0,
"snow": 0,
"ice": 0
}
},
"riskProbability": {
"truckRollover": 0,
"hydroplane": 0,
"lowVisFog": 0,
"lowVisBlowingSnow": 0
},
"weatherConditions": null
},
{
"timestamp": 1702623600,
"dateTimeISO": "2023-12-15T01:00:00-06:00",
"summary": "GREEN",
"summaryIndex": 0,
"roadSurface": {
"condition": "DRY",
"tempC": 0.9,
"tempF": 33.62,
"waterFilmThicknessMM": 0,
"waterFilmThicknessIN": 0,
"snowThicknessCM": 0,
"snowThicknessIN": 0,
"iceThicknessMM": 0,
"iceThicknessIN": 0,
"conditionProbability": {
"dry": 100,
"wet": 0,
"snow": 0,
"ice": 0
}
},
"riskProbability": {
"truckRollover": 0,
"hydroplane": 0,
"lowVisFog": 0,
"lowVisBlowingSnow": 0
},
"weatherConditions": null
},
{
"timestamp": 1702627200,
"dateTimeISO": "2023-12-15T02:00:00-06:00",
"summary": "GREEN",
"summaryIndex": 0,
"roadSurface": {
"condition": "DRY",
"tempC": 1.5,
"tempF": 34.7,
"waterFilmThicknessMM": 0,
"waterFilmThicknessIN": 0,
"snowThicknessCM": 0,
"snowThicknessIN": 0,
"iceThicknessMM": 0,
"iceThicknessIN": 0,
"conditionProbability": {
"dry": 100,
"wet": 0,
"snow": 0,
"ice": 0
}
},
"riskProbability": {
"truckRollover": 0,
"hydroplane": 0,
"lowVisFog": 0,
"lowVisBlowingSnow": 0
},
"weatherConditions": null
},
{
"timestamp": 1702630800,
"dateTimeISO": "2023-12-15T03:00:00-06:00",
"summary": "GREEN",
"summaryIndex": 0,
"roadSurface": {
"condition": "DRY",
"tempC": 1.8,
"tempF": 35.24,
"waterFilmThicknessMM": 0,
"waterFilmThicknessIN": 0,
"snowThicknessCM": 0,
"snowThicknessIN": 0,
"iceThicknessMM": 0,
"iceThicknessIN": 0,
"conditionProbability": {
"dry": 100,
"wet": 0,
"snow": 0,
"ice": 0
}
},
"riskProbability": {
"truckRollover": 0,
"hydroplane": 0,
"lowVisFog": 0,
"lowVisBlowingSnow": 0
},
"weatherConditions": null
},
{
"timestamp": 1702634400,
"dateTimeISO": "2023-12-15T04:00:00-06:00",
"summary": "GREEN",
"summaryIndex": 0,
"roadSurface": {
"condition": "DRY",
"tempC": 1.9,
"tempF": 35.42,
"waterFilmThicknessMM": 0,
"waterFilmThicknessIN": 0,
"snowThicknessCM": 0,
"snowThicknessIN": 0,
"iceThicknessMM": 0,
"iceThicknessIN": 0,
"conditionProbability": {
"dry": 100,
"wet": 0,
"snow": 0,
"ice": 0
}
},
"riskProbability": {
"truckRollover": 0,
"hydroplane": 0,
"lowVisFog": 0,
"lowVisBlowingSnow": 0
},
"weatherConditions": null
},
{
"timestamp": 1702638000,
"dateTimeISO": "2023-12-15T05:00:00-06:00",
"summary": "GREEN",
"summaryIndex": 0,
"roadSurface": {
"condition": "DRY",
"tempC": 1.8,
"tempF": 35.24,
"waterFilmThicknessMM": 0,
"waterFilmThicknessIN": 0,
"snowThicknessCM": 0,
"snowThicknessIN": 0,
"iceThicknessMM": 0,
"iceThicknessIN": 0,
"conditionProbability": {
"dry": 100,
"wet": 0,
"snow": 0,
"ice": 0
}
},
"riskProbability": {
"truckRollover": 0,
"hydroplane": 0,
"lowVisFog": 0,
"lowVisBlowingSnow": 0
},
"weatherConditions": null
},
{
"timestamp": 1702641600,
"dateTimeISO": "2023-12-15T06:00:00-06:00",
"summary": "GREEN",
"summaryIndex": 0,
"roadSurface": {
"condition": "DRY",
"tempC": 1.9,
"tempF": 35.42,
"waterFilmThicknessMM": 0,
"waterFilmThicknessIN": 0,
"snowThicknessCM": 0,
"snowThicknessIN": 0,
"iceThicknessMM": 0,
"iceThicknessIN": 0,
"conditionProbability": {
"dry": 100,
"wet": 0,
"snow": 0,
"ice": 0
}
},
"riskProbability": {
"truckRollover": 0,
"hydroplane": 0,
"lowVisFog": 0,
"lowVisBlowingSnow": 0
},
"weatherConditions": null
},
{
"timestamp": 1702645200,
"dateTimeISO": "2023-12-15T07:00:00-06:00",
"summary": "GREEN",
"summaryIndex": 0,
"roadSurface": {
"condition": "DRY",
"tempC": 2.3,
"tempF": 36.14,
"waterFilmThicknessMM": 0,
"waterFilmThicknessIN": 0,
"snowThicknessCM": 0,
"snowThicknessIN": 0,
"iceThicknessMM": 0,
"iceThicknessIN": 0,
"conditionProbability": {
"dry": 100,
"wet": 0,
"snow": 0,
"ice": 0
}
},
"riskProbability": {
"truckRollover": 0,
"hydroplane": 0,
"lowVisFog": 0,
"lowVisBlowingSnow": 0
},
"weatherConditions": null
},
{
"timestamp": 1702648800,
"dateTimeISO": "2023-12-15T08:00:00-06:00",
"summary": "GREEN",
"summaryIndex": 0,
"roadSurface": {
"condition": "DRY",
"tempC": 2.5,
"tempF": 36.5,
"waterFilmThicknessMM": 0,
"waterFilmThicknessIN": 0,
"snowThicknessCM": 0,
"snowThicknessIN": 0,
"iceThicknessMM": 0,
"iceThicknessIN": 0,
"conditionProbability": {
"dry": 100,
"wet": 0,
"snow": 0,
"ice": 0
}
},
"riskProbability": {
"truckRollover": 0,
"hydroplane": 0,
"lowVisFog": 0,
"lowVisBlowingSnow": 0
},
"weatherConditions": null
},
{
"timestamp": 1702652400,
"dateTimeISO": "2023-12-15T09:00:00-06:00",
"summary": "GREEN",
"summaryIndex": 0,
"roadSurface": {
"condition": "DRY",
"tempC": 3.4,
"tempF": 38.12,
"waterFilmThicknessMM": 0,
"waterFilmThicknessIN": 0,
"snowThicknessCM": 0,
"snowThicknessIN": 0,
"iceThicknessMM": 0,
"iceThicknessIN": 0,
"conditionProbability": {
"dry": 100,
"wet": 0,
"snow": 0,
"ice": 0
}
},
"riskProbability": {
"truckRollover": 0,
"hydroplane": 0,
"lowVisFog": 0,
"lowVisBlowingSnow": 0
},
"weatherConditions": null
},
{
"timestamp": 1702656000,
"dateTimeISO": "2023-12-15T10:00:00-06:00",
"summary": "GREEN",
"summaryIndex": 0,
"roadSurface": {
"condition": "DRY",
"tempC": 4.8,
"tempF": 40.64,
"waterFilmThicknessMM": 0,
"waterFilmThicknessIN": 0,
"snowThicknessCM": 0,
"snowThicknessIN": 0,
"iceThicknessMM": 0,
"iceThicknessIN": 0,
"conditionProbability": {
"dry": 100,
"wet": 0,
"snow": 0,
"ice": 0
}
},
"riskProbability": {
"truckRollover": 0,
"hydroplane": 0,
"lowVisFog": 0,
"lowVisBlowingSnow": 0
},
"weatherConditions": null
},
{
"timestamp": 1702659600,
"dateTimeISO": "2023-12-15T11:00:00-06:00",
"summary": "GREEN",
"summaryIndex": 0,
"roadSurface": {
"condition": "DRY",
"tempC": 6.3,
"tempF": 43.34,
"waterFilmThicknessMM": 0,
"waterFilmThicknessIN": 0,
"snowThicknessCM": 0,
"snowThicknessIN": 0,
"iceThicknessMM": 0,
"iceThicknessIN": 0,
"conditionProbability": {
"dry": 80,
"wet": 20,
"snow": 0,
"ice": 0
}
},
"riskProbability": {
"truckRollover": 0,
"hydroplane": 0,
"lowVisFog": 0,
"lowVisBlowingSnow": 0
},
"weatherConditions": null
},
{
"timestamp": 1702663200,
"dateTimeISO": "2023-12-15T12:00:00-06:00",
"summary": "GREEN",
"summaryIndex": 0,
"roadSurface": {
"condition": "MOIST",
"tempC": 6.1,
"tempF": 42.98,
"waterFilmThicknessMM": 0.014,
"waterFilmThicknessIN": 0.00059999999999993,
"snowThicknessCM": 0,
"snowThicknessIN": 0,
"iceThicknessMM": 0,
"iceThicknessIN": 0,
"conditionProbability": {
"dry": 60,
"wet": 40,
"snow": 0,
"ice": 0
}
},
"riskProbability": {
"truckRollover": 0,
"hydroplane": 7,
"lowVisFog": 0,
"lowVisBlowingSnow": 0
},
"weatherConditions": null
}
],
"profile": {
"elevM": 242,
"elevFT": 793.96,
"tz": "America/Chicago"
}
}
]