Skip to main content

Overview

Distance Matrix API allows you to get information about travel time and distance between points on the map.

You can specify multiple starting and ending points and get distance and travel time between each possible pair of starting and ending points. For example, for three starting points (A, B, C) and three ending points (D, E, F), Distance Matrix API calculates a matrix with distance and travel time of nine route options: AD, AE, AF, BD, BE, BF, CD, CE, and CF.

Distance Matrix API supports two modes of operation:

  • Synchronous mode for calculating requests that contain up to 25 starting or ending points. In this mode, the request returns the result of calculation.
  • Asynchronous mode for calculating requests that contain more than 25 starting or ending points. In this mode, the request returns the task ID, which should be used to periodically check if the calculation is complete. If you need to use this mode, write an email to info@urbi.ae.

Thus, you can use Distance Matrix API to determine the most effective routes of traveling between multiple staring and ending points and implement your own algorithms for solving routing problems. See usage scenarios in the Examples section.

Distance Matrix API returns only brief information about the route (distance and travel time). To get the full geometry of a route, use Routing API.

Move your mouse over a marker on the map to find out the distance and driving time to it.

Tariffs​

  • When you send requests to the Distance Matrix API, calculations for each pair of starting and ending points are charged, not the number of requests. For example, in one request, you specify 2 starting points and 3 ending points, so that 6 calculations are charged.
  • To find out the current prices for services, contact the manager.