Формат ответа

Ответ содержит массив объектов 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

Длина маршрута в метрах.

Сообщения об ошибкахСообщения об ошибках

Если при обработке запроса происходит ошибка, 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"]}