Mautgebühren für eine Route berechnen

Wenn Sie eine Route oder eine Routenmatrix berechnen, sollten Sie eventuelle 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 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 verfügbaren Mautkarten für den Fahrer oder das Fahrzeug sowie der bequemsten Zahlungsmethoden. Wenn für eine bestimmte Route kein Mautpreis verfügbar ist, gibt die Routes API das Vorhandensein einer Maut mit unbekannter Gebühr an.

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 (TollPass). 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 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.

Das Verhalten von Mautkarten kann je nach Region variieren.

• Mautgebühren können mit einem Mautpass niedriger sein: In einigen Regionen zahlen Fahrer oder Fahrzeuge mit einem Mautpass eine andere Mautgebühr als Fahrer oder Fahrzeuge ohne Pass. Wenn Sie beispielsweise in Seattle, WA, USA, eine Good To Go!-Mautkarte haben, zahlen Sie eine niedrigere Mautgebühr als ohne Karte.

• 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

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:

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

• Geben Sie den Fahrzeugtyp und den Mautpass-Typ mit dem Feld routeModifiers der Anfrage an. Der zurückgegebene Mautpreis basiert auf den Preisen, die für den angegebenen Fahrzeugtyp und die angegebene Mautkarte gelten. Wenn mehrere Karten angegeben sind, wird der günstigste Preis zurückgegeben.

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

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

  • routes.legs.travelAdvisory.tollInfo, um Informationen für jede Etappe zurückzugeben.

Anfrage zu 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 Informationen zu Mautgebühren

Die Antwort enthält Informationen zu Mautgebühren in einem TollInfo- (REST) oder TollInfo-Objekt (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
            }
          ]
        }
      }
    }
  ]
}