Mautgebühren für eine Route berechnen

Wenn Sie eine Route oder eine Routenmatrix berechnen, müssen Sie eventuell auf der Route anfallende Mautgebühren berücksichtigen. Für ausgewählte Städte können Sie den geschätzten Mautgebühren für eine Route in der entsprechenden Währung.

Mautstraßen 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, Dabei werden alle verfügbaren Mautgebührenrabatte oder Pässe berücksichtigt. den Fahrer oder das Fahrzeug und die bequemsten Zahlungsmethoden. Wenn für eine bestimmte Route keine Mautgebühr verfügbar ist, Die Routes API gibt an, dass eine Mautpflicht besteht. mit einer unbekannten Gebühr.

Gib die folgenden Informationen an, um eine genaue Schätzung der Maut zu erhalten in Ihrer Anfrage:

• Die Emissionsart des für die Route eingesetzten Fahrzeugs (VehicleEmissionType). Wenn keine Emissionsart angegeben ist, beträgt 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 zur Bestimmung korrekter Mautgebühren und gibt Barpreise zurück wenn die Mautkarten in der Anfrage nicht lokal für die Route gelten.
• Geben Sie gegebenenfalls Mautgebühren an. Um Mautstraßen zu vermeiden, Fügen Sie avoidTolls als RouteModifier hinzu.

Mautstraßen mit einer Fahrkarte berechnen

Zur Berechnung von Mautgebühren mit einer Zeitkarte geben Sie der Anfrage. Die API gibt dann die Preise für die Karte bzw. das Ticket zurück.

• Wenn Sie eine ungültige Mautkarte angeben, wird die Karte bzw. das Ticket ignoriert.

• Wenn Sie mehrere Mautkarten als Array angeben, versucht die API, den Preis für die Route für die jeweilige Karte bzw. das Ticket zu berechnen.

Die Art der Mautkarten kann je nach Region variieren.

• Mit einer Mautpassgebühr können die Gebühren niedriger sein: In einigen Regionen kann ein Fahrer oder Fahrzeug mit einem Mautpass eine andere Maut als Mautgebühren ohne Karte/Ticket. Wenn Sie zum Beispiel eine Gut gemacht! in Seattle, WA, USA, zahlen Sie eine geringere Maut als ohne übergeben.

• Für einige Straßen ist möglicherweise eine Mautpassgebühr erforderlich: In einigen Regionen, z. B. in Indonesien, gibt es Straßen, auf denen eine Mautpassgebühr erforderlich ist. Wenn Sie keine Mautkarte für die eine Mautkarte erforderlich ist, gibt das API keine Mautgebühren zurück.

Mautgebühren für eine Route berechnen

Im folgenden Beispiel wird die Methode computeRoutes Methode, um Informationen zu Mautgebühren mit einer Preis, wenn eine Mautpassgebühr verwendet wird. In diesem Beispiel führen Sie folgende Schritte aus:

• Legen Sie das Array-Feld extraComputations auf TOLLS fest, um die Berechnung zu aktivieren Informationen zu Mautgebühren.

• Geben Sie den Fahrzeugtyp und die Art der Mautkarte mithilfe der routeModifiers der Anfrage. Der zurückgegebene Mautpreis basiert auf den Preis, der für den angegebenen Fahrzeugtyp und die angegebene Karte/das angegebene Ticket verwendet wird. Wenn mehrere übergeben, wird der günstigste Preis zurückgegeben.

• Verwenden Sie die Antwortfeldmaske, um die Methode für Mautinformationen in der Antwort zurückgeben. In diesem Beispiel ist die Anfrage die folgenden Attribute in die Antwortfeldmaske aufgenommen:

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

  • routes.legs.travelAdvisory.tollInfo, um Informationen zurückzugeben für jedes Bein.

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 (REST) oder Objekt TollInfo (gRPC). In dieser erhalten Sie z. B. Mautinformationen für die gesamte Route und für jeden Abschnitt die Route berechnen.

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