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
comeRouteModifier
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.
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 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.