API планировщика маршрута Online
План поездки от двери до двери: маршрут, пункты пропуска на нём с текущей очередью или прогнозом на время вашего прибытия и остановки на отдых, еду и заправку, которые водитель действительно делает, — на одной шкале времени. Долгая очередь засчитывается как назревший перерыв, поэтому ожидание никогда не учитывается дважды; для автобусов и грузовиков учтён обязательный отдых по ЕС 561/2006, а сервисные остановки автобусов откалиброваны более чем на 1000 лицензированных расписаний. Каждый пункт пропуска также возвращает wait_basis: vehicle_lane, когда для вашего типа транспорта есть отдельная измеряемая очередь, и car_lane, когда лучшим доступным сигналом является очередь легковой полосы.
GET https://nakordoni.eu/api/v2/data/route-plan
— класс квоты: heavy
| Параметр | Описание |
|---|---|
origin_lat | Широта точки отправления (обязательно) |
origin_lon | Долгота точки отправления (обязательно) |
dest_lat | Широта пункта назначения (обязательно) |
dest_lon | Долгота пункта назначения (обязательно) |
vehicle | car (по умолчанию), bus или truck — задаёт и профиль маршрутизации, и модель остановок |
depart | Время выезда в формате ISO-8601, максимум на 14 дней вперёд (по умолчанию: сейчас). На его основе строится прогноз очереди на момент прибытия |
via | Необязательные промежуточные точки в формате lat,lon;lat,lon (максимум 3) — например, чтобы проложить маршрут через другой пункт пропуска |
forecast | 1 (по умолчанию) = прогнозировать очередь на время вашего прибытия к каждому пункту пропуска; 0 = использовать текущую очередь |
stop_places | 1 = указывать для каждой остановки реальную зону отдыха / АЗС (по умолчанию 0) |
overnight | 1 = добавлять рекомендательную остановку на ночь, если поездка превышает 11 ч (по умолчанию 0) |
geometry | 1 = включать полную геометрию маршрута (по умолчанию 0) |
alternatives | 1 (по умолчанию) = включать соседние альтернативные пункты пропуска вместе с их очередями |
preference | recommended (по умолчанию), fastest или shortest |
lang | Код языка для названий пунктов пропуска (по умолчанию en) |
Поля ответа — внутри объекта data в конверте ответа. [] обозначает список, поэтому data.items[].name — это поле name каждого элемента. Поле бывает null, отсутствует или пустой список, если значения у нас нет, — заглушки мы не подставляем.
| Поле | Описание |
|---|---|
data.route | The drive itself: distance_km, drive_seconds, vehicle, toll_distance_km. |
data.borders[].ppid | A crossing on the route, with name, from, to and crossing_type. |
data.borders[].wait | Its live or arrival-time-forecast wait, with wait_basis — vehicle_lane when your vehicle class has its own measured queue, car_lane when the car queue is the best available signal. |
data.borders[].at_km | Where it falls on the route, with at_drive_seconds and distance_from_route_km. |
data.borders[].alternatives[] | Other crossings worth switching to: ppid, name, wait_minutes, queue_cars, detour_km. |
data.stops[].type | Break, meal or refuelling, with reason, at_km, at_drive_s, minutes, starts_at and ends_at. |
data.summary | The timeline totals: drive_seconds, stop_seconds, border_wait_seconds, total_seconds, arrival_at, stop_count, border_count and borders_absorbed_breaks — long waits that satisfied a due break instead of adding to it. |
data.model | Rules the plan was built on: vehicle, basis (driving-hygiene or EU 561/2006), break_after_drive_min, meal_after_drive_min, fuel_every_km. |
data.warnings[] | Things to tell the driver: code, ppid, name, status, message, suggested_alternative — e.g. a closed crossing on the route. |
curl "https://nakordoni.eu/api/v2/data/route-plan?origin_lat=50.4501&origin_lon=30.5234&dest_lat=52.2297&dest_lon=21.0122&vehicle=car&stop_places=1&lang=en" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
Обновлено