Skip To Content
ArcGIS Developer
Dashboard

Traffic map service

You can use the traffic map service to visualize real time traffic speeds and incidents such as accidents, construction sites, or street closures. Traffic visualization displays information about how travel speeds on specific road segments change over time. The traffic incidents in the map service provides the location of the incidents and some attributes such as the severity, the expected start and end time, as well as the description of the incident. The traffic speed and incident data is updated every five minutes.

The traffic map service acts as a good background layer to display the results from Routing services. The traffic data used by the traffic map service is also used by the Routing services when performing analysis. If you want to emphasize why a particular route was returned by the route service, you can display the traffic map along with the route to show areas of traffic congestion that influenced the choice of roads used by the route.

The traffic data used by the service is updated every five minutes. Each traffic update also includes traffic speed predictions for the next 4 hours. This allows you to visualize traffic for future planning. The service archives the traffic information for up to 4 hours. This allows you to visualize traffic speeds within an 8-hour time window. The traffic incidents are not archived and are refreshed with every update.

Traffic speeds in the service are displayed as a percentage of free-flow speeds, which is typically the speed limit or how fast cars tend to travel when unencumbered by other vehicles. The streets are color coded as follows:

  • Green (fast): 85—100 percent of free flow speeds
  • Yellow (moderate)—65 to 85 percent of free flow speeds
  • Orange (slow)—45 to 65 percent of free flow speeds
  • Red (stop and go)—0 to 45 percent of free flow speeds

The IncidentType field in the traffic incident layers can have the following values:

  • ACCIDENT
  • CONGESTION
  • CONSTRUCTION
  • DISABLED VEHICLE
  • LANE_RESTRICTION
  • MASS TRANSIT
  • MISCELLANEOUS
  • OTHER NEWS
  • PLANNED EVENT
  • ROAD HAZARD
  • ROAD_CLOSURE
  • WEATHER

The Severity field in the traffic incident layers can have the following values:

  • critical
  • major
  • minor
  • low impact
The critical value indicates a road closure, and major indicates a blockage of multiple lanes. The minor and low impact values indicate incidents that have progressively less impact as compared to incidents with the major value.

Work with the traffic web map

A traffic web map is available in ArcGIS Online that can be used to create browser-based and device-based apps that require traffic visualization. The web map includes a streets basemap for reference as well as preconfigured pop-ups for point features that provide additional information about the incidents. You can add other operational layers to the traffic web map and create your own web map or a web mapping app using the configurable templates available from ArcGIS Online. See the Create apps from maps topic to learn about the ways you can develop apps using web maps.

Work with the traffic map service

The traffic map service is a dynamic map service built on ArcGIS Server technology, so functionality that is listed in the Map Service topic is available with the traffic map service.

The traffic map service can be used with ArcGIS Maps SDK for Javascript to create fully customized web mapping apps or with ArcGIS Maps SDKs for Native Apps to build app for desktop and mobile devices. When using the APIs, the URL for the traffic map service is specified as https://traffic.arcgis.com/arcgis/rest/services/World/Traffic/MapServer.

You can use the traffic map service to request an image containing traffic visualization for your area of interest at a given time instant. The traffic service generates an image based on the one or more layers from the service that represent the area of interest. The layers in the service represent traffic speeds and traffic incident information for a region. A region is composed of one or more countries that support traffic visualization. The Data coverage topic provides the classification of countries into regions and can be used to determine the region corresponding to the area of interest.

For each region, the traffic map service contains a layer named Traffic that represents street speeds based on both historical and live traffic where available. Historical traffic is based on the average of observed speeds over the past three years. The traffic map service also contains a layer named Live Traffic that represents only those streets that support live traffic speeds. Depending on your app, you may want to request an image with one of the two layers being visible. For each region that supports traffic incidents, the traffic map service provides three layers representing traffic incidents. The layers become visible at certain map scales and provide symbology that is relevant at the given scale. For example, the Traffic Incidents Overview layer only symbolizes critical and major incidents. However, the Traffic Incidents Detailed layer symbolizes critical, major, minor, and low impact incidents.

To work with the layers in the traffic map service, you must specify the IDs for the layers, not the layer names. The following table lists the IDs for the various layers in the traffic map service:

Region nameLayer nameLayer ID

North America

Traffic Incidents Overview

2

Traffic Incidents Intermediate

3

Traffic Incidents Detailed

4

Live Traffic

6

Traffic

7

South America

Traffic Incidents Overview

10

Traffic Incidents Intermediate

11

Traffic Incidents Detailed

12

Live Traffic

14

Traffic

15

Europe

Traffic Incidents Overview

18

Traffic Incidents Intermediate

19

Traffic Incidents Detailed

20

Live Traffic

22

Traffic

23

Middle East and Africa

Traffic Incidents Overview

26

Traffic Incidents Intermediate

27

Traffic Incidents Detailed

28

Live Traffic

30

Traffic

31

Asia Pacific

Traffic Incidents Overview

46

Traffic Incidents Intermediate

47

Traffic Incidents Detailed

48

Live Traffic

42

Traffic

43

India

Live Traffic

34

Traffic

35

South East Asia

Live Traffic

38

Traffic

39

Legacy:

Do not use the Traffic and Live Traffic layers for the India and South East Asia regions, since the same content is available as part of the Traffic and Live Traffic layers for the Asia Pacific region. The traffic map service default visibility value for these layers is false.