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 zones de péage disponibles, consultez la documentation de référence 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:

• Le type d'émissions du véhicule utilisé pour l'itinéraire (VehicleEmissionType). Si aucun type d'émission n'est indiqué, le péage pour un véhicule à essence est le suivant : renvoyé.
• Tous les pass de péage du véhicule et du conducteur (TollPass). L'API utilise les pass de péage pour déterminer les frais de péage exacts 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 télépéage

Pour calculer les péages à l'aide d'un pass de péage, vous devez les spécifier dans la demande. 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 nécessitent un pass de péage: certaines régions, comme l'Indonésie, ont les routes qui nécessitent un pass à péage. Si vous n'indiquez pas de télépéage pour nécessitant un télépéage, 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 classe computeRoutes pour obtenir des informations sur les péages avec une estimation lorsqu'un télépéage est utilisé. 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 pour : les informations sur les péages dans la réponse. Dans cet exemple, la requête inclus 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
            }
          ]
        }
      }
    }
  ]
}