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 sull'itinerario. 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à 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 un 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 emissione del veicolo utilizzato per l'itinerario (VehicleEmissionType). Se non viene fornito alcun tipo di emissione, 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 autostradali esatte 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 per l'itinerario per ogni pedaggio.

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

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

  • 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, l'API non restituisce un prezzo del pedaggio.

Calcolare i 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 abbonamento autostradale. 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 abbonamento autostradale 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 di risposta:

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

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

Richiesta di informazioni sui pedaggi

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 sul pedaggio

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
            }
          ]
        }
      }
    }
  ]
}