Маршрутты жоспарлау 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"
Жаңартылды