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