Frequently Asked Questions (FAQs)
What is TomTom's Traffic API?
TomTom’s Traffic API is a suite of web services designed for developers to create web and mobile applications around real-time traffic. It provides access to real-time traffic data, including traffic incidents and traffic flow information.
What services are included in the Traffic API?
The Traffic API includes two main services: Traffic Incidents and Traffic Flow. The Traffic Incidents service provides information about traffic jams and incidents on a road network such as road closures and blocked roads. The Traffic Flow service provides real-time observed speeds and travel times for key roads in a network.
What data is available through the Traffic API?
The Traffic API provides various data points, such as real-time traffic incident details (location, type, etc.), traffic segment details (free-flow speed, current speed, confidence values) and delay severity information.
Are there any limitations or usage restrictions for the Traffic API?
Specific limitations or usage restrictions may be mentioned in the API documentation or terms of service provided by TomTom. We recommend that you refer to the official documentation for detailed information regarding usage limits, licensing and any other restrictions.
Is historical traffic data available through the Traffic API?
The Traffic API primarily focuses on real-time traffic data. However, TomTom offers other products and solutions that incorporate historical traffic data, such as the Traffic Stats API. Please view the relevant documentation for more information about what you can do with Traffic Stats API.
Does the SDK display traffic icons like roadwork, accidents etc?
The TomTom Map Display module provides real-time traffic updates.
- You can show this on the map by adding a layer with traffic flow and a layer with traffic incidents.
- To show or hide these layers call on the
TomTomMap(Android) /Map(iOS) object, and call the methods:TrafficFloworTrafficIncidents
Does the SDK display traffic status?
Yes. There are two ways to show traffic: flow and incidents. Both are available as layers on the map.
- The traffic incidents layer shows delays and incident icons.
- The traffic flow layer shows both freeflow and congested stretches of road.
Are the traffic icons clickable and display information in the SDK?
If the user taps on a traffic incident icon, the listener is triggered with the list of:
- TrafficIncident objects and the
GeoCoordinateof the clicked location (Android). - TrafficIncident objects and the
CLLocationCoordinate2Dof the clicked location (iOS).
On both platforms, the TrafficIncident provides information about the incident, such as:
- a description of the cause (along with an icon category),
- delay in seconds, and
- an estimate of when the incident will end.
Nevertheless, it is the developer's responsibility to display the traffic incident data in a way that's appropriate to their app.