Package google.maps.routing.v2

Indice

Route

API Routes.

ComputeRouteMatrix

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)

Accetta un elenco di origini e destinazioni e restituisce uno stream contenente informazioni sul percorso per ogni combinazione di origine e destinazione.

NOTA:questo metodo richiede di specificare una maschera del campo di risposta nell'input. Puoi fornire la maschera del campo di risposta utilizzando il parametro URL $fields o fields oppure l'intestazione HTTP/gRPC X-Goog-FieldMask (consulta i parametri URL e le intestazioni disponibili). Il valore è un elenco separato da virgole di percorsi dei campi. Consulta questa documentazione dettagliata su come creare i percorsi dei campi.

Ad esempio, in questo metodo:

  • Maschera del campo di tutti i campi disponibili (per l'ispezione manuale): X-Goog-FieldMask: *
  • Maschera del campo di durate, distanze, stato dell'elemento, condizione e indici dell'elemento dell'itinerario (un esempio di configurazione di produzione): X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration

È fondamentale includere status nella maschera del campo, altrimenti tutti i messaggi sembreranno OK. Google sconsiglia l'utilizzo della maschera del campo di risposta con carattere jolly (*) perché:

  • Se selezioni solo i campi di cui hai bisogno, il nostro server risparmia cicli di calcolo, il che ci consente di restituirti il risultato con una latenza inferiore.
  • Selezionando solo i campi necessari nel job di produzione, si garantisce una latenza stabile. In futuro potremmo aggiungere altri campi di risposta e questi nuovi campi potrebbero richiedere più tempo di calcolo. Se selezioni tutti i campi o tutti i campi a livello principale, potresti notare un peggioramento del rendimento perché qualsiasi nuovo campo che aggiungiamo verrà incluso automaticamente nella risposta.
  • Se selezioni solo i campi di cui hai bisogno, le dimensioni della risposta saranno inferiori e il throughput di rete sarà maggiore.
ComputeRoutes

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)

Restituisce la route principale insieme alle route alternative facoltative, dato un insieme di tappe intermedie e terminali.

NOTA:questo metodo richiede di specificare una maschera del campo di risposta nell'input. Puoi fornire la maschera del campo di risposta utilizzando il parametro URL $fields o fields oppure utilizzando un'intestazione HTTP/gRPC X-Goog-FieldMask (vedi i parametri URL e le intestazioni disponibili). Il valore è un elenco separato da virgole di percorsi dei campi. Consulta la documentazione dettagliata su come creare i percorsi dei campi.

