Формат ответа
Ответ содержит массив объектов rows
. Каждый объект elements
в массиве содержит характеристики одного маршрута.
https://api.routing.yandex.net/v2/distancematrix?origins=25.249269,55.350952|25.248066,55.351206&destinations=25.225335,55.254270&mode=transit&apikey=YOUR_API_KEY
В этом случае ответ будет выглядеть следующим образом:
Ответ
{
"rows": [
{
"elements": [
{
"status": "OK",
"distance": {
"value": 1268
},
"duration": {
"value": 4233
}
}
]
},
{
"elements": [
{
"status": "OK",
"distance": {
"value": 1407
},
"duration": {
"value": 4333
}
}
]
}
]
}
Параметры ответа
rows
-
Массив маршрутов между точками. Объекты в массиве упорядочены в соответствии с порядком элементов в параметре
origins
. elements
-
Элемент, содержащий информацию о маршруте. Объекты в массиве упорядочены в соответствии с порядком элементов в параметре
destinations
.duration
-
Элемент, содержащий информацию о продолжительности маршрута.
value
- Продолжительность маршрута в секундах.
status
-
Статус расчета маршрута. Возможные значения:
OK
— маршрут рассчитан успешно;FAIL
— при расчете маршрута возникла проблема. Например, не удалось найти дорогу рядом с указанной точкой.
distance
-
Элемент, содержащий информацию о длине маршрута.
value
- Длина маршрута в метрах.
Сообщения об ошибках
Code | Description |
---|---|
400 | Запрос не содержит одного или нескольких обязательных параметров. |
401 | Запрос не содержит параметр apikey или указан неверный ключ. |
429 | Слишком много запросов. |
500 или 504 | Системная ошибка сервера. Повторите запрос с небольшой задержкой. |
Если при обработке запроса происходит ошибка, API возвращает сообщение с описанием ошибки в поле errors
:
{"errors": ["{origins} are empty"]}
{"errors": ["Key not found"]}
{"errors": ["parameter 'apikey' is missing"]}
{"errors": ["Counter total limit exceeded. Limit: XXX, current value: YYY"]}