Mautgebühren berechnen

Entwickler im Europäischen Wirtschaftsraum (EWR)

Wenn Sie eine Route oder eine Routenmatrix berechnen, sollten Sie alle Mautgebühren auf der Route berücksichtigen. Für ausgewählte Städte können Sie die geschätzte Mautgebühr für eine Route in der entsprechenden Währung berechnen.

Eine Liste der unterstützten Mautstellen finden Sie in der Referenz für TollPass.

So werden Mautgebühren berechnet

Die Routes API berechnet die geschätzte Mautgebühr unter Berücksichtigung von Mautpreisrabatten oder Pässen, die dem Fahrer oder Fahrzeug zur Verfügung stehen, sowie der bequemsten Zahlungsmethoden. Wenn für eine bestimmte Route kein Mautpreis verfügbar ist, gibt die Routes API an, dass eine Maut mit unbekannter Gebühr vorhanden ist.

Damit Sie genaue Mautschätzungen erhalten, müssen Sie in Ihrer Anfrage die folgenden Informationen angeben:

  • Der Emissionstyp des für die Route verwendeten Fahrzeugs (VehicleEmissionType). Wenn kein Emissionstyp angegeben wird, wird die Maut für ein benzinbetriebenes Fahrzeug zurückgegeben.
  • Alle Mautkarten, die das Fahrzeug und der Fahrer haben, mit tollPasses. Die API verwendet die Mautkarten, um genaue Mautgebühren zu ermitteln, und gibt Barpreise zurück, wenn die Mautkarten in der Anfrage nicht für die Route gelten.
  • Bei Bedarf „Mautstraßen vermeiden“ angeben Wenn Sie Mautstraßen nach Möglichkeit vermeiden möchten, fügen Sie avoidTolls als RouteModifier hinzu.

Maut mit einer Mautkarte berechnen

Wenn Sie Mautgebühren mit einer Mautkarte berechnen möchten, geben Sie alle Mautkarten als Teil der Anfrage an. Die API gibt dann die Preise für Karten zurück.

  • Wenn Sie einen ungültigen Mautpass angeben, wird der Pass ignoriert.
  • Wenn Sie mehrere Mautkarten als Array angeben, versucht die API, den Preis für die Route für jede Karte zu berechnen.

Die Funktionsweise von Mautkarten kann je nach Region variieren.

  • Niedrigere Gebühren mit einer Mautkarte: In einigen Regionen zahlen Fahrer oder Fahrzeuge mit einer Mautkarte eine andere Maut als Fahrer oder Fahrzeuge ohne Mautkarte. Wenn Sie beispielsweise eine Good To Go!-E-Mail erhalten haben, Wenn Sie einen Mautpass in Seattle, WA, USA, haben, zahlen Sie eine niedrigere Mautgebühr als ohne Pass.
  • Für einige Straßen ist möglicherweise eine Mautkarte erforderlich: In einigen Regionen, z. B. in Indonesien, gibt es Straßen, für die eine Mautkarte erforderlich ist. Wenn Sie für eine Route, für die ein Mautpass erforderlich ist, keinen Mautpass angeben, gibt die API keinen Mautpreis zurück.

Mautgebühren für eine Route berechnen

So berechnen Sie die Mautgebühren für eine Route:

  • Setzen Sie das Attribut extraComputations auf TOLLS.
  • Geben Sie den Fahrzeugtyp und den Mautpass-Typ mit der Property routeModifiers an.
  • Wenn Sie Mautgebühren für eine gesamte Route berechnen möchten, fordern Sie travelAdvisory im Attribut fields der Anfrage an. Die Mautinformationen für die gesamte Route können Sie mit route.travelAdvisory.tollInfo abrufen.
  • Wenn Sie Mautgebühren für einzelne Abschnitte einer Route berechnen möchten, fordern Sie legs in der fields-Property der Anfrage an. Die Mautinformationen für die einzelnen Abschnitte finden Sie in route.legs[i].travelAdvisory.tollInfo.

Beispiel

Im folgenden Beispiel wird gezeigt, wie Mautgebühren für eine Route angefordert werden:

const requestWithTolls = {
  origin: 'Kirkland, WA',
  destination: 'University of Washington',
  travelMode: 'DRIVING',
  extraComputations: ['TOLLS'],
  routeModifiers: {
    vehicleInfo: {
      emissionType: 'GASOLINE',
    },
    tollPasses: ['US_WA_GOOD_TO_GO'],
  },
  fields: ['path', 'legs', 'distanceMeters', 'durationMillis', 'travelAdvisory'],
};