Навигация | Truck Direction API | Обзор | 2GIS Documentation

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"
    }
]

  1. Получите ключ доступа к API. Для этого заполните анкету.
  2. Посмотрите все параметры форматов запроса и ответа.