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

Lorsque vous calculez un itinéraire ou une matrice de routes, vous devrez peut-être tenir compte des frais de péage sur l’itinéraire. Pour certaines villes, vous pouvez calculer l'estimation les frais de péage pour un itinéraire dans la devise correspondante.

Pour connaître les péages d'un itinéraire, consultez l'article Calculer les frais de péage pour une matrice d'itinéraires

Pour obtenir la liste des emplacements de péage compatibles, consultez la documentation sur TollPass.

Mode de calcul des péages

L'API Routes calcule les frais de péage estimés, en tenant compte des remises ou des forfaits disponibles au conducteur ou au véhicule, ainsi que les modes de paiement les plus pratiques. Si aucun prix de péage n'est disponible pour un itinéraire donné, l'API Routes indique l'existence d'un péage moyennant des frais inconnus.

Pour obtenir des estimations précises des péages, veillez à inclure les informations suivantes : dans votre demande:

  • Type d'émissions du véhicule utilisé pour l'itinéraire (VehicleEmissionType). Si aucun type d'émissions n'est fourni, le péage d'un véhicule à essence est renvoyé.
  • Tous les pass de péage du véhicule et du conducteur (TollPass). L'API utilise les tickets de péage pour déterminer précisément les frais de péage et renvoyer les prix en espèces lorsque les pass de péage inclus dans la demande ne sont pas locaux à l'itinéraire.
  • Indiquez comment éviter les péages, si nécessaire. Si vous souhaitez éviter les routes à péage possible, ajoutez avoidTolls en tant que RouteModifier.

Calculer les péages à l'aide d'un pass de péage

Pour calculer les péages à l'aide d'une carte de péage, vous devez spécifier les cartes de péage dans la requête. L'API renvoie ensuite les prix des cartes.

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

  • Si vous spécifiez plusieurs pass de péage sous forme de tableau, l'API tente calculer le prix de l'itinéraire pour chaque pass.

Le comportement des pass de péage peut varier d'une région à l'autre.

  • Les tarifs peuvent être inférieurs avec un pass de péage: dans certaines régions, un conducteur ou un véhicule avec un télépéage paie un péage différent de celui des autres. Par exemple, si vous avez un Bravo ! à Seattle (Washington) aux États-Unis, vous payez moins cher que si vous n'avez pas de passe.

  • Certaines routes peuvent nécessiter une carte de péage : dans certaines régions, comme l'Indonésie, certaines routes nécessitent une carte de péage. Si vous ne spécifiez pas de carte de péage pour un itinéraire où une carte de péage est requise, l'API ne renvoie pas de prix de péage.

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

L'exemple suivant utilise la méthode computeRoutes pour renvoyer des informations sur les péages avec un prix estimé lorsqu'une carte de péage est utilisée. Dans cet exemple, vous allez:

  • Définissez le champ de tableau extraComputations sur TOLLS pour activer le calcul d'informations sur les péages.

  • Spécifiez le type de véhicule et le type de télépéage à l'aide des routeModifiers de la requête. Les prix de péage renvoyés sont basés sur le prix utilisé pour le type de véhicule et le pass spécifiés. Si plusieurs est spécifié, le tarif le moins cher est renvoyé.

  • Utilisez le masque de champ de réponse pour configurer la méthode afin qu'elle renvoie des informations sur les péages dans la réponse. Dans cet exemple, la requête incluait les propriétés suivantes dans le masque de champ de réponse :

    • le champ routes.travelAdvisory.tollInfo pour renvoyer des informations pour le l'intégralité de l'itinéraire.

    • routes.legs.travelAdvisory.tollInfo pour renvoyer des informations pour chaque jambe.

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",
  "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'

Réponse contenant des informations sur les péages

La réponse contient des informations sur les péages dans une TollInfo (REST) ou TollInfo (gRPC). Dans ce Par exemple, vous obtenez des informations sur les péages pour l'intégralité de l'itinéraire et pour chaque section de la route.

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