Mautgebühren für eine Route berechnen

Wenn Sie eine Route oder eine Routenmatrix berechnen, sollten Sie alle Mautgebühren 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.

Informationen zum Abrufen von Mautgebühren für eine Routenmatrix finden Sie unter Mautgebühren für eine Routenmatrix berechnen.

Eine Liste der unterstützten Mautstellen findest du in der Referenz zum TollPass.

So werden Mautgebühren berechnet

Die Routes API berechnet die geschätzte Mautgebühr. Dabei werden alle Mautgebührenrabatte oder für den Fahrer oder Fahrzeug verfügbaren Pässe sowie die bequemsten Zahlungsmethoden berücksichtigt. Wenn für eine bestimmte Route keine Mautgebühr verfügbar ist, zeigt die Routes API an, dass eine Maut mit einer unbekannten Gebühr vorhanden ist.

Bitte geben Sie in Ihrer Anfrage die folgenden Informationen an, damit Sie genaue Schätzungen erhalten:

  • Die Emissionsart des für die Route genutzten Fahrzeugs (VehicleEmissionType). Wenn keine Emissionsart angegeben ist, wird die Maut für ein Benzinfahrzeug zurückgegeben.
  • Alle Mautkarten, die das Fahrzeug und der Fahrer verwenden (TollPass). Die API ermittelt anhand der Mautpässe die korrekten Mautgebühren und gibt Bargeldpreise zurück, wenn die Mautpässe in der Anfrage nicht lokal für die Route gelten.
  • Geben Sie gegebenenfalls Mautgebühren an. Wenn Sie Mautstraßen nach Möglichkeit vermeiden möchten, fügen Sie avoidTolls als RouteModifier hinzu.

Mautstraßen mit einer Fahrkarte berechnen

Wenn Sie Mautgebühren anhand einer Mautkarte berechnen möchten, geben Sie in der Anfrage alle Mautkarten an. Die API gibt dann die Preise für die Karte bzw. das Ticket zurück.

  • Wenn Sie eine ungültige Mautkarte angeben, wird die Karte bzw. das Ticket ignoriert.

  • Wenn du mehrere Mautpässe als Array angibst, versucht die API, den Preis für die Route für jede Karte bzw. jedes Ticket zu berechnen.

Die Art der Mautkarten kann je nach Region variieren.

  • Die Mautgebühren können mit einer Mautkarte niedriger sein: In einigen Regionen zahlt ein Fahrer oder Fahrzeug mit einer Mautkarte eine andere Maut als Personen ohne Ausweis. Wenn Sie beispielsweise eine Good To Go!-Maut in Seattle, WA, USA haben, zahlen Sie eine geringere Maut als ohne Karte/Ticket.

  • Für einige Straßen ist möglicherweise ein Mautpass erforderlich: In einigen Regionen, wie z. B. Indonesien, gibt es Straßen, für die eine Mautpassgebühr erforderlich ist. Wenn Sie für eine Route, für die eine Mautkarte erforderlich ist, keine Mautkarte angeben, gibt die API keinen Mautpreis zurück.

Mautgebühren für eine Route berechnen

Im folgenden Beispiel wird die Methode computeRoutes verwendet, um Mautinformationen mit einem geschätzten Preis zurückzugeben, wenn eine Mautkarte verwendet wird. In diesem Beispiel führen Sie folgende Schritte aus:

  • Legen Sie das Arrayfeld extraComputations auf TOLLS fest, damit Mautinformationen berechnet werden können.

  • Geben Sie den Fahrzeugtyp und die Art der Mautkarte im Feld routeModifiers der Anfrage an. Der zurückgegebene Mautpreis basiert auf den Preisen des angegebenen Fahrzeugtyps und der Karte bzw. des Tickets. Wenn mehr als eine Karte bzw. ein Ticket angegeben ist, wird der günstigste Preis zurückgegeben.

  • Mit der Antwortfeldmaske können Sie die Methode konfigurieren, mit der in der Antwort Mautinformationen zurückgegeben werden. In diesem Beispiel enthielt die Anfrage die folgenden Attribute in der Antwortfeldmaske:

    • routes.travelAdvisory.tollInfo, um Informationen für die gesamte Route zurückzugeben.

    • routes.legs.travelAdvisory.tollInfo, um Informationen für jeden Abschnitt zurückzugeben.

Anfrage nach Mautinformationen

curl -X POST -d '{
  "origin":{
    "location":{
      "latLng":{
        "latitude":42.340173523716736,
        "longitude":-71.05997968330408
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude":42.075698891472804,
        "longitude": -72.59806562080408
      }
    }
  },
  "travelMode": "DRIVE",
  "extraComputations": ["TOLLS"],
  "routeModifiers":{
    "vehicleInfo":{
      "emissionType": "GASOLINE"
    },
    "tollPasses": [
      "US_MA_EZPASSMA",
      "US_WA_GOOD_TO_GO"
    ]
  }
}' \
-H 'Content-Type: application/json' \
-H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.travelAdvisory.tollInfo,routes.legs.travelAdvisory.tollInfo' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

Antwort mit Mautinformationen

Die Antwort enthält Informationen zu Mautgebühren in einem Objekt vom Typ TollInfo (REST) oder TollInfo (gRPC). In diesem Beispiel werden Mautinformationen für die gesamte Route und für jeden Abschnitt der Route zurückgegeben.

{
  "routes": [
    {
      "legs": [
        {
          "travelAdvisory": {
            "tollInfo": {
              "estimatedPrice": [
                {
                  "currencyCode": "USD",
                  "units": "4",
                  "nanos": 400000000
                }
              ]
            }
          }
        }
      ],
      "distanceMeters": 150338,
      "duration": "6650s",
      "travelAdvisory": {
        "tollInfo": {
          "estimatedPrice": [
            {
              "currencyCode": "USD",
              "units": "4",
              "nanos": 400000000
            }
          ]
        }
      }
    }
  ]
}