Limits are set for the key: the maximum number of requests per minute, per day. To build one route, you can specify up to 100 points. 

TSP API, DistanceMatrixAPI, IsochronesAP services are currently available only for the Russian Federation.

To create a task to build a matrix of route segments (distances), you need to send a POST request / cal-culateDistanceMatrix.

Waypoint coordinates and other parameters are sent as JSON in the body of the request.

Parameter	Description	Required/ Optional	Data type	Data Format
points	Array of coordinates of points	required	array [сoordinates]
sources	An array of indexes showing which points from the points array are the starting points	required	array [integer]	int64
targets	An array of indexes showing which points from the points array are the end (finish) points	required	array [integer]	int64
start_time	Departure time. If not specified, the current time will be used	optional	string example: 2025-02-28T15:30:00Z	date-time
vehicle_type	Type of vehicle. Possible options: car,  truck, heavy_truck,  van, bicycle, pedestrian	optional	string enum:  [car, truck, heavy_truck, van, bicycle, pedestrian]
mz_pass	Drivers of freight vehicles must have passes to the Moscow Ring Road (MKAD), Third Transport Ring (TTK), and Garden Ring (GR) zones	optional	object {MzPass} – see Data types below
jams	To take into account or not when planning a route information about current traffic jams. Default value: false	optional	boolean
optimization	Type of route optimization: by time – fastest;  by distance – shortest. Default value: fastest	optional	string enum:   [fastest, shortest]

Response Code	Parameter	Data type	Description
200	routes	object {DMRoute} – please refer to Data types for DistanceMatrix API	The route built between the specified points
200	calculation_time_ms	integer (int64)	Estimated time, in milliseconds
200	road_lookup_time_ms	integer (int64)	Time to search for the road closest to the route points, in milliseconds
200	matrix_build_time_ms	integer (int64)	The time to build the route matrix, in milliseconds
400	code	string enum: [bad_points, no_route, too_many_points, invalid_time]	Invalid request. Possible code options: • bad_points – points are outside the map; • no_route – the route cannot be built; • too_many_points – the number of points exceeds the allowed value; • invalid_time – incorrect departure time
400	message	string	Invalid request. Possible code options: • bad_points – points are outside the map; • no_route – the route cannot be built; • too_many_points – the number of points exceeds the allowed value; • invalid_time – incorrect departure time
401			The API key is missing or invalid
403			API key has expired and search limits have been exceeded
500			Internal server error

https://navitel.ru/ru/map_api/distance_matrix#12

Coordinates – point coordinates

Parameter	Description	Required/ Optional	Data type	Data Format
longitude	Longitude	required	number	double
latitude	Latitude	required	number	double

DMRoute — matrix of route distances

Parameter	Description	Required/ Optional	Data type	Data Format
source_pt	Index of the initial (starting) point (from an array of points)	optional	object {PointIndex} – see Data types for DistanceMatrix API	int64
target_pt	Index of the final (finish) point (from an array of points)	optional	object {PointIndex} – see Data types for DistanceMatrix API	int64
source_road_pt	The point of the road closest to the starting point	optional	object {Сoordinates}
target_road_pt	The point of the road closest to the final (finish) point	optional	object {Сoordinates}
distance_m	Route length, in meters	optional	integer	int32
duration_sec	Estimated travel time, in seconds	optional	integer	int32
restrictions	Restrictions used in constructing the route distance matrix	optional	array [DMRouteRestriction]
status	Status of the route distance matrix construction	optional	object {DMRouteStatus}

PointIndex — the index of a point from an array of points

Parameter	Description	Required/ Optional	Data type	Data Format
point	Route point from an array of points	optional	object {Сoordinates}	int32
index	Index of a waypoint from an array of points	optional	integer	int32

DMRouteRestriction – restrictions used in constructing the route distance matrix

Parameter	Description	Required/ Optional	Data type	Data Format
	Restrictions used when building route distances. Possible options: • toll_road; • ferry; • dirt_road; • highways	optional	string enum: [toll_road, ferry, dirt_road, highways]

DMRouteStatus — status of the route distance matrix construction

Parameter	Description	Required/ Optional	Data type	Data Format
code	Code. Possible code options: • route_ok – the route was successfully laid/built; • route_not_exist — these points are not connected by the road network; • route_fail — an unknown error occurred when calculating the route; • lookup_fail — one of the points is more than 10 km from the road network	optional	string enum: [route_ok, route_not_exist, route_fail, lookup_fail]
message	Message	optional	string

MzPass – availability of a pass to the MKAD, TTK, SK zones

Parameter	Description	Required/ Optional	Data type	Data  format
mkad	Availability of a pass to the Moscow Ring Road (MKAD) zone. Default value: false	optional	boolean
ttk	Availability of a pass to the Third Transport Ring (TTK) zone. Default value: false	optional	boolean
sk	Availability of a pass to the Garden Ring (GR) zone. Default value: false	optional	boolean

Request

Response body