Calcola le tariffe per i pedaggi per un percorso

Quando calcoli un percorso o una matrice di percorsi, è consigliabile prendere in considerazione i pedaggi lungo il percorso. Per città selezionate, puoi calcolare la stima tariffa a pedaggio per un percorso nella valuta appropriata.

Per ottenere i pedaggi per una matrice del percorso, consulta Calcolare le tariffe dei pedaggi per una matrice del percorso.

Per l'elenco delle località a pedaggio supportate, consulta la guida di riferimento per TollPass.

Come vengono calcolati i pedaggi

L'API Routes calcola la tariffa stimata del pedaggio, prendere in considerazione eventuali sconti o pass disponibili sul prezzo dei pedaggi. al conducente o al veicolo e i metodi di pagamento più comodi. Se non è disponibile un prezzo del pedaggio per un determinato itinerario, l'API Routes indica l'esistenza di un pedaggio con una tariffa sconosciuta.

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

  • Il tipo di emissione del veicolo utilizzato per il percorso (VehicleEmissionType). Se non viene specificato alcun tipo di emissione, il pedaggio per un veicolo a benzina è restituito.
  • Tutti i pedaggi di cui il veicolo e il conducente hanno utilizzando (TollPass). L'API utilizza i pedaggi per stabilire con esattezza i costi e restituisce i prezzi in contanti quando i pedaggi nella richiesta non sono locali rispetto al percorso.
  • Specificare l'opzione da evitare a pedaggio, se necessario. Se vuoi evitare le strade a pedaggio dove possibile, aggiungi avoidTolls come RouteModifier.

Calcolare i pedaggi con i pedaggi

Per calcolare i pedaggi utilizzando un pedaggio, devi specificare tutti i permessi nell'ambito di la richiesta. L'API restituisce quindi i prezzi dei pass.

  • Se specifichi una tessera a pedaggio non valida, questa viene ignorata.

  • Se si specificano più tessere pedaggio come array, l'API tenta di calcolare il prezzo del percorso per ogni pass.

Il comportamento dei pass per pedaggi può variare in base alla regione.

  • Le tariffe potrebbero essere inferiori con un pedaggio: in alcune regioni, un conducente o un veicolo con un pass pedaggio paghi un pedaggio diverso rispetto a chi non ne è in possesso. Ad esempio, se disponi di una Ottimo lavoro! pedaggio a Seattle, WA, USA, paghi un pedaggio inferiore rispetto a quando vengono superate.

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

Calcolare le tariffe dei pedaggi per un itinerario

L'esempio seguente utilizza il metodo computeRoutes metodo per restituire informazioni sui pedaggi con una stima quando si utilizza un pedaggio. In questo esempio:

  • Imposta il campo array extraComputations su TOLLS per abilitare il calcolo di informazioni sui pedaggi.

  • Specifica il tipo di veicolo e il tipo di pedaggio utilizzando il menu Campo routeModifiers della richiesta. Il prezzo del pedaggio restituito si basa su i prezzi usati per il tipo di veicolo e il pass specificati. Se più di uno pass viene specificato, viene restituito il prezzo meno costoso.

  • Utilizza la maschera del campo di risposta per configurare il metodo restituire informazioni sui pedaggi nella risposta. In questo esempio, la richiesta ha incluso le seguenti proprietà nella maschera del campo di risposta:

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

    • routes.legs.travelAdvisory.tollInfo per restituire informazioni per ogni gamba.

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 una TollInfo (REST) o Oggetto TollInfo (gRPC). In questo ad esempio, le informazioni sui pedaggi vengono visualizzate per l'intero percorso e per ogni tratto di lungo il 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
            }
          ]
        }
      }
    }
  ]
}