Mautgebühren für eine Route berechnen

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.

Informationen zu Mautgebühren für eine Routenmatrix finden Sie unter Mautgebühren für eine Routenmatrix berechnen.

Eine Liste der unterstützten Mautstraßen findest du in der Referenz zu TollPass.

So werden Mautgebühren berechnet

Die Routes API berechnet die geschätzte Mautgebühr unter Berücksichtigung aller Gebührenrabatte oder Pässe, die dem Fahrer oder Fahrzeug zur Verfügung stehen, und der günstigsten Zahlungsmethoden. Wenn für eine bestimmte Route keine Mautgebühr verfügbar ist, weist die Routes API auf das Vorhandensein einer Maut mit einer unbekannten Gebühr hin.

Geben Sie in Ihrem Antrag die folgenden Informationen an, um korrekte Schätzungen für die Mautgebühren zu erhalten:

• Die Emissionsart des für die Route verwendeten Fahrzeugs (VehicleEmissionType). Wenn keine Emissionsart angegeben ist, wird die Maut für ein benzinbetriebenes Fahrzeug zurückgegeben.
• Alle Mautpässe, die das Fahrzeug und der Fahrer haben (TollPass). Die API verwendet die Mautpässe, um genaue Mautgebühren zu ermitteln. Wenn die Mautpässe in der Anfrage nicht lokal auf der Route vorkommen, werden Bargebühren zurückgegeben.
• Geben Sie bei Bedarf Mautstraßen an. Wenn Sie Mautstraßen wo möglich vermeiden möchten, fügen Sie avoidTolls als RouteModifier hinzu.

Mautgebühren mit einem Mautpass berechnen

Wenn Sie die Mautpässe mit einem Mautpass berechnen möchten, geben Sie in der Anfrage die entsprechenden Ausweise an. Die API gibt dann Karten-/Ticketpreise zurück.

• Wenn Sie eine ungültige Mautkarte angeben, wird sie ignoriert.

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

Das Verhalten von Mautkarten kann je nach Region variieren.

• Die Tarife mit einem Mautpass können niedriger sein: In einigen Regionen zahlt ein Fahrer oder Fahrzeug mit einem Mautpass eine andere Maut als jene ohne Ausweis. Wenn Sie beispielsweise in Seattle, Washington, USA eine Mautkarte Good to Go! haben, zahlen Sie weniger als ohne Zeitkarte.

• Für einige Straßen ist möglicherweise ein Mautpass erforderlich: In einigen Regionen wie Indonesien ist eine Mautkarte erforderlich. 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 werden mithilfe der Methode computeRoutes Mautinformationen mit einem geschätzten Preis zurückgegeben, wenn eine Mautkarte genutzt wird. In diesem Beispiel gehen Sie so vor:

• Setzen Sie das Array-Feld extraComputations auf TOLLS, um die Berechnung von Mautinformationen zu aktivieren.

• Geben Sie den Fahrzeugtyp und den Mautpasstyp im Feld routeModifiers der Anfrage an. Der zurückgegebene Mautpreis basiert auf den Preisen für den angegebenen Fahrzeugtyp und die Fahrkarte. Wenn mehr als eine Karte / ein Ticket angegeben ist, wird der günstigste Preis zurückgegeben.

• Mit der Antwortfeldmaske können Sie die Methode so konfigurieren, dass Mautinformationen in der Antwort 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.

Mautinformationen anfordern

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 TollInfo-Objekt (REST) oder TollInfo (gRPC). In diesem Beispiel geben Sie Mautinformationen für die gesamte Route und für jeden Abschnitt der Route zurück.

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