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

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

  • 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.

Maut mit einem Mautpass 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 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 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 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 Methode, um Informationen zu Mautgebühren mit einer Preis, wenn eine Mautpassgebühr verwendet wird. In diesem Beispiel haben Sie:

  • 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 Karten/Tickets angegeben sind, 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 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.

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