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ätzten Mautgebühren 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 Standorte für Mautgebühren finden Sie in der Referenz für TollPass.

So werden Mautgebühren berechnet

Die Routes API berechnet die geschätzten Mautgebühren unter Berücksichtigung aller für den Fahrer oder das Fahrzeug verfügbaren Mautpreisrabatte oder -karten sowie der bequemsten Zahlungsmethoden. Wenn für eine bestimmte Route kein Mautpreis verfügbar ist, gibt die Routes API an, dass eine Maut mit einem unbekannten Preis besteht.

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 Maut für ein benzinbetriebenes Fahrzeug zurückgegeben.
  • Alle verfügbaren Mautkarten/-vignetten für das Fahrzeug und den Fahrer (TollPass). Die API verwendet die Mautkarten/-vignetten, um die genauen Mautgebühren zu ermitteln, und gibt Barpreise zurück, wenn die Mautkarten/-vignetten in der Anfrage nicht für die Route gelten.
  • Geben Sie bei Bedarf an, dass Mautstraßen vermieden werden sollen. Wenn Sie Mautstraßen nach Möglichkeit vermeiden möchten, fügen Sie avoidTolls als RouteModifier hinzu.

Maut mit einem Mautpass berechnen

Wenn Sie Mautgebühren mit einem Mautpass berechnen möchten, geben Sie alle Mautkarten/-tickets als Teil der Anfrage an. Die API gibt dann die Preise für Karten/Tickets zurück.

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

  • Wenn Sie mehrere Mautkarten/-vignetten als Array angeben, versucht die API, den Preis für die Route für jede Karte/Vignette zu berechnen.

Die Funktionsweise von Mautkarten kann je nach Region variieren.

  • Mit einem Mautpass können die Preise niedriger sein: In einigen Regionen zahlen Fahrer oder Fahrzeuge mit einem Mautpass eine andere Maut als diejenigen, die keinen Pass haben. Wenn Sie beispielsweise in Seattle, Washington, USA, eine Good To Go!-Mautkarte haben, zahlen Sie eine niedrigere Maut als ohne Karte.

  • Für einige Straßen ist möglicherweise eine Mautkarte erforderlich: In einigen Regionen, z. B. in Indonesien, ist für bestimmte Straßen eine Mautkarte erforderlich. 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 bei Verwendung einer Mautkarte zurückzugeben. In diesem Beispiel haben Sie:

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

  • Geben Sie den Fahrzeugtyp und den Typ des Mautpasses mit dem Feld routeModifiers der Anfrage an. Der zurückgegebene Mautpreis basiert auf den Preisen, die für den angegebenen Fahrzeugtyp und die angegebene Karte/das angegebene Ticket gelten. Wenn mehrere Karten/Tickets 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 Eigenschaften in der Antwortfeldmaske:

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

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

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

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 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
            }
          ]
        }
      }
    }
  ]
}