API për planifikimin e rrugës Online
Një plan derë më derë për një udhëtim kufitar: itinerari, pikat kufitare në të me radhën e drejtpërdrejtë ose një parashikim për orën e mbërritjes suaj dhe ndalesat për pushim, ushqim e karburant që shoferi i bën vërtet — në një vijë të vetme kohore. Një radhë e gjatë llogaritet si pushimi që tashmë duhej bërë, kështu që pritja nuk numërohet kurrë dy herë; autobusët dhe kamionët kanë pushimin e detyrueshëm sipas BE 561/2006, ndërsa ndalesat e shërbimit të autobusëve janë kalibruar mbi më shumë se 1000 orare të licencuara. Çdo pikëkalim kufitar raporton edhe wait_basis: vehicle_lane kur kategoria e automjetit tuaj ka radhën e vet të matur, car_lane kur radha e korsisë së veturave është sinjali më i mirë i disponueshëm.
GET https://nakordoni.eu/api/v2/data/route-plan
— klasa e kuotës: heavy
| Parametri | Përshkrimi |
|---|---|
origin_lat | Gjerësia gjeografike e pikënisjes (e detyrueshme) |
origin_lon | Gjatësia gjeografike e pikënisjes (e detyrueshme) |
dest_lat | Gjerësia gjeografike e destinacionit (e detyrueshme) |
dest_lon | Gjatësia gjeografike e destinacionit (e detyrueshme) |
vehicle | car (parazgjedhje), bus ose truck — përcakton si profilin e llogaritjes së itinerarit, ashtu edhe modelin e ndalesave |
depart | Ora e nisjes në formatin ISO-8601, deri në 14 ditë përpara (parazgjedhje: tani). Mbi të bazohet parashikimi i radhës për orën e mbërritjes |
via | Pika të ndërmjetme opsionale në formatin lat,lon;lat,lon (maksimumi 3) — p.sh. për ta kaluar itinerarin nga një pikë tjetër kufitare |
forecast | 1 (parazgjedhje) = parashiko radhën për orën tënde të mbërritjes në secilën pikë kufitare; 0 = përdor radhën aktuale |
stop_places | 1 = trego për çdo ndalesë një zonë pushimi / pikë karburanti konkrete (parazgjedhje 0) |
overnight | 1 = shto një ndalesë nate këshilluese kur ngarja kalon 11 orë (parazgjedhje 0) |
geometry | 1 = përfshi gjeometrinë e plotë të itinerarit (parazgjedhje 0) |
alternatives | 1 (parazgjedhje) = përfshi pikat kufitare alternative aty pranë së bashku me radhët e tyre |
preference | recommended (parazgjedhje), fastest ose shortest |
lang | Kodi i gjuhës për emrat e pikave kufitare (parazgjedhje en) |
Fushat e përgjigjes — brenda objektit data të zarfit të përgjigjes. [] shënon një listë, pra data.items[].name është fusha name e çdo elementi. Një fushë është null, mungon ose është listë bosh kur nuk kemi vlerë — kurrë një vendmbajtëse.
| Fusha | Përshkrimi |
|---|---|
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"
Përditësuar