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.

Cette page a été traduite par l'API Cloud Translation.

Switch to English

Calculer les frais de péage

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

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