Wenn Sie eine Route oder eine Routenmatrix berechnen, sollten Sie alle Mautgebühren 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 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 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.
Bitte geben Sie in Ihrer Anfrage die folgenden Informationen an, damit Sie genaue Schätzungen erhalten:
- Die Emissionstyp des für die Route eingesetzten Fahrzeugs (
VehicleEmissionType
). Wenn keine Emissionsart angegeben ist, wird die Maut für ein Benzinfahrzeug zurückgegeben. - Alle verfügbaren Mautkarten/-vignetten für das Fahrzeug und den Fahrer mit (
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
alsRouteModifier
hinzu.
Mautstraßen mit einer Fahrkarte 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 zurückzugeben, wenn eine Mautkarte verwendet wird. In diesem Beispiel führen Sie folgende Schritte aus:
Legen Sie das Array-Feld
extraComputations
aufTOLLS
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 werden, wird der günstigste Preis zurückgegeben.Mit der Antwortfeldmaske können Sie die Methode konfigurieren, mit der in der Antwort Mautinformationen zurückgegeben werden. In diesem Beispiel enthielt die Anfrage die folgenden Eigenschaften in der Antwortfeldmaske:
routes.travelAdvisory.tollInfo
, 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 Informationen zu Mautgebühren
Die Antwort enthält Informationen zu Mautgebühren in einem Objekt vom Typ 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 } ] } } } ] }