Calculer les frais de péage

Développeurs de l'Espace économique européen (EEE)

Lorsque vous calculez un itinéraire ou une matrice de routes, vous pouvez tenir compte des éventuels péages sur l'itinéraire. Pour certaines villes, vous pouvez calculer le montant estimé des péages pour un itinéraire dans la devise appropriée.

Pour obtenir la liste des emplacements de péage acceptés, consultez la référence TollPass.

Calcul des péages

L'API Routes calcule les frais de péage estimés en tenant compte des éventuelles remises ou abonnements télépéage disponibles pour le conducteur ou le véhicule, ainsi que des méthodes 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 avec des frais inconnus.

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

  • Type d'émission du véhicule utilisé pour l'itinéraire (VehicleEmissionType). Si aucun type d'émission n'est fourni, le péage pour un véhicule à essence est renvoyé.
  • Tous les badges de péage dont disposent le véhicule et le conducteur à l'aide de tollPasses. L'API utilise les badges de péage pour déterminer les frais de péage exacts et renvoie les prix en espèces lorsque les badges de péage de la requête ne sont pas locaux à l'itinéraire.
  • Spécifiez d'éviter les péages, si nécessaire. Si vous souhaitez éviter les routes à péage dans la mesure du possible, ajoutez avoidTolls en tant que RouteModifier.

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

Pour calculer les péages à l'aide d'un badge de télépéage, vous devez spécifier les badges de télépéage dans la requête. L'API renvoie ensuite les prix des pass.

  • Si vous spécifiez un badge de péage non valide, il est ignoré.
  • Si vous spécifiez plusieurs badges de péage sous forme de tableau, l'API tente de calculer le prix de l'itinéraire pour chaque badge.

Le fonctionnement des badges de péage peut varier selon la région.

  • Les tarifs peuvent être plus bas avec un badge de télépéage : dans certaines régions, un conducteur ou un véhicule équipé d'un badge de télépéage paie un péage différent de ceux qui n'en ont pas. Par exemple, si vous avez un Good To Go! Si vous avez un badge de péage à Seattle, dans l'État de Washington (États-Unis), vous payez un péage moins élevé que si vous n'en avez pas.
  • Certaines routes peuvent nécessiter un badge de péage : dans certaines régions, comme l'Indonésie, certaines routes nécessitent un badge de péage. Si vous ne spécifiez pas de badge de péage pour un itinéraire où il est requis, l'API ne renvoie pas de prix de péage.

Calculer les péages pour un itinéraire

Pour calculer les péages d'un itinéraire :

  • Définissez la propriété extraComputations sur TOLLS.
  • Spécifiez le type de véhicule et le type de badge de péage à l'aide de la propriété routeModifiers.
  • Pour calculer les péages pour un itinéraire complet, demandez travelAdvisory dans la propriété fields de la requête. Consultez les informations sur les péages pour l'itinéraire complet en lisant route.travelAdvisory.tollInfo.
  • Pour calculer les péages pour les sections individuelles d'un itinéraire, demandez legs dans la propriété fields de la requête. Consultez les informations sur les péages pour chaque section en lisant route.legs[i].travelAdvisory.tollInfo.

Exemple

L'exemple de requête suivant montre comment demander les péages pour un itinéraire :

const requestWithTolls = {
  origin: 'Kirkland, WA',
  destination: 'University of Washington',
  travelMode: 'DRIVING',
  extraComputations: ['TOLLS'],
  routeModifiers: {
    vehicleInfo: {
      emissionType: 'GASOLINE',
    },
    tollPasses: ['US_WA_GOOD_TO_GO'],
  },
  fields: ['path', 'legs', 'distanceMeters', 'durationMillis', 'travelAdvisory'],
};