La soumission d'actualités et la flotte NakBus sont désormais dans le tableau de bord partenaire
Connectez votre compte développeur à un compte Nakordoni Partners avec la même adresse e-mail et gérez-y les actualités et votre flotte de bus (NakDriver / NakManager), avec des rôles d'équipe. Vos clés API, points de terminaison et applications restent inchangés, et les pages ici continuent de fonctionner. Ouvrir Nakordoni Partners

← Tous les endpoints

API de planification d'itinéraire Online

Un plan porte-à-porte pour un trajet transfrontalier : l'itinéraire, les points de passage qui s'y trouvent avec la file en direct ou une prévision pour votre heure d'arrivée, et les arrêts repos, repas et carburant qu'un conducteur fait réellement — sur une seule chronologie. Une longue file compte comme la pause déjà due, donc l'attente n'est jamais comptée deux fois ; les autocars et poids lourds bénéficient du repos obligatoire UE 561/2006, et les arrêts de service des autocars sont calibrés sur plus de 1000 horaires licenciés. Chaque passage frontalier indique aussi wait_basis : vehicle_lane lorsque votre catégorie de véhicule dispose de sa propre file mesurée, car_lane lorsque la file de la voie voitures est le meilleur signal disponible.

GET https://nakordoni.eu/api/v2/data/route-plan — classe de quota: heavy

ParamètreDescription
origin_latLatitude du point de départ (obligatoire)
origin_lonLongitude du point de départ (obligatoire)
dest_latLatitude de la destination (obligatoire)
dest_lonLongitude de la destination (obligatoire)
vehiclecar (par défaut), bus ou truck — détermine à la fois le profil de calcul d'itinéraire et le modèle de pauses
departHeure de départ au format ISO-8601, jusqu'à 14 jours à l'avance (par défaut : maintenant). Elle sert de base à la prévision de la file d'attente à l'heure d'arrivée
viaPoints intermédiaires facultatifs au format lat,lon;lat,lon (3 au maximum) — par exemple pour faire passer l'itinéraire par un autre poste-frontière
forecast1 (par défaut) = prévoir la file d'attente pour votre heure d'arrivée à chaque poste-frontière ; 0 = utiliser la file actuelle
stop_places1 = indiquer une aire de repos / station-service réelle pour chaque arrêt (0 par défaut)
overnight1 = ajouter un arrêt nuit à titre indicatif lorsque la conduite dépasse 11 h (0 par défaut)
geometry1 = inclure la géométrie complète de l'itinéraire (0 par défaut)
alternatives1 (par défaut) = inclure les postes-frontières alternatifs proches avec leurs files d'attente
preferencerecommended (par défaut), fastest ou shortest
langCode de langue pour les noms des postes-frontières (en par défaut)

Champs de la réponse — à l’intérieur de l’objet data de l’enveloppe. [] indique une liste : data.items[].name est donc le champ name de chaque élément. Un champ vaut null, est absent ou est une liste vide quand nous n’avons pas de valeur — jamais un espace réservé.

ChampDescription
data.routeThe drive itself: distance_km, drive_seconds, vehicle, toll_distance_km.
data.borders[].ppidA crossing on the route, with name, from, to and crossing_type.
data.borders[].waitIts 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_kmWhere 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[].typeBreak, meal or refuelling, with reason, at_km, at_drive_s, minutes, starts_at and ends_at.
data.summaryThe 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.modelRules 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"
🔑 Connectez-vous en tant que développeur pour essayer cet endpoint en direct dans la sandbox — 50 appels de test gratuits par jour. Connexion

Mis à jour