API рассчитывает матрицу расстояний для массива точек, которую разработчики логистических алгоритмов могут использовать для своих вычислений. Функция возвращает только минимальное время между заданными точками, для получения детальной информации по маршруту между этими точками, воспользуйтесь API построения маршрутов. Расчет может производиться для маршрутов на автомобиле, пешком и на общественном транспорте. Доступные виды общественного транспорта можно устанавливать в параметрах расчета
Поскольку для больших матриц время расчета может быть достаточно большим и превышать предельное время ожидания сервера, то непосредственно на запрос выдается ответ только для ограниченного размера матрицы, а большие матрицы ставятся в очередь запросов, результат из которой можно получить отдельным запросом.
Адрес скрипта: mosmap.ru/api/api_matrix.php
Параметры запроса:
apikey – ключ пользователя. Обязательный параметр.
mode - Способ перемещения по маршруту. Допускаются значения walking для пеших маршрутов, transit для общественного транспорта или driving для расчета проезда на автомобиле. Значение walking является частным случаем значения transit, при выключении всех видов общественного транспорта из расчета с помощью дополнительных параметров. Значение transit используется по умолчанию если параметр не задан.
waypoints= - Начальные точки маршрута. Обязательный параметр.
metro – Использование в расчете метро, МЦК и МЦД. По умолчанию включено.
trains – Использовать в расчете электрички. По умолчанию включено.
groundtransport – использовать наземный транспорт, кроме ночных автобусов. По умолчанию включен.
nightbus - использовать ночные автобусы, по умолчанию выключено.
optimize – оптимизировать порядок точек.
returntostart – Возврат в первую точку
Если кроме координат не указаны никакие параметры, производится расчет пешего маршрута с использованием всего дневного общественного транспорта. Для расчета только пешего маршрута необходимо выключить все виды городского транспорта.
Параметры ответа.
Возвращается матрица времен по маршрутам между точками. В диагонали матрицы возвращается значение -1.
Rows- Массив времен по маршрутам между точками. Строки в массиве упорядочены в соответствии с порядком элементов в параметре waypoints, столбцы также упорядочены в соответствии с порядком элементов.
Пример запроса:
mosmap.ru/api/api_matrix.php?apikey=4efdb87d-e940-4b19-9751-757c154ace9b&waypoints=55.734490,37.68191|55.73344,37.59027|55.63344,37.690&mode=driving
Пример ответа:
{
"mode": "driving",
"rows": [
{
"0": {
"status": "FAIL",
"duration": -1
},
"1": {
"status": "OK",
"duration": 713
},
"2": {
"status": "OK",
"duration": 1192
},
"latitude": "55.734490",
"longtude": "37.68191"
},
{
"0": {
"status": "OK",
"duration": 669
},
"1": {
"status": "FAIL",
"duration": -1
},
"2": {
"status": "OK",
"duration": 1251
},
"latitude": "55.73344",
"longtude": "37.59027"
},
{
"0": {
"status": "OK",
"duration": 1336
},
"1": {
"status": "OK",
"duration": 1305
},
"2": {
"status": "FAIL",
"duration": -1
},
"latitude": "55.63344",
"longtude": "37.690"
}
]
}