Questa pagina è stata tradotta dall'API Cloud Translation.

Calcola le tariffe

Quando calcoli una route o una matrice, potresti prendere in considerazione eventuali tariffe a pedaggio per la route. Per alcune città puoi calcolare la tariffa per i pedaggi stimati per un percorso nella valuta appropriata.

Consulta il seguente elenco di località dei pedaggi supportate.

Come vengono calcolati i pedaggi

L'API Routes calcola la tariffa per i pedaggi stimati, tenendo in considerazione eventuali sconti o pedaggi disponibili per il conducente o il veicolo e i metodi di pagamento più comodi. Se non è disponibile alcun prezzo per un determinato pedaggio per una determinata route, l'API Routes indica l'esistenza di un pedaggio con una tariffa sconosciuta.

Per poter calcolare con precisione le informazioni sui pedaggi, l'API Routes ti offre la possibilità di specificare:

Il tipo di emissione del veicolo utilizzato per il percorso (VehicleEmissionType). Se non viene fornito alcun tipo di emissione, viene restituito il pedaggio per un veicolo a benzina.
Qualsiasi pedaggio per il conducente o il veicolo che può essere applicato (TollPass). Se non sono specificati pedaggi, l'API restituisce il prezzo in contanti.
avoidTolls come RouteModifier per evitare strade a pedaggio.

Calcolo dei pedaggi quando si utilizza un pedaggio

In alcune aree geografiche, il conducente o il veicolo con un pedaggio paga un pedaggio diverso rispetto a chi non ha un pedaggio. Ad esempio, se hai un pass pedaggio Good To Go! a Seattle, Washington, Stati Uniti, pagherai un pedaggio inferiore rispetto a quando non hai un pass.

Alcune aree geografiche, come l'Indonesia, hanno strade che richiedono un pedaggio. Se non è specificato un pass per un pedaggio per un percorso in cui è richiesto, non viene restituito alcun prezzo.

Se specifichi un pedaggio nell'ambito della richiesta, l'API tenta di restituire il prezzo del pass:

Se specifichi un pedaggio non valido, il pass viene ignorato.
Puoi specificare più pedaggi come array. L'API tenta di calcolare il prezzo del pass per il percorso di ogni pass.

Calcola le tariffe per i pedaggi per un percorso

L'esempio seguente utilizza il metodo computeRoutes per restituire informazioni sui pedaggi con un prezzo stimato quando viene utilizzato un pass per pedaggi.

Specifica il tipo di veicolo e il tipo di pedaggio utilizzando il campo routeModifiers della richiesta. Il prezzo del pedaggio restituito si basa sul prezzo utilizzato dal tipo di veicolo e dal pass specificati. Se vengono specificati più pass, viene restituito il prezzo meno costoso.

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",
  "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).

Per configurare il metodo per restituire le informazioni sul pedaggio, utilizza la maschera del campo di risposta. Imposta il campo routes.travelAdvisory.tollInfo per restituire informazioni sull'intero percorso e routes.legs.travelAdvisory.tollInfo per restituire informazioni per ogni tratto.

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

Calcola le tariffe per i pedaggi di una matrice di percorsi

L'esempio seguente utilizza il metodo computeRouteMatrix per restituire informazioni sui pedaggi lungo un percorso con un prezzo stimato quando viene utilizzato un pedaggio.

Richiesta di informazioni sui pedaggi delle matrici dei percorsi

curl -X POST -d '{
"origins": [
  {
    "waypoint": {
      "location": {
        "latLng": {
          "latitude":42.340173523716736,
          "longitude":-71.05997968330408
        }
      }
    },
    "routeModifiers": {
      "vehicleInfo":{
        "emissionType": "GASOLINE"
      },
      "tollPasses": [
        "US_MA_EZPASSMA",
        "US_WA_GOOD_TO_GO"
      ]
    }
  }
],
"destinations": [
  {
    "waypoint": {
      "location": {
        "latLng": {
          "latitude":42.075698891472804,
          "longitude": -72.59806562080408
        }
      }
    }
  }
],
"travelMode": "DRIVE",
"routingPreference": "TRAFFIC_AWARE"
}'
-H 'Content-Type: application/json'
-H 'X-Goog-Api-Key: YOUR_API_KEY'
-H 'X-Goog-FieldMask: originIndex,destinationIndex,travel_advisory.tollInfo,duration,distanceMeters,status' 'https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix'

Risposta per informazioni sul pedaggio della matrice dei percorsi

La risposta contiene informazioni sui pedaggi in un oggetto TollInfo (REST) o TollInfo (gRPC).

Per configurare il metodo per restituire le informazioni sul pedaggio, utilizza la maschera del campo di risposta per impostare il campo travelAdvisory.tollInfo nella maschera.

[
  {
    "originIndex": 0,
    "destinationIndex": 0,
    "status": {},
    "distanceMeters": 150338,
    "duration": "5382s",
    "travelAdvisory": {
      "tollInfo": {
        "estimatedPrice": [
          {
            "currencyCode": "USD",
            "units": "4",
            "nanos": 400000000
           }
        ]
      }
    }
  }
]

Località dei pedaggi supportate

Al momento, le informazioni sui pedaggi sono disponibili per le seguenti località:

Codice regione	Paese/regione	Stato/città/Strada a pedaggio
AR	Argentina	Buenos Aires
AU	Australia	Brisbane
AU	Australia	Sydney
BR	Brasile	A livello nazionale
ID	Indonesia	A livello nazionale
IN	India	A livello nazionale
MX	Messico	Città del Messico
IT	Stati Uniti	Alabama
IT	Stati Uniti	Alaska
IT	Stati Uniti	California
IT	Stati Uniti	Colorado
IT	Stati Uniti	Delaware
IT	Stati Uniti	Florida
IT	Stati Uniti	Illinois
IT	Stati Uniti	Iowa
IT	Stati Uniti	Indiana
IT	Stati Uniti	Kansas
IT	Stati Uniti	Louisiana
IT	Stati Uniti	Maine
IT	Stati Uniti	Maryland
IT	Stati Uniti	Massachusetts
IT	Stati Uniti	Michigan
IT	Stati Uniti	Minnesota
IT	Stati Uniti	Missouri
IT	Stati Uniti	New Hampshire
IT	Stati Uniti	New Jersey
IT	Stati Uniti	New York
IT	Stati Uniti	Carolina del Nord
IT	Stati Uniti	Ohio
IT	Stati Uniti	Pennsylvania
IT	Stati Uniti	Rhode Island
IT	Stati Uniti	Carolina del Sud
IT	Stati Uniti	Texas
IT	Stati Uniti	Utah
IT	Stati Uniti	Virginia
IT	Stati Uniti	Washington
IT	Stati Uniti	West Virginia

Queste informazioni verranno aggiornate man mano che saranno disponibili altri dati dei pedaggi.