Truck Directions API
Truck Directions API позволяет построить маршрут для грузового транспорта, не включая улицы с действующими ограничениями для грузового транспорта.
Truck Directions API при построении маршрута для грузового транспорта учитывает:
- габариты и массу автомобиля;
- максимально разрешённую массу на маршруте;
- ограничения на движение с опасными и взрывчатыми грузами;
- ограничения знаками 3.4 «Движение грузовых автомобилей запрещено» и 3.2 «Движение запрещено» в сочетании с табличками 8.4.1 «Вид транспортного средства», 8.11 «Ограничение разрешённой максимальной массы» (2,5 тонны ) и 8.3.1–8.3.2 «Направление действия».
- пробки в реальном времени или статистику пробок;
- грунтовые и платные дороги и предлагает маршрут в объезд таких дорог, если пользователь выбрал такую настройку.
Список регионов, в которых можно строить маршруты для грузового транспорта, постепенно дополняется новыми городами.
Как это работает
Запросы осуществляются методом POST, все необходимые параметры передаются в формате JSON. Ответы формируются в формате JSON.
В запросе передаются координаты точек маршрута. В ответ приходят длина маршрута и время в пути. Все параметры запроса и ответа приведены в описании API.
Пример запроса
На видео представлен пример построения маршрута для грузового транспорта с учётом ограничений на габариты автомобиля.
На видео представлен пример построения маршрута для грузового автомобиля в объезд улиц, по которым запрещено движение грузового транспорта.
Данные для примеров с видео можно получить с помощью POST-запроса на URL https://catalog.api.2gis.com/truck/6.0.0/global?key=YOUR_KEY
и payload'а с Content-Type application/json.
В запросе используются следующие параметры:
key=YOUR_KEY
— ваш ключ API.
{
"locale": "ru",
"point_a_name": "Source",
"point_b_name": "Target",
"points": [
{
"type": "pedo",
"x": 37.604503,
"y": 55.763114
},
{
"object_id": "4504235282733728",
"type": "pedo",
"x": 37.607681,
"y": 55.766273
}
],
"type": "truck_jam"
}
Пример ответа
[
{
"query": {
"locale": "ru",
"point_a_name": "Source",
"point_b_name": "Target",
"points": [],
"type": "truck_jam"
},
"result": [
{
"algorithm": "с учётом пробок",
"begin_pedestrian_path": {
"geometry": {}
},
"end_pedestrian_path": {
"geometry": {}
},
"requested_filters": "full",
"filter_road_types": [],
"id": "1805336109018823561",
"maneuvers": [],
"route_id": "em9.n3/carrouting/1588235082.031",
"total_distance": 15153,
"total_duration": 2204,
"type": "carrouting",
"ui_total_distance": {
"unit": "км",
"value": "15"
},
"ui_total_duration": "36 мин",
"waypoints": [
{
"original_point": {
"lat": 54.94365877886301,
"lon": 82.93066878237848
},
"projected_point": {
"lat": 54.94365877886301,
"lon": 82.93066878237848
},
"transit": false
},
{
"original_point": {
"lat": 55.03387872014941,
"lon": 82.9446599530971
},
"projected_point": {
"lat": 55.03387872014941,
"lon": 82.9446599530971
},
"transit": false
}
]
}
],
"type": "string"
}
]
Начало работы
- Получите ключ доступа к API. Для этого заполните анкету.
- Посмотрите все параметры форматов запроса и ответа.