Передача данных в Яндекс Навигатор

Некоторые дороги имеют ограничения: например, по весу или габаритам автомобилей. Чтобы навигатор построил маршрут с учетом этих ограничений, нужно передать ему параметры автомобиля. Для этого можно использовать пользовательские поля route_custom_fields.

Это актуально для легковых автомобилей, легких грузовиков и автомобилей, у которых фактический вес груза существенно уменьшается по мере выполнения заказов.

Важно

Для подключения опции обратитесь в службу поддержки. Работать с пользовательскими полями можно только через API.

Значения пользовательских полей задаются в сторонней системе и через API передаются в Мониторинг. После этого курьер при переходе из приложения в Яндекс Навигатор будет видеть маршрут, построенный с учетом заданных параметров.

Параметры учитываются, если способ передвижения routing_mode равен driving или truck.

Пользовательские поля route_custom_fields:

  • app_navi_truck_vehicle_type — тип автомобиля:
    • default — легковой;
    • truck — грузовик.
  • app_navi_truck_height — высота автомобиля, м;
  • app_navi_truck_width — ширина автомобиля, м;
  • app_navi_truck_length — длина автомобиля, м;
  • app_navi_truck_weight — фактический вес автомобиля, т;
  • app_navi_truck_weight_kg_empty — вес автомобиля без груза, кг;
  • app_navi_truck_max_weight — максимальный вес автомобиля, т;
  • app_navi_truck_axle_weight — нагрузка на ось, т;
  • app_navi_truck_payload — вес груза, т;
  • app_navi_truck_has_trailer — наличие прицепа:
    • 1 — с прицепом;
    • 0 — без прицепа.
  • app_navi_truck_eco_class — экологический класс автомобиля (значение от 1 до 6).

Возможные значения полей в зависимости от типа автомобиля — легкового автомобиля или грузовика:

Поле

Легковой автомобиль

Грузовик

app_navi_truck_height

0,3–10 м

1,3–10 м

app_navi_truck_width

0–15 м

1,7–15 м

app_navi_truck_length

0–20 м

4,3–20 м

app_navi_truck_weight

0–80 т

1,5–80 т

app_navi_truck_max_weight

0–34 т

2–80 т

app_navi_truck_axle_weight

0–18 т

1,5–20 т

app_navi_truck_payload

0–34 т

1–65 т

Фактический вес автомобиля app_navi_truck_weight для Яндекс Навигатора рассчитывается динамически в процессе прохождения маршрута по формуле:

app_navi_truck_weight = Сeil {(app_navi_truck_weight_kg_empty + sum_weight) / 1000}

где sum_weight — суммарный вес всех заказов (в килограммах), которые в данный момент загружены в автомобиль.

Написать в службу поддержки