Mautgebühren für eine Route berechnen

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.

Achtung: Anfragen, bei denen Mautgebühren berechnet werden, werden zu einem höheren Preis abgerechnet. Weitere Informationen zur Abrechnung für die Routes API

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.

Hinweis: Die Routes API berechnet Mautgebühren für eine Route anders als Google Maps:

• Die Routes API gibt nur die Mautpreise (mit oder ohne Mautkarte) zurück, die für die Fahrt tatsächlich berechnet würden, vorausgesetzt, Ihre Anfrage gibt korrekt an, welche Arten von Karten/Tickets die einzelnen Fahrer und/oder Fahrzeuge haben. Wenn Sie keine Mautkarten angeben, gibt die API die Preise für Barzahlungen zurück, was in der Regel der höchste Mautpreis ist.
• Google Maps gibt in der Regel den niedrigsten Preis für ein Fahrzeug zurück. Nutzer können nicht angeben, welche Mautkarten sie haben. Wenn sie die Mautgebühren für Barzahlungen sehen möchten, können sie die Option Gebühren mit Mautpass deaktivieren, die standardmäßig aktiviert ist.

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 als RouteModifier 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.

Hinweis :Eine Mautkarte kann nur für die Mobilitätsform DRIVE und TWO_WHEELER angegeben werden.

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

  Hinweis: Diese Route enthält nur einen Abschnitt.

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.

Hinweis: Die Routes API bietet eine estimatedPrice, die für nicht kommerzielle Fahrzeuge gilt.

• Die Mautpreise für Nutzfahrzeuge können abweichen.
• units und nanos werden weggelassen, wenn ihr Wert null ist.

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