მარშრუტის დაგეგმვის 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"
განახლდა