Calcola le tariffe

Sviluppatori dello Spazio economico europeo (SEE)

Quando calcoli un itinerario o una matrice di itinerari, potresti voler prendere in considerazione eventuali pedaggi sull'itinerario. Per alcune città, puoi calcolare il pedaggio stimato per un percorso nella valuta appropriata.

Per l'elenco delle località con pedaggio supportate, consulta il riferimento per TollPass.

Come vengono calcolati i pedaggi

L'API Routes calcola il costo stimato del pedaggio, tenendo conto di eventuali sconti o pass disponibili per il conducente o il veicolo e dei metodi di pagamento più convenienti. Se non è disponibile alcun prezzo del pedaggio per un determinato percorso, l'API Routes indica l'esistenza di un pedaggio con una tariffa sconosciuta.

Per ottenere stime accurate dei pedaggi, assicurati di includere le seguenti informazioni nella tua richiesta:

  • Il tipo di emissioni del veicolo utilizzato per l'itinerario (VehicleEmissionType). Se non viene fornito alcun tipo di emissioni, viene restituito il pedaggio per un veicolo a benzina.
  • Tutti i pedaggi che il veicolo e il conducente hanno utilizzando tollPasses. L'API utilizza i pedaggi per determinare le tariffe autostradali accurate e restituisce i prezzi in contanti quando i pedaggi nella richiesta non sono locali per l'itinerario.
  • Specifica di evitare i pedaggi, se necessario. Se vuoi evitare le strade a pedaggio, se possibile, aggiungi avoidTolls come RouteModifier.

Calcolare i pedaggi utilizzando un abbonamento autostradale

Per calcolare i pedaggi utilizzando un abbonamento autostradale, specifica gli abbonamenti autostradali come parte della richiesta. L'API restituisce quindi i prezzi degli abbonamenti.

  • Se specifichi un abbonamento autostradale non valido, l'abbonamento viene ignorato.
  • Se specifichi più pedaggi come array, l'API tenta di calcolare il prezzo dell'itinerario per ogni pedaggio.

Il funzionamento dei pedaggi può variare in base alla regione.

  • Le tariffe potrebbero essere inferiori con un abbonamento per il pedaggio: in alcune regioni, un conducente o un veicolo con un abbonamento per il pedaggio paga un pedaggio diverso rispetto a chi non ha un abbonamento. Ad esempio, se hai un Good To Go! in Seattle, WA, Stati Uniti, paghi un pedaggio inferiore rispetto a quello che pagheresti se non avessi un abbonamento.
  • Alcune strade potrebbero richiedere un abbonamento autostradale: alcune regioni, come l'Indonesia, hanno strade che richiedono un abbonamento autostradale. Se non specifichi un abbonamento autostradale per un percorso in cui è richiesto un abbonamento autostradale, l'API non restituisce un prezzo del pedaggio.

Calcolare i pedaggi per un percorso

Per calcolare i pedaggi per un percorso:

  • Imposta la proprietà extraComputations su TOLLS.
  • Specifica il tipo di veicolo e il tipo di abbonamento autostradale utilizzando la proprietà routeModifiers.
  • Per calcolare i pedaggi per un intero itinerario, richiedi travelAdvisory nella proprietà fields della richiesta; visualizza le informazioni sui pedaggi per l'intero itinerario leggendo route.travelAdvisory.tollInfo.
  • Per calcolare i pedaggi per i singoli segmenti di un percorso, richiedi legs nella proprietà fields della richiesta; visualizza le informazioni sui pedaggi per ogni segmento leggendo route.legs[i].travelAdvisory.tollInfo.

Esempio

La seguente richiesta di esempio mostra come richiedere i pedaggi per un percorso:

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'],
};