L'API Routes est actuellement en version bêta (avant la mise à disposition générale). Il est possible que les produits et fonctionnalités pré-DG présentent une compatibilité limitée, et que les modifications apportées aux produits et fonctionnalités pré-DG ne soient pas compatibles avec d'autres versions pré-DG. Les Offres de pré-DG sont couvertes par les Conditions spécifiques au service Google Maps Platform. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Calculer les frais de péage

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Lorsque vous calculez une route ou une matrice d'itinéraire, vous pouvez prendre en compte les frais de péage sur l'itinéraire. Pour certaines villes, vous pouvez calculer les frais de péage estimés pour un itinéraire dans la devise appropriée.

Vous trouverez ci-dessous la liste des péages.

Calcul des péages

L'API Routes calcule les frais de péage estimés, en tenant compte des éventuels péages ou remises disponibles pour le conducteur ou le véhicule, ainsi que des modes de paiement les plus pratiques. Si aucuns frais de péage ne sont disponibles pour un itinéraire donné, l'API Routes indique l'existence d'un péage dont les frais sont inconnus.

Pour calculer avec précision les frais de péage, l'API Routes vous permet de spécifier les éléments suivants:

  • Type d'émission du véhicule utilisé pour l'itinéraire (VehicleEmissionType). Si aucun type d'émission n'est spécifié, les frais de péage d'un véhicule à carburant carburant sont renvoyés.
  • Tout pass de péage pour le conducteur ou le véhicule peut s'appliquer (TollPass). Si aucun péage n'est spécifié, l'API affiche le prix en espèces.
  • avoidTolls comme RouteModifier pour éviter les routes à péage.

Calcul des péages lorsque vous utilisez un pass de péage

Dans certaines régions, les conducteurs ou les véhicules avec un péage paient des frais différents de ceux qui n'en ont pas. Par exemple, si vous proposez un pass payant Good To Go! à Seattle, dans l'État de Washington, vous payez un tarif moins élevé que si vous n'avez pas de titre de transport.

Certaines régions, comme l'Indonésie, disposent de routes nécessitant un péage. Si aucun télépéage n'est spécifié pour un itinéraire nécessitant un péage, aucun prix n'est renvoyé.

Si vous spécifiez un péage dans la requête, l'API tente de renvoyer le prix du billet:

  • Si vous spécifiez un titre de péage non valide, il est ignoré.

  • Vous pouvez spécifier plusieurs pass de péage sous forme de tableau. L'API tente de calculer le prix de la carte pour chaque carte.

Calculer les frais de péage pour un itinéraire

L'exemple suivant utilise la méthode computeRoutes pour renvoyer les informations sur les frais de péage avec une estimation du prix d'un pass de péage.

Spécifiez le type de véhicule et le type de péage en utilisant le champ routeModifiers de la requête. Les frais de péage affichés sont basés sur les tarifs utilisés pour le type de véhicule et la carte spécifiés. Si plusieurs cartes sont spécifiées, la tarification la moins coûteuse est renvoyée.

Demande d'informations sur les péages

curl -X POST -d '{
  "origin":{
    "location":{
      "latLng":{
        "latitude":42.340173523716736,
        "longitude":-71.05997968330408
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude":42.075698891472804,
        "longitude": -72.59806562080408
      }
    }
  },
  "travelMode": "DRIVE",
  "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'

Réponse contenant des informations sur les péages

La réponse contient des informations sur les péages dans un objet TollInfo (REST) ou TollInfo (gRPC).

Pour configurer la méthode de renvoi des frais de péage, utilisez le masque de champ de réponse. Définissez le champ routes.travelAdvisory.tollInfo pour qu'il affiche les informations relatives à l'intégralité de l'itinéraire et routes.legs.travelAdvisory.tollInfo pour renvoyer les informations concernant chaque étape.

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

Calculer les frais de péage pour une matrice d'itinéraire

L'exemple suivant utilise la méthode computeRouteMatrix pour renvoyer des informations sur les frais de péage sur un itinéraire avec une estimation du prix lorsqu'un pass de péage est utilisé.

Spécifiez le type de véhicule et le type de péage en utilisant le champ routeModifiers de la requête. Les frais de péage affichés sont basés sur les tarifs utilisés pour le type de véhicule et la carte spécifiés. Si plusieurs cartes sont spécifiées, la tarification la moins coûteuse est renvoyée.

Demande de péage pour la matrice de routage

curl -X POST -d '{
"origins": [
  {
    "waypoint": {
      "location": {
        "latLng": {
          "latitude":42.340173523716736,
          "longitude":-71.05997968330408
        }
      }
    },
    "routeModifiers": {
      "vehicleInfo":{
        "emissionType": "GASOLINE"
      },
      "tollPasses": [
        "US_MA_EZPASSMA",
        "US_WA_GOOD_TO_GO"
      ]
    }
  }
],
"destinations": [
  {
    "waypoint": {
      "location": {
        "latLng": {
          "latitude":42.075698891472804,
          "longitude": -72.59806562080408
        }
      }
    }
  }
],
"travelMode": "DRIVE",
"routingPreference": "TRAFFIC_AWARE"
}'
-H 'Content-Type: application/json'
-H 'X-Goog-Api-Key: YOUR_API_KEY'
-H 'X-Goog-FieldMask: originIndex,destinationIndex,travel_advisory.tollInfo,duration,distanceMeters,status' 'https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix'

Réponse pour les informations sur les péages dans la matrice de routage

La réponse contient des informations sur les péages dans un objet TollInfo (REST) ou TollInfo (gRPC).

Pour configurer la méthode de renvoi des informations sur les frais de péage, utilisez le masque de champ de réponse afin de définir le champ travelAdvisory.tollInfo dans le masque.

[
  {
    "originIndex": 0,
    "destinationIndex": 0,
    "status": {},
    "distanceMeters": 150338,
    "duration": "5382s",
    "travelAdvisory": {
      "tollInfo": {
        "estimatedPrice": [
          {
            "currencyCode": "USD",
            "units": "4",
            "nanos": 400000000
           }
        ]
      }
    }
  }
]

Péages acceptés

Les informations sur les péages sont actuellement disponibles pour les lieux suivants:

Code de régionPays/RégionÉtat/ville/péage
RA Argentine Buenos Aires
AU Australie Brisbane
AU Australie Sydney
BR Brésil Pays
ID Indonésie Pays
IN Inde Pays
MX Mexique Mexico
États-Unis United States Alabama
États-Unis United States Alaska
États-Unis United States Californie
États-Unis United States Colorado
États-Unis United States Delaware
États-Unis United States Floride
États-Unis United States Illinois
États-Unis United States Iowa
États-Unis United States Indiana
États-Unis United States Kansas
États-Unis United States Louisiane
États-Unis United States Maine
États-Unis United States Maryland
États-Unis United States Massachusetts
États-Unis United States Michigan
États-Unis United States Minnesota
États-Unis United States Missouri
États-Unis United States New Hampshire
États-Unis United States New Jersey
États-Unis United States New York
États-Unis United States Caroline du Nord
États-Unis United States Ohio
États-Unis United States Pennsylvanie
États-Unis United States Rhode Island
États-Unis United States Caroline du Sud
États-Unis United States Texas
États-Unis United States Utah
États-Unis United States Nord
États-Unis United States Washington
États-Unis United States Virginie-Occidentale

Ces informations seront mises à jour à mesure que d'autres données de péage seront disponibles.