Mautgebühren für eine Route berechnen

Wenn Sie eine Route oder eine Routenmatrix berechnen, sollten Sie eventuelle Mautgebühren für die 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 Ermitteln 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 zu TollPass.

So werden Mautgebühren berechnet

Die Routes API berechnet die geschätzte Mautgebühr unter Berücksichtigung aller dem Fahrer oder Fahrzeug zur Verfügung stehenden Mautpreisrabatte oder -pässe und der praktischsten Zahlungsmethoden. Wenn für eine bestimmte Route keine Mautgebühren verfügbar sind, weist die Routes API auf das Vorhandensein einer Mautgebühr mit unbekannter Gebühr hin.

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

• Der Emissionstyp des für die Route verwendeten Fahrzeugs (VehicleEmissionType). Wenn keine Art von Emissionstyp 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, und gibt Barpreise zurück, wenn Mautpässe in der Anfrage nicht lokal auf der Route vorkommen.
• Geben Sie bei Bedarf Mautstraßen an. Wenn Sie Mautstraßen wo möglich vermeiden möchten, fügen Sie avoidTolls als RouteModifier hinzu.

Mautstraßen mit einem Mautpass berechnen

Wenn Sie Mautpässe mit einer Mautkarte berechnen möchten, geben Sie diese in der Anfrage an. Die API gibt dann Karten-/Ticketpreise zurück.

• Wenn Sie eine ungültige Mautkarte angeben, wird die Karte bzw. das Ticket 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 Mautpässen kann je nach Region variieren.

• Die Gebühren können mit einem Mautpass niedriger sein: In einigen Regionen zahlt ein Fahrer oder Fahrzeug mit einem Mautpass eine andere Maut als Fahrer ohne Ausweis. Wenn Sie beispielsweise in Seattle, Washington, USA einen Mautpass vom Typ Good to Go! haben, zahlen Sie weniger als ohne Ticket.

• Für einige Straßen ist möglicherweise ein Mautpass 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 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 bei Nutzung einer Mautkarte Mautinformationen mit einem geschätzten Preis abzurufen. In diesem Beispiel führen Sie folgende Schritte aus:

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

• Geben Sie den Fahrzeugtyp und die Art der Mautkarte 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 zu jedem 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 Objekt von 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
            }
          ]
        }
      }
    }
  ]
}