Nachrichteneinreichung und NakBus-Flotte sind jetzt im Partner-Dashboard
Verknüpfen Sie Ihr Entwicklerkonto mit einem Nakordoni-Partners-Konto mit derselben E-Mail-Adresse und verwalten Sie dort Nachrichten sowie Ihre Busflotte (NakDriver / NakManager) mit Teamrollen. Ihre API-Schlüssel, Endpunkte und Apps bleiben unverändert, und die Seiten hier funktionieren weiterhin. Nakordoni Partners öffnen

← Alle Endpunkte

Routenplaner-API Online

Ein Tür-zu-Tür-Plan für die Grenzfahrt: die Route, die Grenzübergänge darauf mit aktueller Warteschlange oder einer Prognose für Ihre Ankunftszeit und die Pausen für Rast, Essen und Tanken, die ein Fahrer wirklich einlegt – alles auf einer Zeitachse. Eine lange Warteschlange gilt als die ohnehin fällige Pause, sodass Wartezeit nie doppelt zählt; für Busse und Lkw gilt die vorgeschriebene Ruhezeit nach EU 561/2006, und die Servicehalte von Bussen sind an über 1000 lizenzierten Fahrplänen kalibriert. Jeder Grenzübergang meldet zusätzlich wait_basis: vehicle_lane, wenn Ihre Fahrzeugklasse eine eigene gemessene Warteschlange hat, car_lane, wenn die Pkw-Spur das beste verfügbare Signal ist.

GET https://nakordoni.eu/api/v2/data/route-plan — Kontingentklasse: heavy

ParameterBeschreibung
origin_latBreitengrad des Startpunkts (erforderlich)
origin_lonLängengrad des Startpunkts (erforderlich)
dest_latBreitengrad des Ziels (erforderlich)
dest_lonLängengrad des Ziels (erforderlich)
vehiclecar (Standard), bus oder truck — bestimmt sowohl das Routing-Profil als auch das Pausenmodell
departAbfahrtszeit im ISO-8601-Format, höchstens 14 Tage im Voraus (Standard: jetzt). Darauf beruht die Warteschlangenprognose für die Ankunftszeit
viaOptionale Zwischenpunkte als lat,lon;lat,lon (max. 3) — z. B. um die Route über einen anderen Grenzübergang zu führen
forecast1 (Standard) = die Warteschlange für Ihre Ankunftszeit an jedem Grenzübergang prognostizieren; 0 = die aktuelle Warteschlange verwenden
stop_places1 = für jede Pause einen konkreten Rastplatz / eine Tankstelle nennen (Standard 0)
overnight1 = einen empfohlenen Übernachtungsstopp hinzufügen, wenn die Fahrt 11 Std. überschreitet (Standard 0)
geometry1 = die vollständige Routengeometrie einschließen (Standard 0)
alternatives1 (Standard) = nahe gelegene alternative Grenzübergänge samt ihren Warteschlangen einschließen
preferencerecommended (Standard), fastest oder shortest
langSprachcode für die Namen der Grenzübergänge (Standard en)

Antwortfelder — innerhalb des data-Objekts im Antwortumschlag. [] steht für eine Liste, data.items[].name ist also das Feld name jedes Elements. Ein Feld ist null, fehlt oder ist eine leere Liste, wenn wir keinen Wert dafür haben — nie ein Platzhalter.

FeldBeschreibung
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"
🔑 Melden Sie sich als Entwickler an, um diesen Endpunkt live in der Sandbox auszuprobieren — 50 kostenlose Testaufrufe pro Tag. Anmelden

Aktualisiert