Travel Time Matrix API
Overview
The Travel Time Matrix API calculates travel times and distances between multiple locations.
Built for high performance needs, a single request can process 100,000 locations in a few hundred milliseconds.
The API supports a range of transport modes including Driving, Public Transport, Walking, and Cycling.
Typical use cases for a Travel Time Matrix include:
- Adding travel times to a search application (e.g property portals, job boards, hotel booking sites) to improve relevancy of results and user experience
- Route optimisation to increase scheduling efficiency
- Last mile logistics to optimise deliveries
- Ad serving to drive up CTRs
The Travel Time Matrix API is accessible through 3 different endpoints. When choosing which endpoint is most suitable for your use case, the main criteria to consider are configurability of the request parameters vs scale and performance.
| Endpoint Name | Travel Time Matrix | Travel Time Matrix Fast | Travel Time Matrix Fast (Protobuf) |
|---|---|---|---|
| Format | JSON | JSON | Protocol Buffers |
| Maximum Matrix Size | 10 x 2,000 | 10 x 100,000 | 1 x 200,000 |
| Maximum Travel Time | 4 hours | 2 hours | 2 hours |
| Configurability | Extensive parameters | Just transport mode | Just transport mode |
A full breakdown of the differences between the different Travel Time Matrix endpoints can be found here.
For the simplest way to get up and running, we'd recommend starting with the Travel Time Matrix Fast endpoint.
| Endpoint Name | Travel Time Matrix | Travel Time Matrix Fast | Travel Time Matrix Fast (Protobuf) |
|---|---|---|---|
| Access URL | https://api.traveltimeapp.com/v4/time-filter | https://api.traveltimeapp.com/v4/time-filter/fast | http://proto.api.traveltimeapp.com/api/v2 |
| Request Type | POST / GET | POST | POST |
If you already have a TravelTime account then log in to retrieve your access credentials. If you don't have an account, you can sign up for free here.
To authenticate with the Protobuf endpoint, please request access at support@traveltime.com
Getting Started
A short step-by-step guide to making your first request to the Travel Time Matrix API.
An interactive tool for testing the different request parameters, and to help understand the request and response structures.
Full endpoint reference of all request parameters, and example code samples.
Supported SDKs
The Travel Time Matrix API is accessible through any of our supported TravelTime SDKs:
The Travel Time Matrix Fast (Protobuf) endpoint is also accessible through two supported database plugins:
Usage limits
The following usage limits apply to the Travel Time Matrix API:
Maximum 250 matrices per minute
*A matrix is a single request which can include multiple origins and destinations.The maximum matrix size that can be included in a single request differs by endpoint:
| Endpoint Name | Travel Time Matrix | Travel Time Matrix Fast | Travel Time Matrix Fast (Protobuf) |
|---|---|---|---|
| Matrix Size | 10 x 2,000 | 10 x 100,000 | 1 x 200,000 |
The maximum travel time support is different for each endpoint. Any origin-destination pairs outside of this limit will be returned as Unreachable.
| Endpoint Name | Travel Time Matrix | Travel Time Matrix Fast | Travel Time Matrix Fast (Protobuf) |
|---|---|---|---|
| Travel Time (hours) | 4 | 3 | 2 |
Other TravelTime APIs
