Calcola le tariffe per i pedaggi per un percorso

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

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

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

Come vengono calcolati i pedaggi

L'API Routes calcola il pedaggio stimato, tenendo conto di eventuali sconti o pass autostradali 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 richiesta:

• Il tipo di emissioni del veicolo utilizzato per il percorso (VehicleEmissionType). Se non viene fornito alcun tipo di emissioni, viene restituito il pedaggio per un veicolo a benzina.
• Tutti i telepedaggi di cui dispongono il veicolo e il conducente utilizzando (TollPass). L'API utilizza i telepedaggi per determinare i pedaggi accurati e restituisce i prezzi in contanti quando i telepedaggi nella richiesta non sono locali per il percorso.
• Se necessario, specifica di evitare i pedaggi. Se vuoi evitare le strade a pedaggio, se possibile, aggiungi avoidTolls come RouteModifier.

Calcolare i pedaggi utilizzando un telepedaggio

Per calcolare i pedaggi utilizzando un telepedaggio, devi specificare i telepedaggi come parte della richiesta. L'API restituisce quindi i prezzi dei pass.

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

• Se specifichi più telepedaggi come array, l'API tenta di calcolare il prezzo del percorso per ogni telepedaggio.

Il comportamento dei telepedaggi può variare in base alla regione.

• Le tariffe potrebbero essere inferiori con un telepedaggio: in alcune regioni, un conducente o un veicolo con un telepedaggio paga un pedaggio diverso rispetto a chi non ha un pass. Ad esempio, se hai un telepedaggio Good To Go! a Seattle, Washington, Stati Uniti, paghi un pedaggio inferiore rispetto a se non hai 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 pedaggi per un percorso

L'esempio seguente utilizza il computeRoutes metodo per restituire 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 pass, viene restituito il prezzo meno costoso.

• Utilizza la maschera del campo di risposta per configurare il metodo in modo che restituisca le informazioni sui pedaggi 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 informazioni su 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 sui pedaggi

La risposta contiene informazioni sui pedaggi in un TollInfo (REST) o TollInfo (gRPC). In questo esempio, restituisci 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
            }
          ]
        }
      }
    }
  ]
}