Die tatsächliche Mautrechnung des Lkw, europaweit

Die schnellste Route und die günstigste Route sind selten dieselbe Linie auf der Karte. In Europa liegt der Unterschied meist in der Maut — und sie kommt in zwei Ausprägungen, die eine Pkw-Schätzung in entgegengesetzte Richtungen falsch einschätzt: Streckenmaut auf den französischen autoroutes und italienischen autostrade sowie zeitbasierte Vignetten- oder Go-Box-Gebühren in der DACH-Region und Mitteleuropa. Für einen 5-achsigen, 40-Tonnen-Lkw sieht keine davon nach dem Tarif eines Pkw aus.

Der Routing-Endpunkt von NAPSPAN liefert die Mautkosten, berechnet für den Lkw, den Sie tatsächlich bewegen. Aktivieren Sie es bei einer Routenanfrage, und Sie erhalten zwei Dinge zurück: eine Summe je Währung für die gesamte Fahrt sowie eine Aufschlüsselung pro Abschnitt, die jedes Mautsystem benennt und den für Ihre Fahrzeugklasse geltenden Tarif.

Aktivieren mit include

Die Mautbepreisung ist opt-in, denn ihre Berechnung verursacht vorgelagerte Kosten — Sie zahlen nur dann dafür, wenn Sie danach fragen. Fügen Sie "tolls" dem include-Array bei POST /api/v1/routing/route hinzu:

curl -X POST "https://api.napspan.com/api/v1/routing/route" \
  -H "X-API-Key: your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "origin":      { "lat": 48.1351, "lng": 11.5820 },
    "destination": { "lat": 45.4642, "lng": 9.1900 },
    "currency": "EUR",
    "truck": {
      "profile":  "tractor",
      "weight_t": 40.0,
      "height_m": 4.0,
      "axles":    5
    },
    "include": ["tolls"]
  }'

Das ist München→Mailand über den Brenner für eine 5-achsige, 40-Tonnen-Zugmaschine — eine Fahrt, die einen österreichischen Streckenmautabschnitt und das italienische Autostrada-Netz durchquert. Das Feld currency (ISO 4217) steuert, in welcher Währung die Tarife ausgewiesen werden; das truck-Profil, das Sie ohnehin senden, macht aus dem Preis den Preis des Lkw.

Die Antwort

Zwei Stellen tragen Mautdaten. Die Routen-summary erhält ein toll_costs-Array — ein Eintrag je eindeutiger Währung, denn eine einzige Fahrt kann Systeme durchqueren, die in unterschiedlichen Währungen abgerechnet werden (eine Route durch die Schweiz mischt EUR und CHF). Jeder Routen-section erhält ein tolls-Array, das die auf diesem Abschnitt berechneten Systeme und die darin geltenden Tarife benennt.

{
  "routes": [
    {
      "summary": {
        "distance_m": 492000,
        "duration_s": 21600,
        "toll_costs": [
          { "currency": "EUR", "value": 96.40 }
        ]
      },
      "sections": [
        {
          "distance_m": 184000,
          "duration_s": 8100,
          "summary": "A13 Brenner Autobahn (AT)",
          "tolls": [
            {
              "system": "ASFINAG / Brenner",
              "fares": [
                { "name": "Category 4+ (4+ axles)",
                  "price": { "currency": "EUR", "value": 49.10 } }
              ]
            }
          ]
        },
        {
          "distance_m": 308000,
          "duration_s": 13500,
          "summary": "A22 / A1 autostrada (IT)",
          "tolls": [
            {
              "system": "Autostrade per l'Italia",
              "fares": [
                { "name": "Class 5",
                  "price": { "currency": "EUR", "value": 47.30 } }
              ]
            }
          ]
        }
      ],
      "geometry": { "type": "LineString", "coordinates": [ /* ... */ ] }
    }
  ],
  "route_id": "rt_9c40f2ab"
}

Der Wert summary.toll_costs ist die Summe der Abschnittstarife dieser Währung — die Zahl, die Sie einem Kunden nennen oder in ein Korridor-Kostenmodell übernehmen würden. Das Detail sections[].tolls[] zeigt, welcher Betreiber was berechnet, sodass Sie die Rechnung erklären oder mit einer mautfreien Alternative vergleichen können.