Ad esempio, in questo metodo:

  • Maschera del campo di tutti i campi disponibili (per l'ispezione manuale): X-Goog-FieldMask: *
  • Maschera del campo di durata, distanza e polilinea a livello di percorso (un esempio di configurazione di produzione): X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline

Google sconsiglia l'utilizzo della maschera per il campo di risposta con carattere jolly (*) o la specifica della maschera per il campo a livello principale (routes) perché:

  • Se selezioni solo i campi di cui hai bisogno, il nostro server risparmia cicli di calcolo, il che ci consente di restituirti il risultato con una latenza inferiore.
  • Selezionando solo i campi necessari nel job di produzione, si garantisce una latenza stabile. In futuro potremmo aggiungere altri campi di risposta e questi nuovi campi potrebbero richiedere più tempo di calcolo. Se selezioni tutti i campi o tutti i campi a livello principale, potresti notare un peggioramento del rendimento perché qualsiasi nuovo campo che aggiungiamo verrà incluso automaticamente nella risposta.
  • Se selezioni solo i campi di cui hai bisogno, le dimensioni della risposta saranno inferiori e il throughput di rete sarà maggiore.

ComputeRouteMatrixRequest

Messaggio di richiesta ComputeRouteMatrix

Campi
origins[]

RouteMatrixOrigin

Obbligatorio. Array di origini, che determina le righe della matrice di risposta. Alla cardinalità di origini e destinazioni si applicano diverse limitazioni di dimensioni:

  • La somma del numero di origini e del numero di destinazioni specificate come place_id o address non deve essere superiore a 50.
  • Il prodotto del numero di origini × il numero di destinazioni non deve essere superiore a 625 in nessun caso.
  • Il prodotto del numero di origini × numero di destinazioni non deve essere superiore a 100 se routing_preference è impostato su TRAFFIC_AWARE_OPTIMAL.
  • Il prodotto del numero di origini × numero di destinazioni non deve essere superiore a 100 se travel_mode è impostato su TRANSIT.
destinations[]

RouteMatrixDestination

Obbligatorio. Array di destinazioni, che determina le colonne della matrice di risposta.
travel_mode

RouteTravelMode

(Facoltativo) Specifica la modalità di trasporto.
routing_preference

RoutingPreference

(Facoltativo) Specifica come calcolare l'itinerario. Il server tenta di utilizzare la preferenza di routing selezionata per calcolare l'itinerario. Se la preferenza di routing genera un errore o una latenza molto lunga, viene restituito un errore. Puoi specificare questa opzione solo quando travel_mode è DRIVE o TWO_WHEELER, altrimenti la richiesta non va a buon fine.
departure_time

Timestamp

(Facoltativo) L'orario di partenza. Se non imposti questo valore, il valore predefinito è l'ora in cui hai effettuato la richiesta. NOTA: puoi specificare una departure_time nel passato solo quando RouteTravelMode è impostato su TRANSIT.
arrival_time

Timestamp

(Facoltativo) L'ora di arrivo. NOTA: può essere impostato solo quando RouteTravelMode è impostato su TRANSIT. Puoi specificare departure_time o arrival_time, ma non entrambi.
language_code

string

(Facoltativo) Il codice lingua BCP-47, ad esempio "en-US" o "sr-Latn". Per ulteriori informazioni, consulta Identificatore di località Unicode. Consulta la sezione Supporto delle lingue per l'elenco delle lingue supportate. Se non fornisci questo valore, la lingua di visualizzazione viene dedotta dalla posizione della prima origine.
region_code

string

(Facoltativo) Il codice regione, specificato come valore di due caratteri ccTLD ("dominio di primo livello"). Per ulteriori informazioni, vedi Domini di primo livello nazionali.
units

Units

(Facoltativo) Specifica le unità di misura per i campi di visualizzazione.
extra_computations[]

ExtraComputation

(Facoltativo) Un elenco di calcoli aggiuntivi che possono essere utilizzati per completare la richiesta. Nota: questi calcoli aggiuntivi potrebbero restituire campi aggiuntivi nella risposta. Questi campi aggiuntivi devono essere specificati anche nella maschera del campo per essere restituiti nella risposta.
traffic_model

TrafficModel

(Facoltativo) Specifica i presupposti da utilizzare per il calcolo del tempo nel traffico. Questa impostazione influisce sul valore restituito nel campo della durata in RouteMatrixElement, che contiene il tempo previsto nel traffico in base alle medie storiche. TrafficModel è disponibile solo per le richieste in cui RoutingPreference è impostato su TRAFFIC_AWARE_OPTIMAL e RouteTravelMode su DRIVE. Se viene richiesto il traffico e TrafficModel non è specificato, il valore predefinito è BEST_GUESS.
transit_preferences

TransitPreferences

(Facoltativo) Specifica le preferenze che influenzano il percorso restituito per i percorsi TRANSIT. NOTA: puoi specificare un solo transit_preferences quando RouteTravelMode è impostato su TRANSIT.

ExtraComputation

Calcoli aggiuntivi da eseguire durante il completamento della richiesta.

Enum
EXTRA_COMPUTATION_UNSPECIFIED Non utilizzato. Le richieste contenenti questo valore non andranno a buon fine.
TOLLS Informazioni sul pedaggio per gli elementi della matrice.

ComputeRoutesRequest

Messaggio di richiesta ComputeRoutes.

Campi
origin

Waypoint

Obbligatorio. Tappa di partenza.
destination

Waypoint

Obbligatorio. Waypoint di destinazione.
intermediates[]

Waypoint

(Facoltativo) Un insieme di tappe lungo il percorso (esclusi i punti terminali), in cui fermarsi o passare. Sono supportate fino a 25 tappe intermedie.
travel_mode

RouteTravelMode

(Facoltativo) Specifica la modalità di trasporto.
routing_preference

RoutingPreference

(Facoltativo) Specifica come calcolare l'itinerario. Il server tenta di utilizzare la preferenza di routing selezionata per calcolare l'itinerario. Se la preferenza di routing genera un errore o una latenza molto lunga, viene restituito un errore. Puoi specificare questa opzione solo quando travel_mode è DRIVE o TWO_WHEELER, altrimenti la richiesta non va a buon fine.
polyline_quality

PolylineQuality

(Facoltativo) Specifica la tua preferenza per la qualità della polilinea.
polyline_encoding

PolylineEncoding

(Facoltativo) Specifica la codifica preferita per la polilinea.
departure_time

Timestamp

(Facoltativo) L'orario di partenza. Se non imposti questo valore, il valore predefinito è l'ora in cui hai effettuato la richiesta. NOTA: puoi specificare una departure_time nel passato solo quando RouteTravelMode è impostato su TRANSIT. I viaggi con il trasporto pubblico sono disponibili fino a 7 giorni nel passato o 100 giorni nel futuro.
arrival_time

Timestamp

(Facoltativo) L'ora di arrivo. NOTA: questo campo viene ignorato quando le richieste specificano un RouteTravelMode diverso da TRANSIT. Puoi specificare departure_time o arrival_time, ma non entrambi. I viaggi con il trasporto pubblico sono disponibili fino a 7 giorni nel passato o 100 giorni nel futuro.
compute_alternative_routes

bool

(Facoltativo) Specifica se calcolare percorsi alternativi oltre al percorso. Non vengono restituiti percorsi alternativi per le richieste con waypoint intermedi.
route_modifiers

RouteModifiers

(Facoltativo) Un insieme di condizioni da soddisfare che influiscono sul modo in cui vengono calcolati i percorsi.
language_code

string

(Facoltativo) Il codice lingua BCP-47, ad esempio "en-US" o "sr-Latn". Per ulteriori informazioni, consulta Identificatore di località Unicode. Consulta la sezione Supporto delle lingue per l'elenco delle lingue supportate. Se non fornisci questo valore, la lingua di visualizzazione viene dedotta dalla posizione della richiesta di percorso.
region_code

string

(Facoltativo) Il codice regione, specificato come valore di due caratteri ccTLD ("dominio di primo livello"). Per ulteriori informazioni, vedi Domini di primo livello nazionali.
units

Units

(Facoltativo) Specifica le unità di misura per i campi di visualizzazione. Questi campi includono il campo instruction in NavigationInstruction. Le unità di misura utilizzate per il percorso, la tappa, la distanza del passo e la durata non sono interessate da questo valore. Se non fornisci questo valore, le unità di visualizzazione vengono dedotte dalla posizione della prima origine.
optimize_waypoint_order

bool

(Facoltativo) Se impostato su true, il servizio tenta di ridurre al minimo il costo complessivo del percorso riordinando i waypoint intermedi specificati. La richiesta non va a buon fine se uno dei waypoint intermedi è un waypoint via. Usa ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index per trovare il nuovo ordine. Se ComputeRoutesResponseroutes.optimized_intermediate_waypoint_index non viene richiesto nell'intestazione X-Goog-FieldMask, la richiesta non va a buon fine. Se optimize_waypoint_order è impostato su false, ComputeRoutesResponse.optimized_intermediate_waypoint_index sarà vuoto.
requested_reference_routes[]

ReferenceRoute

(Facoltativo) Specifica quali route di riferimento calcolare nell'ambito della richiesta oltre alla route predefinita. Una route di riferimento è una route con un obiettivo di calcolo diverso da quello predefinito. Ad esempio, il calcolo di un percorso di riferimento FUEL_EFFICIENT tiene conto di vari parametri che generano un percorso ottimale per il risparmio di carburante. Quando utilizzi questa funzionalità, cerca route_labels nei percorsi risultanti.
extra_computations[]

ExtraComputation

(Facoltativo) Un elenco di calcoli aggiuntivi che possono essere utilizzati per completare la richiesta. Nota: questi calcoli aggiuntivi potrebbero restituire campi aggiuntivi nella risposta. Questi campi aggiuntivi devono essere specificati anche nella maschera del campo per essere restituiti nella risposta.
traffic_model

TrafficModel

(Facoltativo) Specifica i presupposti da utilizzare per il calcolo del tempo nel traffico. Questa impostazione influisce sul valore restituito nel campo della durata in Route e RouteLeg, che contiene il tempo previsto nel traffico in base alle medie storiche. TrafficModel è disponibile solo per le richieste in cui RoutingPreference è impostato su TRAFFIC_AWARE_OPTIMAL e RouteTravelMode su DRIVE. Se viene richiesto il traffico e TrafficModel non è specificato, il valore predefinito è BEST_GUESS.
transit_preferences

TransitPreferences

(Facoltativo) Specifica le preferenze che influenzano il percorso restituito per i percorsi TRANSIT. NOTA: puoi specificare un solo transit_preferences quando RouteTravelMode è impostato su TRANSIT.

ExtraComputation

Calcoli aggiuntivi da eseguire durante il completamento della richiesta.

Enum
EXTRA_COMPUTATION_UNSPECIFIED Non utilizzato. Le richieste contenenti questo valore non andranno a buon fine.
TOLLS Informazioni sui pedaggi per il percorso o i percorsi.
FUEL_CONSUMPTION Consumo di carburante stimato per il percorso o i percorsi.
TRAFFIC_ON_POLYLINE Polilinee sensibili al traffico per il percorso o i percorsi.
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS NavigationInstructions presentata come stringa di testo HTML formattata. Questi contenuti devono essere letti così come sono. Sono solo a scopo di visualizzazione. Non analizzarlo in modo programmatico.
FLYOVER_INFO_ON_POLYLINE Informazioni sul sorvolo per le route. Per restituire queste informazioni, è necessario specificare la maschera del campo routes.polyline_details.flyover_info. Al momento, questi dati verranno compilati solo per alcune città metropolitane in India. Questa funzionalità è sperimentale e lo SKU/addebito è soggetto a modifiche.
NARROW_ROAD_INFO_ON_POLYLINE Informazioni sulle strade strette per il percorso o i percorsi. Per restituire queste informazioni, è necessario specificare la maschera del campo routes.polyline_details.narrow_road_info. Al momento, questi dati verranno compilati solo per alcune città metropolitane in India. Questa funzionalità è sperimentale e lo SKU/addebito è soggetto a modifiche.

ReferenceRoute

Un percorso di riferimento supportato in ComputeRoutesRequest.

Enum
REFERENCE_ROUTE_UNSPECIFIED Non utilizzato. Le richieste contenenti questo valore non vanno a buon fine.
FUEL_EFFICIENT Percorso a basso consumo di carburante.
SHORTER_DISTANCE

Percorso con distanza di viaggio più breve. Questa è una funzione sperimentale.

Per le richieste DRIVE, questa funzionalità dà la priorità alla distanza più breve rispetto al comfort di guida. Ad esempio, potrebbe preferire strade locali alle autostrade, prendere strade sterrate, attraversare parcheggi e così via. Questa funzionalità non restituisce manovre che Google Maps sa essere illegali.

Per le richieste BICYCLE e TWO_WHEELER, questa funzionalità restituisce percorsi simili a quelli restituiti quando non specifichi requested_reference_routes.

Questa funzionalità non è compatibile con altre modalità di viaggio, con i punti di passaggio intermedi o con optimize_waypoint_order; tali richieste non andranno a buon fine. Tuttavia, puoi utilizzarlo con qualsiasi routing_preference.

ComputeRoutesResponse

ComputeRoutes il messaggio di risposta.

Campi
routes[]

Route

Contiene un array di percorsi calcolati (fino a tre) quando specifichi compute_alternatives_routes e contiene un solo percorso quando non lo fai. Quando questo array contiene più voci, la prima è la route più consigliata. Se l'array è vuoto, significa che non è stato possibile trovare alcun percorso.
fallback_info

FallbackInfo

In alcuni casi, quando il server non è in grado di calcolare i risultati del percorso con tutte le preferenze di input, potrebbe ricorrere a un metodo di calcolo diverso. Quando viene utilizzata la modalità di riserva, questo campo contiene informazioni dettagliate sulla risposta di riserva. In caso contrario, questo campo non è impostato.
geocoding_results

GeocodingResults

Contiene informazioni sulla risposta di geocodifica per i waypoint specificati come indirizzi.

FallbackInfo

Informazioni relative a come e perché è stato utilizzato un risultato di riserva. Se questo campo è impostato, significa che il server ha utilizzato una modalità di routing diversa da quella preferita come fallback.

Campi
routing_mode

FallbackRoutingMode

Modalità di routing utilizzata per la risposta. Se è stato attivato il fallback, la modalità potrebbe essere diversa dalla preferenza di routing impostata nella richiesta client originale.
reason

FallbackReason

Il motivo per cui è stata utilizzata la risposta di riserva anziché quella originale. Questo campo viene compilato solo quando viene attivata la modalità di riserva e viene restituita la risposta di riserva.

FallbackReason

Motivi per l'utilizzo della risposta di riserva.

Enum
FALLBACK_REASON_UNSPECIFIED Nessun motivo di fallback specificato.
SERVER_ERROR Si è verificato un errore del server durante il calcolo dei percorsi con la modalità di routing preferita, ma siamo riusciti a restituire un risultato calcolato con una modalità alternativa.
LATENCY_EXCEEDED Non siamo riusciti a completare il calcolo con la modalità di itinerario che preferisci in tempo, ma siamo riusciti a restituire un risultato calcolato con una modalità alternativa.

FallbackRoutingMode

Modalità di routing effettiva utilizzata per la risposta di riserva restituita.

Enum
FALLBACK_ROUTING_MODE_UNSPECIFIED Non utilizzato.
FALLBACK_TRAFFIC_UNAWARE Indica che è stato utilizzato TRAFFIC_UNAWARE RoutingPreference per calcolare la risposta.
FALLBACK_TRAFFIC_AWARE Indica che è stato utilizzato TRAFFIC_AWARE RoutingPreference per calcolare la risposta.

GeocodedWaypoint

Dettagli sulle località utilizzate come tappe intermedie. Compilato solo per i waypoint degli indirizzi. Include dettagli sui risultati del geocoding per determinare a cosa è stato codificato l'indirizzo.

Campi
geocoder_status

Status

Indica il codice di stato risultante dall'operazione di geocodifica.
type[]

string

Il tipo o i tipi di risultato, sotto forma di zero o più tag di tipo. Tipi supportati: tipi di indirizzi e tipi di componenti di indirizzi.
partial_match

bool

Indica che il geocoder non ha restituito una corrispondenza esatta per la richiesta originale, anche se è riuscito a trovare una corrispondenza per parte dell'indirizzo richiesto. Ti consigliamo di esaminare la richiesta originale per verificare la presenza di errori ortografici e/o di un indirizzo incompleto.
place_id

string

L'ID luogo per questo risultato.
intermediate_waypoint_request_index

int32

L'indice della tappa intermedia corrispondente nella richiesta. Compilato solo se il waypoint corrispondente è un waypoint intermedio.

GeocodingResults

Contiene GeocodedWaypoints per l'origine, la destinazione e i waypoint intermedi. Compilato solo per i waypoint degli indirizzi.

Campi
origin

GeocodedWaypoint

Waypoint di origine geocodificato.
destination

GeocodedWaypoint

Waypoint geocodificato di destinazione.
intermediates[]

GeocodedWaypoint

Un elenco di waypoint geocodificati intermedi, ognuno contenente un campo indice che corrisponde alla posizione in base zero del waypoint nell'ordine in cui sono stati specificati nella richiesta.

LocalizedTime

Descrizione localizzata dell'ora.

Campi
time

LocalizedText

L'ora specificata come stringa in un determinato fuso orario.
time_zone

string

Contiene il fuso orario. Il valore è il nome del fuso orario definito nel database dei fusi orari IANA, ad es. "America/New_York".

Località

Contiene una posizione (un punto geografico e un'intestazione facoltativa).

Campi
lat_lng

LatLng

Le coordinate geografiche del waypoint.
heading

Int32Value

L'orientamento della bussola associato alla direzione del flusso del traffico. Questo valore specifica il lato della strada per il ritiro e la riconsegna. I valori di direzione possono essere compresi tra 0 e 360, dove 0 specifica una direzione verso nord, 90 specifica una direzione verso est e così via. Puoi utilizzare questo campo solo per DRIVE e TWO_WHEELER RouteTravelMode.

Maneuver

Un insieme di valori che specificano l'azione di navigazione da intraprendere per il passaggio corrente (ad esempio, svolta a sinistra, unione o dritto).

Enum
MANEUVER_UNSPECIFIED Non utilizzato.
TURN_SLIGHT_LEFT Girala leggermente verso sinistra.
TURN_SHARP_LEFT Svolta bruscamente a sinistra.
UTURN_LEFT Fai un'inversione a U a sinistra.
TURN_LEFT Svolta a sinistra.
TURN_SLIGHT_RIGHT Svolta leggermente a destra.
TURN_SHARP_RIGHT Svolta bruscamente a destra.
UTURN_RIGHT Fai un'inversione a U a destra.
TURN_RIGHT Svolta a destra.
STRAIGHT Vai dritto.
RAMP_LEFT Prendi lo svincolo a sinistra.
RAMP_RIGHT Prendi lo svincolo a destra.
MERGE Immettersi nel traffico.
FORK_LEFT Prendi la strada a sinistra.
FORK_RIGHT Prendi la strada a destra.
FERRY Prendi il traghetto.
FERRY_TRAIN Prendi il treno che porta al traghetto.
ROUNDABOUT_LEFT Svolta a sinistra alla rotatoria.
ROUNDABOUT_RIGHT Svolta a destra alla rotatoria.
DEPART Manovra iniziale.
NAME_CHANGE Utilizzato per indicare una modifica del nome della via.

Contiene le istruzioni di navigazione per un RouteLegStep.

Campi
maneuver

Maneuver

Contiene le istruzioni di navigazione per il passaggio corrente (ad esempio, svolta a sinistra, immettersi o dritto). Questo campo determina quale icona visualizzare.
instructions

string

Istruzioni per eseguire questo passaggio.

Polilinea

Incapsula una polilinea codificata.

Campi
Campo unione polyline_type. Contiene il tipo di polilinea. Il valore predefinito è encoded_polyline. polyline_type può essere solo uno dei seguenti:
encoded_polyline

string

La codifica della stringa della polilinea utilizzando l'algoritmo di codifica della polilinea
geo_json_linestring

Struct

Specifica una polilinea utilizzando il formato LineString GeoJSON.

PolylineDetails

Dettagli corrispondenti a un determinato indice o segmento contiguo di una polilinea. Data una polilinea con punti P_0, P_1, ... , P_N (indice basato su zero), PolylineDetails definisce un intervallo e i metadati associati.

Campi
flyover_info[]

FlyoverInfo

Dettagli del sorvolo lungo la polilinea.
narrow_road_info[]

NarrowRoadInfo

Dettagli della strada stretta lungo la polilinea.

FlyoverInfo

Contiene informazioni sui sorvoli lungo la polilinea.

Campi
flyover_presence

RoadFeatureState

Solo output. Indica se esiste un sorvolo per un determinato tratto della polilinea.
polyline_point_index

PolylinePointIndex

La posizione delle informazioni relative al sorvolo lungo la polilinea.

NarrowRoadInfo

Contiene informazioni sulle strade strette lungo la polilinea.

Campi
narrow_road_presence

RoadFeatureState

Solo output. Indica se esiste una strada stretta per un determinato tratto della polilinea.
polyline_point_index

PolylinePointIndex

La posizione delle informazioni relative alla strada stretta lungo la polilinea.

PolylinePointIndex

Contiene gli indici di inizio e fine per un dettaglio della polilinea. Per le istanze in cui i dati corrispondono a un singolo punto, start_index e end_index saranno uguali.

Campi
start_index

int32

L'indice iniziale di questo dettaglio nella polilinea.
end_index

int32

L'indice finale di questo dettaglio nella polilinea.

RoadFeatureState

Contiene gli stati degli elementi stradali lungo un tratto di polilinea.

Enum
ROAD_FEATURE_STATE_UNSPECIFIED Lo stato della funzionalità stradale non è stato calcolato (valore predefinito).
EXISTS L'elemento stradale esiste.
DOES_NOT_EXIST La funzionalità relativa alla strada non esiste.

PolylineEncoding

Specifica il tipo di polilinea preferito da restituire.

Enum
POLYLINE_ENCODING_UNSPECIFIED Nessuna preferenza per il tipo di polilinea specificata. Il valore predefinito è ENCODED_POLYLINE.
ENCODED_POLYLINE Specifica una polilinea codificata utilizzando l'algoritmo di codifica polilinea.
GEO_JSON_LINESTRING Specifica una polilinea utilizzando il formato LineString GeoJSON

PolylineQuality

Un insieme di valori che specificano la qualità della polilinea.

Enum
POLYLINE_QUALITY_UNSPECIFIED Nessuna preferenza di qualità della polilinea specificata. Il valore predefinito è OVERVIEW.
HIGH_QUALITY Specifica una polilinea di alta qualità, composta da più punti di OVERVIEW, a costo di una maggiore dimensione della risposta. Utilizza questo valore quando hai bisogno di maggiore precisione.
OVERVIEW Specifica una polilinea di panoramica, composta da un numero ridotto di punti. Utilizza questo valore quando visualizzi una panoramica dell'itinerario. L'utilizzo di questa opzione ha una latenza delle richieste inferiore rispetto all'utilizzo dell'opzione HIGH_QUALITY.

Route

Contiene un percorso, costituito da una serie di segmenti stradali collegati che uniscono i waypoint iniziali, finali e intermedi.

Campi
route_labels[]

RouteLabel

Etichette per Route utili per identificare proprietà specifiche dell'itinerario da confrontare con altre.
legs[]

RouteLeg

Un insieme di tratte (segmenti di percorso tra i waypoint) che compongono l'itinerario. Ogni tratta corrisponde al viaggio tra due via Waypoints. Ad esempio, un percorso senza tappe intermedie ha una sola tratta. Un percorso che include un waypoint intermedio non via ha due tappe. Un itinerario che include un waypoint intermedio via ha una tappa. L'ordine delle tappe corrisponde all'ordine dei waypoint da origin a intermediates a destination.
distance_meters

int32

La distanza di percorrenza dell'itinerario, in metri.
duration

Duration

Il tempo necessario per percorrere l'itinerario. Se imposti routing_preference su TRAFFIC_UNAWARE, questo valore è uguale a static_duration. Se imposti routing_preference su TRAFFIC_AWARE o TRAFFIC_AWARE_OPTIMAL, questo valore viene calcolato tenendo conto delle condizioni del traffico.
static_duration

Duration

La durata del viaggio lungo l'itinerario senza prendere in considerazione le condizioni del traffico.
polyline

Polyline

La polilinea dell'intero percorso. Questa polilinea è la polilinea combinata di tutti i legs.
description

string

Una descrizione dell'itinerario.
warnings[]

string

Un array di avvisi da mostrare durante la visualizzazione del percorso.
viewport

Viewport

Il riquadro di delimitazione dell'area visibile della polilinea.
travel_advisory

RouteTravelAdvisory

Informazioni aggiuntive sull'itinerario.
optimized_intermediate_waypoint_index[]

int32

Se imposti optimize_waypoint_order su true, questo campo contiene l'ordine ottimizzato dei waypoint intermedi. In caso contrario, questo campo è vuoto. Ad esempio, se inserisci Origine: Los Angeles; Punti di controllo intermedi: Dallas, Bangor, Phoenix; Destinazione: New York; e l'ordine ottimizzato dei punti di controllo intermedi è Phoenix, Dallas, Bangor, questo campo contiene i valori [2, 0, 1]. L'indice inizia con 0 per il primo waypoint intermedio fornito nell'input.
localized_values

RouteLocalizedValues

Rappresentazioni testuali delle proprietà di Route.
route_token

string

Un token opaco che può essere passato all'SDK di navigazione per ricostruire l'itinerario durante la navigazione e, in caso di ricalcolo dell'itinerario, rispettare l'intenzione originale al momento della creazione dell'itinerario. Considera questo token come un blob opaco. Non confrontare il suo valore tra le richieste, in quanto potrebbe cambiare anche se il servizio restituisce esattamente lo stesso percorso.

NOTA: Route.route_token è disponibile solo per le richieste in cui ComputeRoutesRequest.routing_preference è impostato su TRAFFIC_AWARE o TRAFFIC_AWARE_OPTIMAL. Route.route_token non è supportato per le richieste che hanno punti di passaggio intermedi.
polyline_details

PolylineDetails

Contiene informazioni sui dettagli lungo la polilinea.

RouteLocalizedValues

Rappresentazioni testuali di determinate proprietà.

Campi
distance

LocalizedText

Distanza percorsa rappresentata in formato di testo.
duration

LocalizedText

Durata, rappresentata in formato di testo e localizzata nella regione della query. Prende in considerazione le condizioni del traffico. Nota: se non hai richiesto informazioni sul traffico, questo valore è uguale a static_duration.
static_duration

LocalizedText

Durata senza tenere conto delle condizioni del traffico, rappresentata in formato di testo.
transit_fare

LocalizedText

Tariffa del trasporto pubblico rappresentata in formato testo.

RouteLabel

Etichette per Route utili per identificare proprietà specifiche dell'itinerario da confrontare con altre.

Enum
ROUTE_LABEL_UNSPECIFIED Predefinito: non utilizzato.
DEFAULT_ROUTE Il percorso "migliore" predefinito restituito per il calcolo del percorso.
DEFAULT_ROUTE_ALTERNATE Un'alternativa al percorso "migliore" predefinito. I percorsi come questo verranno restituiti quando viene specificato compute_alternative_routes.
FUEL_EFFICIENT Percorso a basso consumo di carburante. I percorsi etichettati con questo valore sono considerati ottimizzati per i parametri Eco, come il consumo di carburante.
SHORTER_DISTANCE Percorso con distanza di viaggio più breve. Questa è una funzione sperimentale.

RouteLeg

Contiene un segmento tra i waypoint non via.

Campi
distance_meters

int32

La distanza di percorrenza della tratta dell'itinerario, in metri.
duration

Duration

Il tempo necessario per percorrere la tratta. Se route_preference è impostato su TRAFFIC_UNAWARE, questo valore è uguale a static_duration. Se route_preference è TRAFFIC_AWARE o TRAFFIC_AWARE_OPTIMAL, questo valore viene calcolato tenendo conto delle condizioni del traffico.
static_duration

Duration

La durata del viaggio attraverso la tratta, calcolata senza tenere conto delle condizioni del traffico.
polyline

Polyline

La polilinea complessiva di questa tratta che include la polilinea di ogni step.
start_location

Location

La posizione di partenza di questa tappa. Questa posizione potrebbe essere diversa da quella fornita per origin. Ad esempio, quando il origin fornito non si trova vicino a una strada, si tratta di un punto sulla strada.
end_location

Location

La posizione finale di questa tratta. Questa posizione potrebbe essere diversa da quella fornita per destination. Ad esempio, quando il destination fornito non si trova vicino a una strada, si tratta di un punto sulla strada.
steps[]

RouteLegStep

Un array di passaggi che indicano i segmenti all'interno di questa tratta. Ogni passaggio rappresenta un'istruzione di navigazione.
travel_advisory

RouteLegTravelAdvisory

Contiene le informazioni aggiuntive di cui l'utente deve essere informato, ad esempio le possibili limitazioni della zona di traffico, in una tratta del percorso.
localized_values

RouteLegLocalizedValues

Rappresentazioni testuali delle proprietà di RouteLeg.
steps_overview

StepsOverview

Informazioni generali sui passaggi di questo RouteLeg. Questo campo viene compilato solo per i percorsi TRANSIT.

RouteLegLocalizedValues

Rappresentazioni testuali di determinate proprietà.

Campi
distance

LocalizedText

Distanza percorsa rappresentata in formato di testo.
duration

LocalizedText

Durata, rappresentata in formato di testo e localizzata nella regione della query. Prende in considerazione le condizioni del traffico. Nota: se non hai richiesto informazioni sul traffico, questo valore è uguale a static_duration.
static_duration

LocalizedText

Durata senza tenere conto delle condizioni del traffico, rappresentata in formato di testo.

StepsOverview

Fornisce informazioni di riepilogo su un elenco di RouteLegStep.

Campi
multi_modal_segments[]

MultiModalSegment

Informazioni riepilogative sui diversi segmenti multimodali di RouteLeg.steps. Questo campo non viene compilato se RouteLeg non contiene segmenti multimodali nei passaggi.

MultiModalSegment

Fornisce informazioni riepilogative sui diversi segmenti multimodali di RouteLeg.steps. Un segmento multimodale è definito come uno o più RouteLegStep contigui che hanno lo stesso RouteTravelMode. Questo campo non viene compilato se RouteLeg non contiene segmenti multimodali nei passaggi.

Campi
navigation_instruction

NavigationInstruction

NavigationInstruction per il segmento multimodale.
travel_mode

RouteTravelMode

La modalità di viaggio del segmento multimodale.
step_start_index

int32

L'indice RouteLegStep corrispondente che è l'inizio di un segmento multimodale.
step_end_index

int32

L'indice RouteLegStep corrispondente che è la fine di un segmento multimodale.

RouteLegStep

Contiene un segmento di un RouteLeg. Un passaggio corrisponde a una singola istruzione di navigazione. Le tappe del percorso sono costituite da passaggi.

Campi
distance_meters

int32

La distanza di spostamento di questo passaggio, in metri. In alcune circostanze, questo campo potrebbe non avere un valore.
static_duration

Duration

La durata del viaggio in questo passaggio senza prendere in considerazione le condizioni del traffico. In alcune circostanze, questo campo potrebbe non avere un valore.
polyline

Polyline

La polilinea associata a questo passaggio.
start_location

Location

La posizione di partenza di questo passaggio.
end_location

Location

La posizione finale di questo passaggio.
navigation_instruction

NavigationInstruction

Istruzioni di navigazione.
travel_advisory

RouteLegStepTravelAdvisory

Contiene le informazioni aggiuntive di cui l'utente deve essere informato, ad esempio possibili limitazioni della zona di traffico, in un passaggio dell'itinerario.
localized_values

RouteLegStepLocalizedValues

Rappresentazioni testuali delle proprietà di RouteLegStep.
transit_details

RouteLegStepTransitDetails

Dettagli relativi a questo passaggio se la modalità di viaggio è TRANSIT.
travel_mode

RouteTravelMode

La modalità di spostamento utilizzata per questo passaggio.

RouteLegStepLocalizedValues

Rappresentazioni testuali di determinate proprietà.

Campi
distance

LocalizedText

Distanza percorsa rappresentata in formato di testo.
static_duration

LocalizedText

Durata senza tenere conto delle condizioni del traffico, rappresentata in formato di testo.

RouteLegStepTransitDetails

Informazioni aggiuntive per RouteLegStep relative alle route TRANSIT.

Campi
stop_details

TransitStopDetails

Informazioni sulle fermate di arrivo e partenza del passaggio.
localized_values

TransitDetailsLocalizedValues

Rappresentazioni testuali delle proprietà di RouteLegStepTransitDetails.
headsign

string

Specifica la direzione in cui viaggiare su questa linea, come indicato sul veicolo o alla fermata di partenza. La direzione è spesso la stazione di arrivo.
headway

Duration

Specifica il tempo previsto come durata tra le partenze dalla stessa fermata in questo momento. Ad esempio, con un valore di secondi di intervallo di 600, dovresti aspettarti un'attesa di dieci minuti se dovessi perdere l'autobus.
transit_line

TransitLine

Informazioni sulla linea di trasporto pubblico utilizzata in questo passaggio.
stop_count

int32

Il numero di fermate dalla partenza all'arrivo. Questo conteggio include la fermata di arrivo, ma esclude quella di partenza. Ad esempio, se il tuo percorso parte dalla fermata A, passa per le fermate B e C e arriva alla fermata D,

stop_count

restituisce 3.
trip_short_text

string

Il testo che viene visualizzato negli orari e nei tabelloni per identificare un viaggio con i mezzi pubblici per i passeggeri. Il testo deve identificare in modo univoco una corsa all'interno di un giorno di servizio. Ad esempio, "538" è il trip_short_text del treno Amtrak che parte da San Jose, CA alle 15:10 nei giorni feriali per Sacramento, CA.

TransitDetailsLocalizedValues

Descrizioni localizzate dei valori per RouteTransitDetails.

Campi
arrival_time

LocalizedTime

Ora nella rappresentazione di testo formattata con un fuso orario corrispondente.
departure_time

LocalizedTime

Ora nella rappresentazione di testo formattata con un fuso orario corrispondente.

TransitStopDetails

Dettagli sulle fermate dei trasporti pubblici per RouteLegStep.

Campi
arrival_stop

TransitStop

Informazioni sulla fermata di arrivo del passaggio.
arrival_time

Timestamp

L'orario di arrivo stimato per il passaggio.
departure_stop

TransitStop

Informazioni sulla fermata di partenza per il passaggio.
departure_time

Timestamp

L'orario di partenza stimato per la tappa.

RouteLegStepTravelAdvisory

Contiene le informazioni aggiuntive di cui l'utente deve essere informato, ad esempio possibili limitazioni della zona di traffico in una tappa del percorso.

Campi
speed_reading_intervals[]

SpeedReadingInterval

NOTA: questo campo al momento non viene compilato.

RouteLegTravelAdvisory

Contiene le informazioni aggiuntive che l'utente deve conoscere in un passaggio dell'itinerario, ad esempio le possibili limitazioni della zona di traffico.

Campi
toll_info

TollInfo

Contiene informazioni sui pedaggi sul RouteLeg specifico. Questo campo viene compilato solo se prevediamo che ci siano pedaggi su RouteLeg e TOLLS è incluso in ComputeRoutesRequest.extra_computations della richiesta. Se questo campo è impostato, ma il campo secondario estimated_price non è compilato, prevediamo che la strada contenga pedaggi, ma non conosciamo un prezzo stimato. Se toll_info non esiste, non è presente alcun pedaggio sulla RouteLeg.
speed_reading_intervals[]

SpeedReadingInterval

Intervalli di lettura della velocità che indicano la densità del traffico. Questo campo viene compilato solo per le richieste in cui la richiesta ha un valore TRAFFIC_AWARE o TRAFFIC_AWARE_OPTIMAL ComputeRoutesRequest.routing_preference e TRAFFIC_ON_POLYLINE è incluso in ComputeRoutesRequest.extra_computations. Gli intervalli coprono l'intera polilinea di RouteLeg senza sovrapposizioni. Il punto iniziale di un intervallo specificato coincide con il punto finale dell'intervallo precedente.

Esempio:

polyline: A ---- B ---- C ---- D ---- E ---- F ---- G
speed_reading_intervals: [A,C), [C,D), [D,G).

RouteMatrixDestination

Una singola destinazione per ComputeRouteMatrixRequest

Campi
waypoint

Waypoint

Obbligatorio. Waypoint di destinazione

RouteMatrixElement

Contiene le informazioni sulla route calcolate per una coppia origine/destinazione nell'API ComputeRouteMatrix. Questo proto può essere trasmesso in streaming al client.

Campi
status

Status

Codice di stato di errore per questo elemento.
condition

RouteMatrixElementCondition

Indica se l'itinerario è stato trovato o meno. Indipendente dallo stato.
distance_meters

int32

La distanza di percorrenza dell'itinerario, in metri.
duration

Duration

Il tempo necessario per percorrere l'itinerario. Se imposti routing_preference su TRAFFIC_UNAWARE, questo valore è uguale a static_duration. Se imposti routing_preference su TRAFFIC_AWARE o TRAFFIC_AWARE_OPTIMAL, questo valore viene calcolato tenendo conto delle condizioni del traffico.
static_duration

Duration

La durata del viaggio lungo l'itinerario senza prendere in considerazione le condizioni del traffico.
travel_advisory

RouteTravelAdvisory

Informazioni aggiuntive sull'itinerario. Ad esempio, informazioni sulle limitazioni e informazioni sui pedaggi
fallback_info

FallbackInfo

In alcuni casi, quando il server non è in grado di calcolare l'itinerario con le preferenze specificate per questa particolare coppia origine/destinazione, potrebbe ricorrere a una modalità di calcolo diversa. Quando viene utilizzata la modalità di riserva, questo campo contiene informazioni dettagliate sulla risposta di riserva. In caso contrario, questo campo non è impostato.
localized_values

LocalizedValues

Rappresentazioni testuali delle proprietà di RouteMatrixElement.
origin_index

int32

Indice in base zero dell'origine nella richiesta.
destination_index

int32

Indice in base zero della destinazione nella richiesta.

LocalizedValues

Rappresentazioni testuali di determinate proprietà.

Campi
distance

LocalizedText

Distanza percorsa rappresentata in formato di testo.
duration

LocalizedText

Durata rappresentata in formato di testo che tiene conto delle condizioni del traffico. Nota: se non sono state richieste informazioni sul traffico, questo valore è uguale a static_duration.
static_duration

LocalizedText

Durata rappresentata in formato di testo senza tenere conto delle condizioni del traffico.
transit_fare

LocalizedText

Tariffa del trasporto pubblico rappresentata in formato testo.

RouteMatrixElementCondition

La condizione dell'itinerario restituito.

Enum
ROUTE_MATRIX_ELEMENT_CONDITION_UNSPECIFIED Utilizzato solo quando il status dell'elemento non è OK.
ROUTE_EXISTS È stato trovato un percorso e le informazioni corrispondenti sono state compilate per l'elemento.
ROUTE_NOT_FOUND Nessun percorso trovato. I campi contenenti informazioni sul percorso, come distance_meters o duration, non verranno compilati nell'elemento.

RouteMatrixOrigin

Una singola origine per ComputeRouteMatrixRequest

Campi
waypoint

Waypoint

Obbligatorio. Tappa di partenza
route_modifiers

RouteModifiers

(Facoltativo) Modificatori per ogni percorso che ha questa origine

RouteModifiers

Contiene un insieme di condizioni facoltative da soddisfare durante il calcolo dei percorsi.

Campi
avoid_tolls

bool

Se impostato su true, evita le strade a pedaggio, se ragionevole, dando la preferenza ai percorsi che non le includono. Si applica solo a DRIVE e TWO_WHEELER RouteTravelMode.
avoid_highways

bool

Se impostato su true, evita le autostrade quando è ragionevole, dando la preferenza ai percorsi che non le includono. Si applica solo a DRIVE e TWO_WHEELER RouteTravelMode.
avoid_ferries

bool

Se impostato su true, evita i traghetti, se ragionevole, dando la preferenza ai percorsi che non li includono. Si applica solo a DRIVE eTWO_WHEELER RouteTravelMode.
avoid_indoor

bool

Se impostato su true, evita la navigazione al chiuso, se ragionevole, dando la preferenza ai percorsi che non la includono. Si applica solo a WALK RouteTravelMode.
vehicle_info

VehicleInfo

Specifica le informazioni sul veicolo.
toll_passes[]

TollPass

Contiene informazioni sui pedaggi. Se vengono forniti i pedaggi, l'API tenta di restituire il prezzo del pedaggio. Se i pedaggi non vengono forniti, l'API li considera sconosciuti e tenta di restituire il prezzo in contanti. Si applica solo a DRIVE e TWO_WHEELER RouteTravelMode.

RouteTravelAdvisory

Contiene le informazioni aggiuntive di cui l'utente deve essere informato, ad esempio le possibili limitazioni della zona di traffico.

Campi
toll_info

TollInfo

Contiene informazioni sui pedaggi sul percorso. Questo campo viene compilato solo se sono previsti pedaggi sull'itinerario e TOLLS è incluso in ComputeRoutesRequest.extra_computations della richiesta. Se questo campo è impostato, ma il campo secondario estimatedPrice non è compilato, il percorso contiene pedaggi, ma il prezzo stimato non è noto. Se toll_info non è impostato, non sono previsti pedaggi sul percorso.
speed_reading_intervals[]

SpeedReadingInterval

Intervalli di lettura della velocità che indicano la densità del traffico. Questo campo viene compilato solo per le richieste in cui la richiesta ha un valore TRAFFIC_AWARE o TRAFFIC_AWARE_OPTIMAL ComputeRoutesRequest.routing_preference e TRAFFIC_ON_POLYLINE è incluso in ComputeRoutesRequest.extra_computations. Gli intervalli coprono l'intera polilinea del percorso senza sovrapposizioni. Il punto iniziale di un intervallo specificato coincide con il punto finale dell'intervallo precedente.

Esempio:

polyline: A ---- B ---- C ---- D ---- E ---- F ---- G
speed_reading_intervals: [A,C), [C,D), [D,G).
fuel_consumption_microliters

int64

Il consumo di carburante previsto in microlitri. Questo campo viene compilato solo quando FUEL_CONSUMPTION è incluso in ComputeRoutesRequest.extra_computations della richiesta.
route_restrictions_partially_ignored

bool

L'itinerario restituito potrebbe avere limitazioni non adatte alla modalità di viaggio o ai modificatori di itinerario richiesti.
transit_fare

Money

Se presente, contiene il costo totale della tariffa o del biglietto per questo percorso. Questa proprietà viene restituita solo per le richieste TRANSIT e solo per i percorsi in cui sono disponibili informazioni sulla tariffa per tutti i passaggi del trasporto pubblico.

RouteTravelMode

Un insieme di valori utilizzati per specificare la modalità di viaggio. NOTA: i percorsi WALK, BICYCLE e TWO_WHEELER sono in versione beta e a volte potrebbero non includere marciapiedi, percorsi pedonali o ciclabili ben definiti. Devi mostrare questo avviso all'utente per tutti i percorsi a piedi, in bicicletta e in moto che visualizzi nella tua app.

Enum
TRAVEL_MODE_UNSPECIFIED Nessuna modalità di viaggio specificata. Il valore predefinito è DRIVE.
DRIVE Viaggia in auto.
BICYCLE Viaggia in bicicletta.
WALK Viaggia a piedi.
TWO_WHEELER Veicolo motorizzato a due ruote. Ad esempio, una moto. Tieni presente che questa modalità è diversa dalla modalità di viaggio BICYCLE, che copre la modalità a propulsione umana.
TRANSIT Viaggia con i mezzi di trasporto pubblico, se disponibili.

RoutingPreference

Un insieme di valori che specificano i fattori da prendere in considerazione per il calcolo del percorso.

Enum
ROUTING_PREFERENCE_UNSPECIFIED Nessuna preferenza di routing specificata. Il valore predefinito è TRAFFIC_UNAWARE.
TRAFFIC_UNAWARE Calcola i percorsi senza prendere in considerazione le condizioni del traffico in tempo reale. Adatto quando le condizioni del traffico non sono importanti o non sono applicabili. L'utilizzo di questo valore produce la latenza più bassa. Nota: per RouteTravelMode, DRIVE e TWO_WHEELER, il percorso e la durata scelti si basano sulla rete stradale e sulle condizioni di traffico medie indipendenti dal tempo, non sulle condizioni stradali attuali. Di conseguenza, i percorsi potrebbero includere strade chiuse temporaneamente. I risultati di una determinata richiesta possono variare nel tempo a causa di modifiche alla rete stradale, aggiornamenti delle condizioni medie del traffico e della natura distribuita del servizio. I risultati possono variare anche tra percorsi quasi equivalenti in qualsiasi momento o frequenza.
TRAFFIC_AWARE Calcola i percorsi tenendo conto delle condizioni del traffico in tempo reale. A differenza di TRAFFIC_AWARE_OPTIMAL, alcune ottimizzazioni vengono applicate per ridurre significativamente la latenza.
TRAFFIC_AWARE_OPTIMAL Calcola i percorsi tenendo conto delle condizioni del traffico in tempo reale, senza applicare la maggior parte delle ottimizzazioni del rendimento. L'utilizzo di questo valore produce la latenza più elevata.

SpeedReadingInterval

Indicatore della densità del traffico su un segmento contiguo di una polilinea o di un percorso. Dato un percorso con punti P_0, P_1, ... , P_N (indice basato su zero), SpeedReadingInterval definisce un intervallo e descrive il relativo traffico utilizzando le seguenti categorie.

Campi
start_polyline_point_index

int32

L'indice iniziale di questo intervallo nella polilinea.
end_polyline_point_index

int32

L'indice finale di questo intervallo nella polilinea.
Campo unione speed_type. Il tipo di velocità in questo intervallo. speed_type può essere solo uno dei seguenti:
speed

Speed

Velocità del traffico in questo intervallo.

Velocità

La classificazione della velocità della polilinea in base ai dati sul traffico.

Enum
SPEED_UNSPECIFIED Valore predefinito. Questo valore non viene utilizzato.
NORMAL Velocità normale, nessun ritardo dovuto al traffico.
SLOW Rallentamento rilevato, volume di traffico medio.
TRAFFIC_JAM Ritardi dovuti al traffico.

TollInfo

Contiene informazioni sul pedaggio su un Route o su un RouteLeg.

Campi
estimated_price[]

Money

L'importo monetario dei pedaggi per il Route o il RouteLeg corrispondente. Questo elenco contiene un importo in denaro per ogni valuta che dovrebbe essere addebitata dalle stazioni di pedaggio. In genere, questo elenco contiene un solo elemento per i percorsi con pedaggi in una valuta. Per i viaggi internazionali, questo elenco potrebbe contenere più elementi per riflettere i pedaggi in valute diverse.

TollPass

Elenco dei pedaggi in tutto il mondo che supportiamo.

Enum
TOLL_PASS_UNSPECIFIED Non utilizzato. Se viene utilizzato questo valore, la richiesta non riesce.
AU_ETOLL_TAG Telepedaggio di Sydney. Per ulteriori dettagli, visita la pagina https://www.myetoll.com.au.
AU_EWAY_TAG Telepedaggio di Sydney. Per ulteriori dettagli, visita la pagina https://www.tollpay.com.au.
AU_LINKT Telepedaggio valido in tutta l'Australia. Per ulteriori dettagli, visita la pagina https://www.linkt.com.au/.
AR_TELEPASE Tessera per il pedaggio in Argentina. Per ulteriori dettagli, visita la pagina https://telepase.com.ar
BR_AUTO_EXPRESO Telepedaggio per il Brasile. Per ulteriori dettagli, visita la pagina https://www.autoexpreso.com.
BR_CONECTCAR Telepedaggio per il Brasile. Per ulteriori dettagli, visita la pagina https://conectcar.com.
BR_MOVE_MAIS Telepedaggio per il Brasile. Per ulteriori dettagli, visita la pagina https://movemais.com.
BR_PASSA_RAPIDO Telepedaggio per il Brasile. Per ulteriori dettagli, visita la pagina https://pasorapido.gob.do/.
BR_SEM_PARAR Telepedaggio per il Brasile. Per ulteriori dettagli, visita la pagina https://www.semparar.com.br.
BR_TAGGY Telepedaggio per il Brasile. Per ulteriori dettagli, visita la pagina https://taggy.com.br.
BR_VELOE Telepedaggio per il Brasile. Per ulteriori dettagli, visita la pagina https://veloe.com.br/site/onde-usar.
CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD Attraversamento del confine tra Canada e Stati Uniti.
CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD Attraversamento del confine tra Canada e Stati Uniti.
CA_US_BLUE_WATER_EDGE_PASS Ontario, Canada, al confine con il Michigan, Stati Uniti.
CA_US_CONNEXION Ontario, Canada, al confine con il Michigan, Stati Uniti.
CA_US_NEXUS_CARD Attraversamento del confine tra Canada e Stati Uniti.
ID_E_TOLL Indonesia. Carta elettronica fornita da più banche utilizzata per pagare i pedaggi. Tutte le carte elettroniche tramite le banche vengono addebitate allo stesso modo, quindi è necessario un solo valore enum. Ad es. - Bank Mandiri https://www.bankmandiri.co.id/e-money - BCA https://www.bca.co.id/flazz - BNI https://www.bni.co.id/id-id/ebanking/tapcash
IN_FASTAG India.
IN_LOCAL_HP_PLATE_EXEMPT India, esenzione targa statale HP.
JP_ETC Giappone ETC. Sistema wireless elettronico per la riscossione dei pedaggi. https://www.go-etc.jp/
JP_ETC2 ETC2.0 in Giappone. Nuova versione di ETC con ulteriore sconto e comunicazione bidirezionale tra i dispositivi sui veicoli e le antenne sulla strada. https://www.go-etc.jp/etc2/index.html
MX_IAVE Tessera per i pedaggi in Messico. https://iave.capufe.gob.mx/#/
MX_PASE Messico https://www.pase.com.mx
MX_QUICKPASS Messico https://operadoravial.com/quick-pass/
MX_SISTEMA_TELEPEAJE_CHIHUAHUA http://appsh.chihuahua.gob.mx/transparencia/?doc=/ingresos/TelepeajeFormato4.pdf
MX_TAG_IAVE Messico
MX_TAG_TELEVIA Società di telepedaggio messicana. Uno dei tanti che operano a Città del Messico. Per ulteriori dettagli, visita la pagina https://www.televia.com.mx.
MX_TELEVIA Società di telepedaggio messicana. Una delle tante che operano a Città del Messico. https://www.televia.com.mx
MX_VIAPASS Telepedaggio per il Messico. Per ulteriori dettagli, visita la pagina https://www.viapass.com.mx/viapass/web_home.aspx.
US_AL_FREEDOM_PASS AL, Stati Uniti.
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS AK, USA.
US_CA_FASTRAK CA, USA.
US_CA_FASTRAK_CAV_STICKER Indica che il conducente ha un abbonamento FasTrak oltre all'adesivo Clean Air Vehicle (CAV) rilasciato dal DMV. https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
US_CO_EXPRESSTOLL CO, USA.
US_CO_GO_PASS CO, USA.
US_DE_EZPASSDE DE, USA.
US_FL_BOB_SIKES_TOLL_BRIDGE_PASS FL, Stati Uniti.
US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD FL, Stati Uniti.
US_FL_EPASS FL, Stati Uniti.
US_FL_GIBA_TOLL_PASS FL, Stati Uniti.
US_FL_LEEWAY FL, Stati Uniti.
US_FL_SUNPASS FL, Stati Uniti.
US_FL_SUNPASS_PRO FL, Stati Uniti.
US_IL_EZPASSIL IL, Stati Uniti.
US_IL_IPASS IL, Stati Uniti.
US_IN_EZPASSIN IN, Stati Uniti.
US_KS_BESTPASS_HORIZON KS, Stati Uniti.
US_KS_KTAG KS, Stati Uniti.
US_KS_NATIONALPASS KS, Stati Uniti.
US_KS_PREPASS_ELITEPASS KS, Stati Uniti.
US_LA_GEAUXPASS LA, USA.
US_LA_TOLL_TAG LA, USA.
US_MA_EZPASSMA MA, Stati Uniti.
US_MD_EZPASSMD MD, Stati Uniti.
US_ME_EZPASSME ME, Stati Uniti.
US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD MI, Stati Uniti.
US_MI_BCPASS MI, Stati Uniti.
US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG MI, Stati Uniti.
US_MI_IQ_PROX_CARD

MI, Stati Uniti. Deprecato perché questo tipo di abbonamento non esiste più.
US_MI_IQ_TAG MI, Stati Uniti.
US_MI_MACKINAC_BRIDGE_MAC_PASS MI, Stati Uniti.
US_MI_NEXPRESS_TOLL MI, Stati Uniti.
US_MN_EZPASSMN MN, Stati Uniti.
US_NC_EZPASSNC NC, Stati Uniti.
US_NC_PEACH_PASS NC, Stati Uniti.
US_NC_QUICK_PASS NC, Stati Uniti.
US_NH_EZPASSNH NH, Stati Uniti.
US_NJ_DOWNBEACH_EXPRESS_PASS NJ, Stati Uniti.
US_NJ_EZPASSNJ NJ, Stati Uniti.
US_NY_EXPRESSPASS NY, Stati Uniti.
US_NY_EZPASSNY NY, Stati Uniti.
US_OH_EZPASSOH OH, Stati Uniti.
US_PA_EZPASSPA PA, Stati Uniti.
US_RI_EZPASSRI RI, Stati Uniti.
US_SC_PALPASS SC, Stati Uniti.
US_TX_AVI_TAG TX, Stati Uniti.
US_TX_BANCPASS TX, Stati Uniti.
US_TX_DEL_RIO_PASS TX, Stati Uniti.
US_TX_EFAST_PASS TX, Stati Uniti.
US_TX_EAGLE_PASS_EXPRESS_CARD TX, Stati Uniti.
US_TX_EPTOLL TX, Stati Uniti.
US_TX_EZ_CROSS TX, Stati Uniti.
US_TX_EZTAG TX, Stati Uniti.
US_TX_FUEGO_TAG TX, Stati Uniti.
US_TX_LAREDO_TRADE_TAG TX, Stati Uniti.
US_TX_PLUSPASS TX, Stati Uniti.
US_TX_TOLLTAG TX, Stati Uniti.
US_TX_TXTAG TX, Stati Uniti.
US_TX_XPRESS_CARD TX, Stati Uniti.
US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD UT, Stati Uniti.
US_VA_EZPASSVA VA, Stati Uniti.
US_WA_BREEZEBY WA, Stati Uniti.
US_WA_GOOD_TO_GO WA, Stati Uniti.
US_WV_EZPASSWV WV, Stati Uniti.
US_WV_MEMORIAL_BRIDGE_TICKETS WV, Stati Uniti.
US_WV_MOV_PASS WV, Stati Uniti
US_WV_NEWELL_TOLL_BRIDGE_TICKET WV, Stati Uniti.

TrafficModel

Questo campo specifica uno dei seguenti presupposti da utilizzare per calcolare il tempo di percorrenza in condizioni di traffico, mostrati nelle enumerazioni riportate di seguito. A seconda dell'enumerazione scelta, il campo duration della risposta TrafficModel varierà. Il valore contiene il tempo previsto per raggiungere la destinazione nel traffico, in base alle medie storiche. TrafficModel è disponibile solo per le richieste in cui RoutingPreference è impostato su TRAFFIC_AWARE_OPTIMAL e RouteTravelMode su DRIVE.

Enum
TRAFFIC_MODEL_UNSPECIFIED Non utilizzata. Se specificato, il valore predefinito è BEST_GUESS.
BEST_GUESS Indica che il duration restituito deve essere la migliore stima del tempo di percorrenza in base a ciò che è noto sulle condizioni del traffico storico e in tempo reale. Il traffico in tempo reale diventa più importante quanto più departure_time è vicino al momento attuale.
PESSIMISTIC Indica che la durata restituita dovrebbe essere superiore al tempo di percorrenza effettivo nella maggior parte dei giorni, anche se in alcuni giorni con condizioni di traffico particolarmente difficili questo valore potrebbe essere superato.
OPTIMISTIC Indica che la durata restituita dovrebbe essere inferiore al tempo di viaggio effettivo nella maggior parte dei giorni, anche se in alcuni giorni con condizioni di traffico particolarmente buone il tempo di viaggio potrebbe essere inferiore a questo valore.

TransitAgency

Un'azienda di trasporto pubblico che gestisce una linea di trasporto pubblico.

Campi
name

string

Il nome di questa azienda di trasporto pubblico.
phone_number

string

Il numero di telefono formattato specifico per le impostazioni internazionali dell'azienda di trasporto pubblico.
uri

string

L'URI dell'azienda di trasporto pubblico.

TransitLine

Contiene informazioni sulla linea di trasporto pubblico utilizzata in questo passaggio.

Campi
agencies[]

TransitAgency

L'azienda o le aziende di trasporto pubblico che gestiscono questa linea di trasporto pubblico.
name

string

Il nome completo di questa linea di trasporto pubblico, ad esempio "8 Avenue Local".
uri

string

l'URI di questa linea di trasporto pubblico fornito dall'azienda di trasporto pubblico.
color

string

Il colore comunemente utilizzato nella segnaletica per questa linea. Rappresentato in formato esadecimale.
icon_uri

string

L'URI dell'icona associata a questa riga.
name_short

string

Il nome breve di questa linea di trasporto pubblico. Questo nome sarà normalmente un numero di riga, ad esempio "M7" o "355".
text_color

string

Il colore comunemente utilizzato nel testo della segnaletica per questa linea. Rappresentato in formato esadecimale.
vehicle

TransitVehicle

Il tipo di veicolo che opera su questa linea di trasporto pubblico.

TransitPreferences

Preferenze per i percorsi basati su TRANSIT che influenzano il percorso restituito.

Campi
allowed_travel_modes[]

TransitTravelMode

Un insieme di modalità di viaggio da utilizzare quando si ottiene un percorso TRANSIT. Il valore predefinito è tutte le modalità di viaggio supportate.
routing_preference

TransitRoutingPreference

Una preferenza di routing che, se specificata, influenza il percorso TRANSIT restituito.

TransitRoutingPreference

Specifica le preferenze di routing per i percorsi con il trasporto pubblico.

Enum
TRANSIT_ROUTING_PREFERENCE_UNSPECIFIED Nessuna preferenza specificata.
LESS_WALKING Indica che il percorso calcolato deve preferire tratti a piedi limitati.
FEWER_TRANSFERS Indica che l'itinerario calcolato deve preferire un numero limitato di trasferimenti.

TransitTravelMode

Un insieme di valori utilizzati per specificare la modalità di trasporto.

Enum
TRANSIT_TRAVEL_MODE_UNSPECIFIED Nessuna modalità di viaggio con i mezzi pubblici specificata.
BUS Viaggiare in autobus.
SUBWAY Viaggia in metropolitana.
TRAIN Viaggiare in treno.
LIGHT_RAIL Viaggia in metropolitana leggera o in tram.
RAIL Viaggia in treno. Ciò equivale a una combinazione di SUBWAY, TRAIN e LIGHT_RAIL.

TransitStop

Informazioni su una fermata del trasporto pubblico.

Campi
name

string

Il nome della fermata del trasporto pubblico.
location

Location

La posizione della fermata espressa in coordinate di latitudine/longitudine.

TransitVehicle

Informazioni su un veicolo utilizzato nelle linee di trasporto pubblico.

Campi
name

LocalizedText

Il nome di questo veicolo, scritto in maiuscolo.
type

TransitVehicleType

Il tipo di veicolo utilizzato.
icon_uri

string

L'URI di un'icona associata a questo tipo di veicolo.
local_icon_uri

string

L'URI dell'icona associata a questo tipo di veicolo, in base alla segnaletica stradale locale.

TransitVehicleType

Il tipo di veicoli per gli itinerari del trasporto pubblico.

Enum
TRANSIT_VEHICLE_TYPE_UNSPECIFIED Non utilizzata.
BUS Autobus.
CABLE_CAR Un veicolo che funziona con un cavo, di solito a terra. Le funivie possono essere di tipo GONDOLA_LIFT.
COMMUTER_TRAIN Ferrovia suburbana.
FERRY Traghetto.
FUNICULAR Un veicolo che viene tirato su una ripida salita da un cavo. Una funicolare è in genere costituita da due vagoni, ciascuno dei quali funge da contrappeso per l'altro.
GONDOLA_LIFT Una funivia.
HEAVY_RAIL Ferrovia pesante.
HIGH_SPEED_TRAIN Treno ad alta velocità.
INTERCITY_BUS Autobus interurbano.
LONG_DISTANCE_TRAIN Treno a lunga percorrenza.
METRO_RAIL Metropolitana leggera.
MONORAIL Monorail.
OTHER Tutti gli altri veicoli.
RAIL Ferrovia.
SHARE_TAXI Un taxi condiviso è un tipo di autobus che può caricare e scaricare passeggeri ovunque lungo il suo percorso.
SUBWAY Metropolitana leggera sotterranea.
TRAM Metropolitana leggera di superficie.
TROLLEYBUS Filobus.

Unità

Un insieme di valori che specificano l'unità di misura utilizzata nella visualizzazione.

Enum
UNITS_UNSPECIFIED Unità di misura non specificate. Il valore predefinito è l'unità di misura dedotta dalla richiesta.
METRIC Unità di misura metriche.
IMPERIAL Unità di misura imperiali (inglesi).

VehicleEmissionType

Un insieme di valori che descrivono il tipo di emissione del veicolo. Si applica solo a DRIVE RouteTravelMode.

Enum
VEHICLE_EMISSION_TYPE_UNSPECIFIED Nessun tipo di emissione specificato. Il valore predefinito è GASOLINE.
GASOLINE Veicolo alimentato a benzina.
ELECTRIC Veicolo alimentato a elettricità.
HYBRID Veicolo con alimentazione ibrida (ad esempio benzina + elettrico).
DIESEL Veicolo alimentato a diesel.

VehicleInfo

Contiene le informazioni sul veicolo, ad esempio il tipo di emissioni.

Campi
emission_type

VehicleEmissionType

Descrive il tipo di emissioni del veicolo. Si applica solo a DRIVE RouteTravelMode.

Waypoint

Contiene un waypoint. I waypoint contrassegnano l'inizio e la fine di un percorso e includono le soste intermedie lungo il percorso.

Campi
via

bool

Contrassegna questa tappa come un traguardo piuttosto che un punto di sosta. Per ogni punto di transito non intermedio nella richiesta, la risposta aggiunge una voce all'array legs per fornire i dettagli delle soste in quella tratta del viaggio. Imposta questo valore su true quando vuoi che l'itinerario passi per questo waypoint senza fermarsi. Le tappe intermedie non causano l'aggiunta di una voce all'array legs, ma indirizzano il viaggio attraverso la tappa intermedia. Puoi impostare questo valore solo sui waypoint intermedi. La richiesta non va a buon fine se imposti questo campo sui waypoint terminali. Se ComputeRoutesRequest.optimize_waypoint_order è impostato su true, questo campo non può essere impostato su true; in caso contrario, la richiesta non va a buon fine.
vehicle_stopover

bool

Indica che il waypoint è destinato ai veicoli che devono fermarsi per il ritiro o la consegna. Quando imposti questo valore, il percorso calcolato non include waypoint non via su strade non adatte al ritiro e alla consegna. Questa opzione funziona solo per le modalità di trasporto DRIVE e TWO_WHEELER e quando location_type è Location.
side_of_road

bool

Indica che la posizione di questa tappa deve avere una preferenza per il veicolo per fermarsi su un lato particolare della strada. Quando imposti questo valore, il percorso passerà per la posizione in modo che il veicolo possa fermarsi sul lato della strada verso cui la posizione è orientata dal centro della strada. Questa opzione funziona solo per DRIVE e TWO_WHEELER RouteTravelMode.
Campo unione location_type. Diversi modi per rappresentare una località. location_type può essere solo uno dei seguenti:
location

Location

Un punto specificato utilizzando le coordinate geografiche, inclusa un'intestazione facoltativa.
place_id

string

L'ID luogo POI associato al waypoint.
address

string

Indirizzo leggibile o un plus code. Per ulteriori dettagli, visita la pagina https://plus.codes.