Calcola le tariffe per i pedaggi per un percorso

Sviluppatori dello Spazio economico europeo (SEE)

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

Per ottenere i pedaggi per una matrice di itinerari, consulta Calcolare i pedaggi per una matrice di itinerari.

Per l'elenco delle località di 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 (TollPass). L'API utilizza i pedaggi per determinare le tariffe precise 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 il telepedaggio

Per calcolare i pedaggi utilizzando un telepedaggio, specifica i telepedaggi come parte della richiesta. L'API restituisce quindi i prezzi degli abbonamenti.

  • Se specifichi un telepedaggio non valido, il telepedaggio viene ignorato.

  • Se specifichi più abbonamenti autostradali come array, l'API tenta di calcolare il prezzo per l'itinerario per ciascun abbonamento.

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

  • Le tariffe potrebbero essere inferiori con il telepedaggio: in alcune regioni, un conducente o un veicolo con il telepedaggio paga un pedaggio diverso rispetto a chi non ne ha uno. Ad esempio, se hai un Good To Go! telepedaggio a Seattle, WA, Stati Uniti, paghi un pedaggio inferiore rispetto a chi non ha un pass.

  • Alcune strade potrebbero richiedere il telepedaggio: alcune regioni, come l'Indonesia, hanno strade che richiedono il telepedaggio. Se non specifichi un telepedaggio per un percorso in cui è richiesto, l'API non restituisce un prezzo del pedaggio.

Calcolare i costi dei pedaggi per un percorso

L'esempio seguente utilizza il metodo computeRoutes per restituire le informazioni sui pedaggi con un prezzo stimato quando viene utilizzato un telepedaggio. In questo esempio:

  • Imposta il campo dell'array extraComputations su TOLLS per attivare il calcolo delle informazioni sui pedaggi.

  • Specifica il tipo di veicolo e il tipo di telepedaggio utilizzando il campo routeModifiers della richiesta. Il prezzo del pedaggio restituito si basa sui prezzi utilizzati dal tipo di veicolo e dal pass specificati. Se viene specificato più di un abbonamento, viene restituito il prezzo meno costoso.

  • Utilizza la maschera del campo di risposta per configurare il metodo per restituire le informazioni sul pedaggio nella risposta. In questo esempio, la richiesta includeva le seguenti proprietà nella maschera del campo della risposta:

    • routes.travelAdvisory.tollInfo per restituire informazioni sull'intero percorso.

    • routes.legs.travelAdvisory.tollInfo per visualizzare le informazioni per ogni tratta.

Richiesta di informazioni sul pedaggio

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'

Risposta contenente informazioni sui pedaggi

La risposta contiene informazioni sui pedaggi in un oggetto TollInfo (REST) o TollInfo (gRPC). In questo esempio, vengono restituite le informazioni sui pedaggi per l'intero percorso e per ogni tratta del percorso.

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