---
metadata:
  - name: generator
    content: Diplodoc Platform v5.39.6
alternate:
  - https://yandex.com/dev/commercial/doc/en/concepts/distance_matrix.md
  - https://yandex.com/dev/commercial/doc/ru/concepts/distance_matrix.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/commercial/doc/en/llms.txt

# Distance Matrix and Retrieving Route Details

![](../_images/hr.png)

[Distance Matrix](https://yandex.ru/dev/distance_matrix/doc/ru/) is an HTTP API for calculating the distance and duration of routes between multiple points. The Distance Matrix calculates all possible combinations for the origin and destination points.

[Retrieving Route Details](https://yandex.ru/dev/maps/router/doc/concepts/about.html) is an HTTP API for building routes between known points. Routes are based on current traffic conditions and possible delays.

## Pricing {#tariffs}

There is no free version for Distance Matrix and Retrieving Route Details. To use the service, you need to purchase a commercial license.

For Distance Matrix and Retrieving Route Details, two types of licenses are available: basic and advanced. The basic license doesn't allow saving or modifying data obtained via the API. The advanced license doesn't have this restriction.

The license price depends on the number of requests to the service.

{% include [jsapi-geocoder-payment-condition](../_includes/concepts/jsapi-geocoder/id-jsapi-geocoder/payment-condition-b3967974250b.md) %}


## Commercial version {#tariffs}

The basic license doesn't allow saving or modifying data obtained via the API. If you need this functionality, purchase the advanced license.

Available pricing plans are listed below:

Table 1. Plans with yearly payment and daily overages

#|
||**Maximum number of requests per day** |**Base cost/Advanced license (data is preserved)**| **Base cost/Basic license** |**Price per 1000 requests over the request limit for the base cost**||
||1000 | 226,200 rubles | 195,000 rubles | 390 rubles||
||10,000 | 678,600 rubles | 585,000 rubles | 195 rubles||
||25,000 | 1,281,800 rubles | 1,105,000 rubles | 163 rubles||
||50,000 | 2,210,000 rubles | 1,820,000 rubles | 163 rubles||
||100,000 | 2,652,000 rubles | 2,184,000 rubles | 163 rubles||
||200,000 | 3,757,000 rubles | 3,094,000 rubles | 117 rubles||
||300,000 | 5,226,000 rubles | 4,329,000 rubles | 117 rubles||
||500,000 | 7,618,000 rubles | 6,305,000 rubles | 117 rubles||
||1,000,000 | 13,481,000 rubles | 11,050,000 rubles | 59 rubles||
||Over 1,000,000 |To calculate costs, send a request to [paid-api-maps@yandex-team.ru](mailto://paid-api-maps@yandex-team.ru?subject=Запрос%20на%20расчёт%20стоимости%20API) and tell us how many requests per day you expect.|To calculate costs, send a request to [paid-api-maps@yandex-team.ru](mailto://paid-api-maps@yandex-team.ru?subject=Запрос%20на%20расчёт%20стоимости%20API) and tell us how many requests per day you expect.|To calculate costs, send a request to [paid-api-maps@yandex-team.ru](mailto://paid-api-maps@yandex-team.ru?subject=Запрос%20на%20расчёт%20стоимости%20API) and tell us how many requests per day you expect.||
|#

Table 2. Plans with monthly payment and daily overages

#|
||**Maximum number of requests per day** | **Base cost/Basic license** | **Price per 1000 requests over the request limit for the base cost**||
||1000 | 20,800 rubles | 390 rubles||
||10,000 | 58,500 rubles | 195 rubles||
|#



{% note info %}

The published terms and conditions are not an offer.

{% endnote %}



## How requests are counted {#count}

For the Distance Matrix API, 1 matrix element counts as 1 request. For example, a 5x5 matrix counts as 25 requests.

For the Retrieving Route Details service, a request to build 1 route counts as 1 request.

To determine the total number of requests, add the number of matrix elements and the number of requests to build a route.

## How to get started with the API {#how-to-start}

To use the commercial version of the API:

1. Purchase a license. [Learn more](https://yandex.com/dev/commercial/doc/en/concepts/how-to-buy.md)
1. Read the [Distance Matrix](https://yandex.ru/dev/distance_matrix/doc/ru/) and [Retrieving Route Details](https://yandex.ru/dev/maps/router/doc/concepts/about.html) documentation.
1. Connect the API.
    

[*over_limit]: The number of requests above the limit is rounded to thousands upward. For example, 400 requests above the limit are rounded to 1000.
     
    If you exceed the limit several times a month, the cost of requests that exceed the limit is calculated for each day, and at the end of the month the amounts are added together.