L'API Routes è attualmente in anteprima (pre-GA). I prodotti e le funzionalità pre-GA potrebbero avere supporto limitato e le modifiche ai prodotti e alle funzionalità pre-GA potrebbero non essere compatibili con altre versioni pre-GA. Le Offerte pre-GA sono coperte dai Termini di servizio specifici per Google Maps Platform. Per ulteriori informazioni, consulta le descrizioni delle fasi di lancio.

Calcola le tariffe

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

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.

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 regionePaese/regioneStato/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.