The Large-Scale Matrix Routing service is an asynchronous HTTP JSON API that calculates routing matrices of up to 10,000 origins and 10,000 destinations.
A routing matrix is a matrix with rows labeled by origins and columns by destinations. Each entry of the matrix is travel time or distance from the origin to the destination corresponding to the row and column of the entry.
The Large-Scale Matrix Routing service provides the following features:
- Large number of origins and destinations (up to 10,000)
- Live traffic and historical speed patterns
- Car and Truck modes
- Truck attributes such as dimension, weight, tunnel restrictions and more
- Avoiding areas and routing features like toll roads and ferries
- Asynchronous API for flexible result downloads
To calculate a routing matrix, you provide the following information to the service:
- A list of origins and destinations. Typically you specify origins and destinations using geographic coordinates.
- Either a geographical region which contains the coordinates and inside of which the routes will be calculated (see Region), or a profile which enables calculation of routes with arbitrary length but has only a predefined set of options available (see Profiles).
See Use Cases for more detailed description when to use a specific region or a predefined profile. For the full API specification, see the API Reference.
Some notable abilities and limitations of the service are:
- The service is particularly suitable for a large number of origins and destinations - it can compute matrices up to 10,000 x 10,000. The matrices don't have to be quadratic. For example, you might want to compute the distances from one origin to several destinations.
- To enable custom options and dynamic traffic, the origins and destinations should be confined to a specific region, defined in the matrix request. The region can be a bounding box, polygon or circle with a maximum diameter of 400 km. It can be derived automatically from the provided origins and destinations. See Region.
- To compute matrices with routes of arbitrary length without limitation of 400 km diameter region, the service offers a set of predefined profiles. These do not allow to modify any options and compute matrices using free-flow speed based on historical traffic. See Profiles.
- The matrix calculation can be done for cars or trucks. When in truck mode, the matrix calculation can take into account special parameters, like the weight and height of the truck. See Truck Parameters.
- Traffic information can be taken into account during the matrix calculation when a region is specified. Depending on departure time, either live traffic or historical traffic patterns are used. See Traffic.