Mautgebühren für eine Route 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.

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 Mautstandorte 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 aller Mautpreisnachlässe oder -pässe, 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 Mautgebühr mit unbekannter Gebühr anfällt.

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

  • Der Emissionstyp des für die Route verwendeten Fahrzeugs (VehicleEmissionType). Wenn kein Emissionstyp angegeben ist, wird die Mautgebühr für ein benzinbetriebenes Fahrzeug zurückgegeben.
  • Alle Mautpässe, die das Fahrzeug und der Fahrer haben mit (TollPass). Die API verwendet die Mautpässe, um genaue Mautgebühren zu ermitteln, und gibt Barpreise zurück, wenn die Mautpässe in der Anfrage nicht lokal für die Route sind.
  • Geben Sie bei Bedarf an, dass Mautgebühren vermieden werden sollen. Wenn Sie Mautstraßen nach Möglichkeit vermeiden möchten, fügen Sie avoidTolls als RouteModifier hinzu.

Mautgebühren mit einem Mautpass berechnen

Wenn Sie Mautgebühren mit einem Mautpass berechnen möchten, geben Sie alle Mautpässe als Teil der Anfrage an. Die API gibt dann die Passpreise zurück.

  • Wenn Sie einen ungültigen Mautpass angeben, wird er ignoriert.

  • Wenn Sie mehrere Mautpässe als Array angeben, versucht die API, den Preis für die Route für jeden Pass zu berechnen.

Die Funktionsweise von Mautpässen kann je nach Region variieren.

  • Die Preise können mit einem Mautpass niedriger sein: In einigen Regionen zahlt ein Fahrer oder ein Fahrzeug mit einem Mautpass eine andere Mautgebühr als diejenigen, die keinen Pass haben. Wenn Sie beispielsweise einen Good To Go! Mautpass in Seattle, Washington, USA, haben, zahlen Sie eine niedrigere Mautgebühr als ohne Pass.

  • Für einige Straßen ist möglicherweise ein Mautpass erforderlich: In einigen Regionen wie Indonesien gibt es Straßen, für die ein Mautpass 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

Im folgenden Beispiel wird die computeRoutes Methode verwendet, um Mautinformationen mit einem geschätzten Preis zurückzugeben, wenn ein Mautpass verwendet wird. In diesem Beispiel:

  • Legen Sie das Arrayfeld extraComputations auf TOLLS fest, um die Berechnung von Mautinformationen zu aktivieren.

  • Geben Sie den Fahrzeugtyp und den Mautpasstyp mit dem Feld routeModifiers der Anfrage an. Der zurückgegebene Mautpreis basiert auf den Preisen, die für den angegebenen Fahrzeugtyp und Pass verwendet werden. Wenn mehr als ein Pass angegeben ist, wird der günstigste Preis zurückgegeben.

  • Verwenden Sie die Feldmaske für die Antwort, um die Methode so zu konfigurieren, dass Mautinformationen in der Antwort zurückgegeben werden. In diesem Beispiel enthielt die Anfrage die folgenden Eigenschaften in der Feldmaske für die Antwort:

    • Das Feld routes.travelAdvisory.tollInfo gibt Informationen für die gesamte Route zurück.

    • routes.legs.travelAdvisory.tollInfo gibt Informationen für jede Etappe zurück.

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 TollInfo-Objekt (REST) oder TollInfo-Objekt (gRPC). In diesem Beispiel geben Sie Mautinformationen für die gesamte Route und für jede Etappe 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
            }
          ]
        }
      }
    }
  ]
}