Important Note
Explore ready-to-use traffic reports and data visualizations immediately by signing up for a 30-day free trial on the MOVE Portal. Once registered, you'll receive an API key to start using the Traffic Analytics APIs right away. Alternatively, you may contact our Sales team for a tailored solution.

What is Traffic Stats?

Traffic Stats is a suite of web services designed for developers to analyze historical traffic data.

Traffic Stats is based on Floating Car Data (FCD) — a proven method of measuring what's happening on the road. Millions of TomTom navigation devices, in-dash systems, and apps send anonymized FCD data to our servers in real time, from which we derive historical traffic information. This gives valuable insight into traffic conditions on the road network throughout the day.

This documentation covers two ways to use Traffic Stats:

• Traffic Stats API — a set of RESTful APIs for developers who want to build Route Analysis, Area Analysis, and Traffic Density directly into their own applications.
• Traffic Stats in the MOVE Portal — a ready-to-use reference implementation for running queries and generating reports through a web interface, no coding required.

Getting Started

1. Request access to TrafficStats via your local partner or TomTom account manager.
2. Read the API documentation and start coding.

To enable the 30-day free trial of Traffic Stats — whether through the MOVE Portal or the API — you'll need to create a MOVE account at move.tomtom.com. Once your account is set up, you can:

• Generate Traffic Stats reports directly in MOVE for 30 days, or
• Retrieve an API key to start calling the Traffic Stats API — once logged in to MOVE, your API key can be found in the menu.

Common use-cases you can implement

• Measure the stability in travel time on a defined route.
• Analyze speed on every road segment to determine congestion bottlenecks and their effects.
• Measure the travel time before and after a change in the road network in order to assess the change.
• Detect the impact on traffic of seasons, events and incidents.
• Measure the accessibility of a route or area, year on year.
• Identify and prioritize congestion bottlenecks in an area.
• Display speeds (V85, Average, Median) on a map.
• Measure the attractiveness of a location by reviewing the relative car volume.
• Use the speeds and travel times in transportation models as the actual driven ground truth.

Feature list

Harness the power of TomTom Historical Traffic for your application! The TomTom Traffic Stats API provides the user with a defined route or area, date range and time slices, and all speed and travel time statistics that you require, and contains the following services.

Route Analysis service

The Route Analysis service returns both route-based and segment-based statistics in XLS, SHAPE, and JSON format. Route statistics you receive:

• The average route sample size
• The average travel time
• The median travel time
• The average speed (kilometers or miles per hour)
• The 15th and 85th percentile speed
• The travel time ratio
• The 5th - 95 percentile travel time

As part of Route Analysis you also receive for each road segment in your route the following statistics:

• The average speed
• The speed limit
• The street name
• The median speed
• The standard deviation
• The travel time ratio
• The Speed percentiles
• The Speed Limit and Road Name of each segment

Area Analysis service

The Area Analysis service returns statistics for each road segment in each open direction in SHAPE and JSON format. For each segment you obtain the following statistics:

• Average travel time
• Average speed
• Median speed
• Standard deviation speed
• Sample size
• 5 - 95 percentile speed
• The Speed Limit, Road Name, and Functional Road Class

Traffic Density service

The Traffic Density API returns the amount of data available for each road segment in each open direction in SHAPE and JSON format. For each segment you obtain the number of probes that can be used for further calculations.