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"
Оновлено