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"