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

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
Stati Uniti Stati Uniti Alabama
Stati Uniti Stati Uniti Alaska
Stati Uniti Stati Uniti California
Stati Uniti Stati Uniti Colorado
Stati Uniti Stati Uniti Delaware
Stati Uniti Stati Uniti Florida
Stati Uniti Stati Uniti Illinois
Stati Uniti Stati Uniti Iowa
Stati Uniti Stati Uniti Indiana
Stati Uniti Stati Uniti Kansas
Stati Uniti Stati Uniti Louisiana
Stati Uniti Stati Uniti Maine
Stati Uniti Stati Uniti Maryland
Stati Uniti Stati Uniti Massachusetts
Stati Uniti Stati Uniti Michigan
Stati Uniti Stati Uniti Minnesota
Stati Uniti Stati Uniti Missouri
Stati Uniti Stati Uniti New Hampshire
Stati Uniti Stati Uniti New Jersey
Stati Uniti Stati Uniti New York
Stati Uniti Stati Uniti Carolina del Nord
Stati Uniti Stati Uniti Ohio
Stati Uniti Stati Uniti Pennsylvania
Stati Uniti Stati Uniti Rhode Island
Stati Uniti Stati Uniti Carolina del Sud
Stati Uniti Stati Uniti Texas
Stati Uniti Stati Uniti Utah
Stati Uniti Stati Uniti Virginia
Stati Uniti Stati Uniti Washington
Stati Uniti Stati Uniti West Virginia

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