Here’s the information you see in the Traffic View feed:
- General traffic information: Routes, unusual traffic, ETAs
- Irregularities (also called unusual traffic): Alerts and traffic jams that affect an exceptionally large number of users
- Incidents/reports/alerts: Waze user generated reports and alerts related to a specific incident causing traffic.
Note: When you change the polygon or routes in the Traffic View tool, your feed changes too.
JSON Element |
Value |
Description |
alternateRoute |
A suggested route with a faster ETA for this route. This is only calculated for routes that have a jam level over 1 and ETA more than 2 minutes that free flow (traffic is slower at least by 2 mins) |
|
bbox |
Bounding box of the feed |
|
broadcasterId |
id of the feed owner in Waze database |
|
type |
See alert type table |
Event type |
subtype |
See alert subtypes table |
Event subtype - depends on atof parameter |
street |
String |
Street name (as is written in database, no canonical form, may be null) |
city |
String |
City and state name [City, State] in case both are available, [State] if not associated with a city. (supplied when available) |
country |
String |
(see two letters codes in http://en.wikipedia.org/wiki/ISO_3166-1) |
envelope |
Bounding box of the route |
|
historicTime |
Time in seconds it usually takes to cross this route on the current day of week and time |
|
id |
Route id in the database |
|
irregularities |
List of routes that are found as having high ETA relative to historic ETAs (a.k.a. Unusual traffic events) |
|
Under irregularities/route |
||
name |
Route name (i.e. major street name this route goes through, similar to route name a user sees when routes from the app) |
|
id |
A counter running starting with 0 that counts the number of irregularities on routes |
|
type |
Select "STATIC" for saved routes and irregularities of type road closed (closures), otherwise "DYNAMIC" |
|
fromName, toName |
Street names where routes starts/ends |
|
time, line, length, historicTime, jamLevel, envelope, alternateRoute, leadAlert |
As described in route definitions |
|
isMetric |
Indication to the UI what units to use in the display. |
|
jamLevel |
A route's jam level scales directly with traffic congestion. Level 0 represents no delays, while levels 1 to 3 signify increasing traffic slowdown. Level 4 indicates standstill, and level 5 signifies a full road closure. |
|
leadAlert |
One of many alerts on the route that’s prioritized as the most major one |
|
Under leadAlert: |
||
id |
Alert id (internal id) |
|
type |
Alert type |
|
subType |
Alert sub type |
|
reportByNickname |
Nickname of the reporter user |
|
reportByMood |
Mood id of the reporter user |
|
description |
Alert description as added by the reporting user (optional) |
|
numThumbsUp |
Number of thumbs up given by wazers to this alert |
|
numNotThereReports |
Number of thumbs down given by wazers to this alert |
|
City, Street |
of the alert (optional) |
|
reportTime |
When alert was reported |
|
position |
Alert location (latitude, longitude) |
|
length |
Length of route in meters |
|
lengthOfJams |
List of total length of jams in the bounding box by jam level (indicates how jammed the area is) |
|
line |
Route geometry |
|
subRoutes |
List of sub sub routes. When a route has any jams on it the route is split into sub routes, each of them with a different jam level. For example, a route could be split into 4 sub routes with corresponding jam levels 0,1,3,0. |
|
Under subRoutes: |
||
fromName, toName |
Street names where subroute starts and ends |
|
line, length, time, historicTime, jamLevel, envelope |
route data as described in basic definitions, just for sub route. |
|
name,fromName, toName |
Given by the feed owner, describes the route |
|
segments |
Segments ids of the route |
|
time |
Time in seconds it takes to cross the route right now (i.e. in the last check. Checks happen about every two minutes) |
|
type |
Always static |
|
usersOnJams - |
Count of users per jam level (these are relative weighted numbers) |
Traffic View feed example
{
"usersOnJams": [
{
"wazersCount": 1718,
"jamLevel": 0
},
{
"wazersCount": 0,
"jamLevel": 1
},
{
"wazersCount": 25,
"jamLevel": 2
},
{
"wazersCount": 0,
"jamLevel": 3
},
{
"wazersCount": 0,
"jamLevel": 4
}
],
"routes": [
{
"historicTime": 446,
"line": [
{
"x": -74.20689323194252,
"y": 40.64175770128392
},
{
"x": -74.14963579315261,
"y": 40.60903444419476
}
],
"bbox": {
"minY": 40.60903444419476,
"minX": -74.22707498420026,
"maxY": 40.643716689521995,
"maxX": -74.14963579315261
},
"length": 9846,
"type": "STATIC",
"jams": [],
"alerts": [],
"toName": "",
"name": "278 E",
"fromName": "",
"jamLevel": 0,
"id": 1376,
"time": 436
},
{
"subRoutes": [
{
"toName": "SR-139 W (lower)",
"historicTime": 358,
"line": [
{
"x": -74.006321,
"y": 40.722572
},
{
"x": -74.006582,
"y": 40.722752
},
{
"x": -74.085259,
"y": 40.730522
}
],
"bbox": {
"minY": 40.730522,
"minX": -74.085259,
"maxY": 40.740889,
"maxX": -74.062409
},
"fromName": "SR-139 W (lower)",
"length": 3520,
"jamLevel": 0,
"time": 261
}
],
"historicTime": 687,
"line": [
{
"x": -74.00632136441801,
"y": 40.7225729836073
},
{
"x": -74.08525957374057,
"y": 40.73052272482624
}
],
"bbox": {
"minY": 40.7225729836073,
"minX": -74.08525957374057,
"maxY": 40.740889,
"maxX": -74.00632136441801
},
"length": 9092,
"type": "STATIC",
"jams": [],
"alerts": [],
"toName": "",
"name": "78 W",
"fromName": "",
"jamLevel": 0,
"id": 1377,
"time": 735
}
],
"irregularities": [
{
"alerts": [],
"historicTime": -1,
"line": [
{
"x": -74.016234,
"y": 40.706399
},
{
"x": -74.010097,
"y": 40.70187
}
],
"bbox": {
"minY": 40.706399,
"minX": -74.016234,
"maxY": 40.706399,
"maxX": -74.016234
},
"name": "Double tube closure ",
"length": 1040,
"jamLevel": 5,
"id": 0,
"time": -1,
"type": "DYNAMIC",
"jams": [],
"leadAlert": {
"numComments": 0,
"comments": [],
"city": "Manhattan, NY",
"numThumbsUp": 0,
"street": "Battery Park Underpass",
"subType": "ROAD_CLOSED_EVENT",
"id": "alert-2130271205/3c856425-262f-3668-b03c-25d3b02c01f7",
"position": "40.706399 -74.016234",
"type": "ROAD_CLOSED",
"numNotThereReports": 0,
"isLeadAlert": true,
"reportTime": 1522084545431
}
},
{
"alerts": [],
"historicTime": -1,
"line": [
{
"x": -74.050004,
"y": 40.73128
},
{
"x": -74.062409,
"y": 40.73913
}
],
"bbox": {
"minY": 40.73128,
"minX": -74.050004,
"maxY": 40.73128,
"maxX": -74.050004
},
"name": "Construction ",
"length": 1414,
"jamLevel": 5,
"id": 1,
"time": -1,
"type": "DYNAMIC",
"jams": [],
"leadAlert": {
"numComments": 0,
"comments": [],
"city": "Jersey City, NJ",
"numThumbsUp": 0,
"street": "SR-139 W (lower)",
"subType": "ROAD_CLOSED_EVENT",
"id": "alert-2132049084/1c67d40f-2e98-30cb-a64a-ae153bfe850a",
"position": "40.73128 -74.050004",
"type": "ROAD_CLOSED",
"numNotThereReports": 0,
"isLeadAlert": true,
"reportTime": 1522077324308
}
}
],
"broadcasterId": "b9c6100b281f316fbc17b6d94f96524f",
"areaName": "ny_area",
"bbox": {
"minY": 40.208,
"minX": -74.75,
"maxY": 41.108,
"maxX": -73.38
},
"name": "New York Area | DEMO",
"isMetric": false,
"restrictions": {},
"lengthOfJams": [
{
"jamLevel": 1,
"jamLength": 1872
},
{
"jamLevel": 2,
"jamLength": 10461
},
{
"jamLevel": 3,
"jamLength": 9917
},
{
"jamLevel": 4,
"jamLength": 1470
},
{
"jamLevel": 5,
"jamLength": 43032
}
],
"updateTime": 1522138104077
}
Routes example
Alert types
ID |
Alert type |
Alert Subtype |
|
ACCIDENT |
|
||
JAM |
|
||
WEATHERHAZARD / HAZARD |
|
||
MISC |
|
||
CONSTRUCTION |
|
||
ROAD_CLOSED |
|
Irregularities (Unusual traffic jams) example