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 die geschätzten Mautgebühren 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ätzten Mautgebühren 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.

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

• Der Emissionstyp des für die Route verwendeten Fahrzeugs (VehicleEmissionType). Wenn kein Emissionstyp angegeben ist, wird die Maut für ein benzinbetriebenes Fahrzeug 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.

Maut mit einem Mautpass 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: Sie können nur für die Mobilitätsarten DRIVE und TWO_WHEELER eine Mautkarte angeben.

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 bei Verwendung einer Mautkarte zurückzugeben. In diesem Beispiel haben Sie:

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

• Verwenden Sie die Antwortfeldmaske, um die Methode so zu konfigurieren, dass Mautinformationen in der Antwort zurückgegeben werden. 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.

  Hinweis: Diese Route enthält nur einen Abschnitt.

Informationen zu Mautgebühren 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 Informationen zu Mautgebühren

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.

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