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
commeRouteModifier
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
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
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égion | Pays/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.