Für das Fahrzeug bepreist, nicht für einen Pkw

Das ist der ganze Sinn. Der zurückgelieferte Tarif richtet sich nach dem truck-Profil der Anfrage — Achszahl, Gesamtgewicht, Höhe und das Gefahrgut-Flag fließen alle in die Mautkategorie ein, gegen die die Engine bepreist. Eine 5-achsige Kombination bekommt nicht den Tarif eines Pkw; eine schwere Ladung bekommt nicht den Tarif eines leichten Fahrzeugs. Der fares[].name spiegelt die angewandte Kategorie wider (z. B. „Category 4+“), sodass Sie bestätigen können, dass der Lkw so eingestuft wurde, wie Sie es erwartet haben.

Um die Maut herum routen

Manchmal ist die Antwort, die Mautstraße ganz zu meiden. Das ist ein anderes Feld: Setzen Sie "tolls" in das avoid-Array, und die Engine routet, wo möglich, um Mautanlagen herum, sodass Sie die zusätzliche Zeit und Distanz der mautfreien Option gegen das eingesparte Geld abwägen können.

{ "origin": { /* ... */ }, "destination": { /* ... */ },
  "truck": { /* ... */ },
  "alternatives": 1,
  "avoid": ["tolls"],
  "include": ["tolls"] }

Fordern Sie neben dem Vermeiden eine Alternative an, behalten Sie "tolls" in include, und Sie erhalten beide Routen bepreist — die schnelle, bemautete Linie und den mautfreien Umweg —, um den Kompromiss explizit zu machen statt zu raten.

Was Sie von den Daten erwarten können

Ein paar ehrliche Hinweise, damit sich die Zahlen so verhalten, wie Sie es erwarten:

• Streckenmaut-Autobahnen werden gut bepreist — französische autoroutes, italienische und spanische autostrade/autopistas, österreichische Streckenmaut und ähnliche Netzbetreiber liefern Lkw-Tarife je Kategorie zuverlässig zurück.
• Vignetten- und Box-Systeme sind zeit- oder registrierungsbasiert. Wo ein Land per Vignette oder On-Board-Unit statt pro Fahrt abrechnet, kann eine Route das System ohne sauberen Pro-Fahrt-Tarif ausweisen — behandeln Sie einen fehlenden price als „hier nicht bepreist“, nicht als „kostenlos“, und berücksichtigen Sie die periodische Vignette separat.
• Es ist eine Planungsschätzung. Die Mautbepreisung wird zur Anfragezeit für die Route und Fahrzeugklasse berechnet; sie ist für Disposition und Angebotskalkulation gebaut, nicht zum centgenauen Abgleich einer Betreiberabrechnung.
• Keine Maut, kein Array. Eine mautfreie Route oder eine Anfrage ohne opt-in lässt toll_costs und das Abschnitts-tolls einfach weg — die Antwortstruktur bleibt stabil.

Ein Aufruf, die ganze Fahrt

Die Mautbepreisung reitet auf demselben POST /api/v1/routing/route mit wie die Korridor-Gefahren-warnings[] und die Pausenplanung nach Lenkzeiten. Eine einzige grenzüberschreitende Anfrage (DE → AT → IT in einer Abfrage) kann eine befahrbare Lkw-Route, die Sperrungen und Beschränkungen darauf, die Stellen, an denen der Fahrer gesetzlich anhalten muss, sowie die Mautkosten der Fahrt zurückgeben — das betriebliche Gesamtbild, das ein Disponent tatsächlich braucht, bevor der Lkw losrollt. Routing ist eine Funktion der kostenpflichtigen Pläne mit einer kostenlosen 14-tägigen Testphase.

Ausprobieren

• API-Dokumentation — vollständige Request- und Response-Referenz für POST /api/v1/routing/route
• Live-Karte — die zugrunde liegenden Daten über die europäischen NAPs erkunden
• Kostenloser API-Schlüssel — keine Karte, 14-tägige Testphase