Package google.maps.routing.v2

Indice

Route

L'API Routes.

ComputeRouteMatrix

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)

Riceve un elenco di origini e destinazioni e restituisce uno stream contenente informazioni sui percorsi per ogni combinazione di origine e destinazione.

NOTA:questo metodo richiede di specificare una maschera di 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 (vedi i parametri e le intestazioni URL 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 di campo per durate, distanze, stato, condizione e indici degli elementi del percorso (un esempio di configurazione di produzione): X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration

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

  • La selezione solo dei campi necessari consente al nostro server di risparmiare cicli di calcolo, il che ci consente di restituirti il risultato con una latenza inferiore.
  • La selezione solo dei campi necessari nel job di produzione garantisce un rendimento stabile della latenza. In futuro potremmo aggiungere altri campi di risposta, che potrebbero richiedere tempi di calcolo aggiuntivi. Se selezioni tutti i campi o tutti i campi di primo livello, potresti riscontrare un calo del rendimento perché tutti i nuovi campi che aggiungi verranno inclusi automaticamente nella risposta.
  • La selezione solo dei campi necessari comporta una dimensione della risposta inferiore e, di conseguenza, un throughput di rete più elevato.
ComputeRoutes

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)

Restituisce il percorso principale insieme a percorsi alternativi facoltativi, in base a un insieme di waypoint intermedi e finali.

NOTA:questo metodo richiede di specificare una maschera di campo di risposta nell'input. Puoi fornire la maschera del campo di risposta utilizzando il parametro URL $fields o fields oppure un'intestazione HTTP/gRPC X-Goog-FieldMask (consulta i parametri e le intestazioni URL 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 superiore (routes) perché:

  • La selezione solo dei campi necessari consente al nostro server di risparmiare cicli di calcolo, il che ci consente di restituirti il risultato con una latenza inferiore.
  • La selezione solo dei campi necessari nel job di produzione garantisce un rendimento stabile della latenza. In futuro potremmo aggiungere altri campi di risposta, che potrebbero richiedere tempi di calcolo aggiuntivi. Se selezioni tutti i campi o tutti i campi di primo livello, potresti riscontrare un calo del rendimento perché tutti i nuovi campi che aggiungi verranno inclusi automaticamente nella risposta.
  • La selezione solo dei campi necessari comporta una dimensione della risposta inferiore e, di conseguenza, un throughput di rete più elevato.

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 diversi limiti di dimensioni:

  • La somma del numero di origini + il 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 × il numero di destinazioni non deve essere superiore a 100 se routing_preference è impostato su TRAFFIC_AWARE_OPTIMAL.
  • Il prodotto del numero di origini × il 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 il percorso. Il server tenta di utilizzare la preferenza di routing selezionata per calcolare il percorso. 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 è la data e l'ora in cui hai effettuato la richiesta. NOTA: puoi specificare un 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 della locale 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 località della prima origine.

region_code

string

Facoltativo. Il codice regione, specificato come valore di due caratteri di un ccTLD ("dominio di primo livello"). Per ulteriori informazioni, consulta Domini di primo livello con codice paese.

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 di campo da restituire nella risposta.

traffic_model

TrafficModel

Facoltativo. Specifica le ipotesi 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. Da RoutingPreference a TRAFFIC_AWARE_OPTIMAL e da RouteTravelMode a DRIVE. Se non viene specificato TrafficModel, il valore predefinito è BEST_GUESS se viene richiesto il traffico.

transit_preferences

TransitPreferences

Facoltativo. Specifica le preferenze che influiscono sul percorso restituito per i percorsi TRANSIT. NOTA: puoi specificare un transit_preferences solo 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 gli elementi della matrice.

ComputeRoutesRequest

Messaggio di richiesta ComputeRoutes.

Campi
origin

Waypoint

Obbligatorio. Punto di passaggio di origine.

destination

Waypoint

Obbligatorio. Punto di passaggio di destinazione.

intermediates[]

Waypoint

Facoltativo. Un insieme di punti di passaggio lungo il percorso (esclusi i punti di partenza e di arrivo), da fermarsi o da passare. Sono supportati fino a 25 waypoint intermedi.

travel_mode

RouteTravelMode

Facoltativo. Specifica la modalità di trasporto.

routing_preference

RoutingPreference

Facoltativo. Specifica come calcolare il percorso. Il server tenta di utilizzare la preferenza di routing selezionata per calcolare il percorso. 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 preferenza per la qualità del polilinea.

polyline_encoding

PolylineEncoding

Facoltativo. Specifica la codifica preferita per il polilinea.

departure_time

Timestamp

Facoltativo. L'orario di partenza. Se non imposti questo valore, il valore predefinito è la data e l'ora in cui hai effettuato la richiesta. NOTA: puoi specificare un departure_time nel passato solo quando RouteTravelMode è impostato su TRANSIT. I percorsi 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: può essere impostato solo quando RouteTravelMode è impostato su TRANSIT. Puoi specificare departure_time o arrival_time, ma non entrambi. I percorsi 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 della locale 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 località della richiesta di itinerario.

region_code

string

Facoltativo. Il codice regione, specificato come valore di due caratteri di un ccTLD ("dominio di primo livello"). Per ulteriori informazioni, consulta Domini di primo livello con codice paese.

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 e la durata del passaggio 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 la nuova organizzazione. 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 i percorsi di riferimento da calcolare nell'ambito della richiesta, oltre al percorso predefinito. Una route di riferimento è una route con un obiettivo di calcolo diverso rispetto alla route predefinita. Ad esempio, un calcolo del percorso di riferimento FUEL_EFFICIENT tiene conto di vari parametri che generano un percorso ottimale in termini di consumo 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 di campo da restituire nella risposta.

traffic_model

TrafficModel

Facoltativo. Specifica le ipotesi 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 non viene specificato TrafficModel, il valore predefinito è BEST_GUESS se viene richiesto il traffico.

transit_preferences

TransitPreferences

Facoltativo. Specifica le preferenze che influiscono sul percorso restituito per i percorsi TRANSIT. NOTA: puoi specificare un transit_preferences solo 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 i percorsi.
FUEL_CONSUMPTION Consumo di carburante stimato per i percorsi.
TRAFFIC_ON_POLYLINE Polilinee sensibili al traffico per i percorsi.
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS NavigationInstructions presentato come stringa di testo HTML formattata. Questi contenuti sono pensati per essere letti così come sono e sono solo per la visualizzazione. Non analizzarlo tramite programmazione.
FLYOVER_INFO_ON_POLYLINE Informazioni sui voli panoramici per i percorsi. Per restituire queste informazioni, devi specificare la maschera di campo routes.polyline_details.flyover_info. Al momento questi dati verranno compilati solo per alcune città in India. Questa funzionalità è sperimentale e lo SKU/addebito è soggetto a modifiche.
NARROW_ROAD_INFO_ON_POLYLINE Informazioni su strade strette per i percorsi. Per restituire queste informazioni, devi specificare la maschera di campo routes.polyline_details.narrow_road_info. Al momento questi dati verranno compilati solo per alcune città 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 anziché autostrade, 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 waypoint intermedi o con optimize_waypoint_order. Queste richieste non andranno a buon fine. Tuttavia, puoi utilizzarlo con qualsiasi routing_preference.

ComputeRoutesResponse

Calcola le route del messaggio di risposta.

Campi
routes[]

Route

Contiene un array di percorsi calcolati (fino a tre) se specifichi compute_alternatives_routes e contiene un solo percorso se non lo specifichi. Quando questo array contiene più voci, la prima è il percorso più consigliato. 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 su come e perché è stato utilizzato un risultato di riserva. Se questo campo è impostato, significa che il server ha utilizzato una modalità di routing diversa dalla modalità preferita come alternativa.

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 del client originale.

reason

FallbackReason

Il motivo per cui è stata utilizzata la risposta di riserva anziché la risposta 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 riserva specificato.
SERVER_ERROR Si è verificato un errore del server durante il calcolo dei percorsi con la modalità di calcolo del percorso che preferisci, ma siamo riusciti a restituire un risultato calcolato con una modalità alternativa.
LATENCY_EXCEEDED Non è stato possibile completare il calcolo con la modalità di calcolo itinerario che preferisci in tempo, ma siamo riusciti a restituire un risultato calcolato con una modalità alternativa.

FallbackRoutingMode

Modalità di instradamento 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 posizioni utilizzate come waypoint. Viene compilato solo per i waypoint di indirizzo. Include i dettagli sui risultati del geocodificazione ai fini della determinazione del luogo a cui è stato geocodificato l'indirizzo.

Campi
geocoder_status

Status

Indica il codice di stato risultante dall'operazione di geocodifica.

type[]

string

I tipi di risultati, sotto forma di zero o più tag tipo. Tipi supportati: tipi di indirizzi e tipi di componenti dell'indirizzo.

partial_match

bool

Indica che il geocodificatore non ha restituito una corrispondenza esatta per la richiesta originale, anche se è stato in grado di 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 waypoint intermedia corrispondente nella richiesta. Viene compilato solo se il waypoint corrispondente è una fermata intermedia.

GeocodingResults

Contiene GeocodedWaypoints per i waypoint di origine, destinazione e intermedi. Viene compilato solo per i waypoint di indirizzo.

Campi
origin

GeocodedWaypoint

Punto di passaggio con geocodice di origine.

destination

GeocodedWaypoint

Punto di passaggio con geocodifica della destinazione.

intermediates[]

GeocodedWaypoint

Un elenco di waypoint intermedi geocodificati contenenti ciascuno un campo di 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 come definito nel database dei fusi orari IANA, ad esempio "America/New_York".

Località

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

Campi
lat_lng

LatLng

Le coordinate geografiche del waypoint.

heading

Int32Value

La direzione della bussola associata alla direzione del flusso del traffico. Questo valore specifica il lato della strada per il ritiro e il riattacco. I valori di rotta possono variare da 0 a 360, dove 0 indica una rotta a nord, 90 indica una rotta a est e così via. Puoi utilizzare questo campo solo per DRIVE e TWO_WHEELER RouteTravelMode.

Manovra

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

Enum
MANEUVER_UNSPECIFIED Non utilizzato.
TURN_SLIGHT_LEFT Gira leggermente a sinistra.
TURN_SHARP_LEFT Svolta bruscamente a sinistra.
UTURN_LEFT Fai un U-turn a sinistra.
TURN_LEFT Svolta a sinistra.
TURN_SLIGHT_RIGHT Gira leggermente a destra.
TURN_SHARP_RIGHT Svolta bruscamente a destra.
UTURN_RIGHT Fai un U-turn a destra.
TURN_RIGHT Gira a destra.
STRAIGHT Vai dritto.
RAMP_LEFT Prendi la rampa a sinistra.
RAMP_RIGHT Prendi la rampa a destra.
MERGE Unisciti al 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 Gira a sinistra al semaforo circolare.
ROUNDABOUT_RIGHT Gira a destra alla rotonda.
DEPART Manovra iniziale.
NAME_CHANGE Utilizzato per indicare una modifica del nome della strada.

Incapsula le istruzioni di navigazione per un RouteLegStep.

Campi
maneuver

Maneuver

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

instructions

string

Istruzioni per completare questo passaggio.

Polilinea

Incapsula una polilinea codificata.

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

string

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

geo_json_linestring

Struct

Specifica un polilinea utilizzando il formato LineString GeoJSON.

PolylineDetails

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

Campi
flyover_info[]

FlyoverInfo

Dettagli del sorvolo lungo il polilinea.

narrow_road_info[]

NarrowRoadInfo

Dettagli delle strade strette lungo il polilinea.

FlyoverInfo

Incapsula le informazioni sui cavalcavia lungo il polilinea.

Campi
flyover_presence

RoadFeatureState

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

polyline_point_index

PolylinePointIndex

La posizione delle informazioni relative al passaggio panoramico lungo la polilinea.

NarrowRoadInfo

Incapsula le informazioni sulle strade strette lungo il polilinea.

Campi
narrow_road_presence

RoadFeatureState

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

polyline_point_index

PolylinePointIndex

La posizione delle informazioni relative alle strade strette lungo la polilinea.

PolylinePointIndex

Incapsula gli indici di inizio e di fine per un dettaglio polilinea. Nei casi in cui i dati corrispondano a un singolo punto, start_index e end_index saranno uguali.

Campi
start_index

int32

L'indice iniziale di questo dettaglio nel polilinea.

end_index

int32

L'indice di fine di questo dettaglio nel polilinea.

RoadFeatureState

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

Enum
ROAD_FEATURE_STATE_UNSPECIFIED Lo stato dell'elemento stradale non è stato calcolato (valore predefinito).
EXISTS L'elemento strada esiste.
DOES_NOT_EXIST L'elemento strada non esiste.

PolylineEncoding

Specifica il tipo preferito di polilinea 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 delle polilinee.
GEO_JSON_LINESTRING Specifica un polilinea utilizzando il formato LineString GeoJSON

PolylineQuality

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

Enum
POLYLINE_QUALITY_UNSPECIFIED Nessuna preferenza per la qualità dei polilinee specificata. Il valore predefinito è OVERVIEW.
HIGH_QUALITY Specifica un polilinea di alta qualità, composto utilizzando più punti rispetto a OVERVIEW, a fronte di un aumento delle dimensioni della risposta. Utilizza questo valore quando hai bisogno di una maggiore precisione.
OVERVIEW Specifica una polilinea di panoramica, composta utilizzando un numero ridotto di punti. Utilizza questo valore per visualizzare una panoramica del percorso. L'utilizzo di questa opzione comporta una latenza delle richieste inferiore rispetto all'utilizzo dell'opzione HIGH_QUALITY.

Percorso

Contiene un percorso costituito da una serie di tratti stradali collegati che uniscono i waypoint di inizio, di fine e intermedi.

Campi
route_labels[]

RouteLabel

Etichette per Route utili per identificare proprietà specifiche del percorso da confrontare con altre.

legs[]

RouteLeg

Un insieme di tratti (segmenti del percorso tra i waypoint) che compongono il percorso. Ogni tratta corrisponde al viaggio tra due via Waypoints non uguali. Ad esempio, un itinerario senza waypoint intermedi ha un solo tratto. Un itinerario che include un punto di passaggio intermedio diverso da via ha due tratti. Un itinerario che include un punto di passaggio intermedio via ha un tratto. L'ordine delle tappe corrisponde a quello dei waypoint da origin a intermediates a destination.

distance_meters

int32

La distanza percorsa dal percorso, in metri.

duration

Duration

Il tempo necessario per percorrere il percorso. Se imposti routing_preference su TRAFFIC_UNAWARE, questo valore corrisponde 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 il percorso senza tenere conto delle condizioni del traffico.

polyline

Polyline

La polilinea del percorso complessivo. Questo polilinea è il polilinea combinato di tutti i legs.

description

string

Una descrizione del percorso.

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 sul percorso.

optimized_intermediate_waypoint_index[]

int32

Se imposti optimize_waypoint_order su true, questo campo contiene l'ordinamento ottimizzato dei waypoint intermedi. In caso contrario, questo campo è vuoto. Ad esempio, se inserisci come origine Los Angeles, come waypoint intermedi Dallas, Bangor e Phoenix e come destinazione New York e l'ordine ottimizzato dei waypoint 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 di testo delle proprietà di Route.

route_token

string

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

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 con waypoint Via.

polyline_details

PolylineDetails

Contiene informazioni sui dettagli lungo il polilinea.

RouteLocalizedValues

Rappresentazioni di testo di determinate proprietà.

Campi
distance

LocalizedText

Distanza da percorrere rappresentata in formato di testo.

duration

LocalizedText

Durata, rappresentata in formato di testo e localizzata nella regione della query. Tiene conto delle condizioni del traffico. Nota: se non hai richiesto informazioni sul traffico, questo valore corrisponde 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 di testo.

RouteLabel

Etichette per Route utili per identificare proprietà specifiche del percorso da confrontare con altre.

Enum
ROUTE_LABEL_UNSPECIFIED Valore predefinito: non utilizzato.
DEFAULT_ROUTE Il percorso "migliore" predefinito restituito per il calcolo del percorso.
DEFAULT_ROUTE_ALTERNATE Un'alternativa al percorso "migliore" predefinito. 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 waypoint non via.

Campi
distance_meters

int32

La distanza percorsa della tratta del percorso, in metri.

duration

Duration

La durata del tratto. Se route_preference è impostato su TRAFFIC_UNAWARE, questo valore corrisponde 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 nel tratto, calcolata senza tenere conto delle condizioni del traffico.

polyline

Polyline

La polilinea complessiva di questo tratto che include la polilinea di ogni step.

start_location

Location

La posizione di partenza di questo tratto. Questa località potrebbe essere diversa da quella fornita in origin. Ad esempio, se il origin fornito non si trova vicino a una strada, si tratta di un punto sulla strada.

end_location

Location

La località di destinazione di questo tratto. Questa località potrebbe essere diversa da quella fornita in destination. Ad esempio, se 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 questo tratto. Ogni passaggio rappresenta un'istruzione di navigazione.

travel_advisory

RouteLegTravelAdvisory

Contiene le informazioni aggiuntive che l'utente deve conoscere, ad esempio possibili limitazioni nelle zone di traffico, in un tratto del percorso.

localized_values

RouteLegLocalizedValues

Rappresentazioni di testo delle proprietà di RouteLeg.

steps_overview

StepsOverview

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

RouteLegLocalizedValues

Rappresentazioni di testo di determinate proprietà.

Campi
distance

LocalizedText

Distanza da percorrere rappresentata in formato di testo.

duration

LocalizedText

Durata, rappresentata in formato di testo e localizzata nella regione della query. Tiene conto delle condizioni del traffico. Nota: se non hai richiesto informazioni sul traffico, questo valore corrisponde a quello di static_duration.

static_duration

LocalizedText

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

StepsOverview

Fornisce informazioni di panoramica su un elenco di RouteLegStep.

Campi
multi_modal_segments[]

MultiModalSegment

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

MultiModalSegment

Fornisce informazioni riepilogative su diversi segmenti multimodali del 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 indica l'inizio di un segmento multimodale.

step_end_index

int32

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

RouteLegStep

Contiene un segmento di un RouteLeg. Un passaggio corrisponde a una singola istruzione di navigazione. I tratti del percorso sono costituiti da passaggi.

Campi
distance_meters

int32

La distanza percorsa in questo passaggio, in metri. In alcuni casi, questo campo potrebbe non avere un valore.

static_duration

Duration

La durata del viaggio in questo passaggio senza tenere conto delle condizioni del traffico. In alcuni casi, questo campo potrebbe non avere un valore.

polyline

Polyline

Il polilinea associato a questo passaggio.

start_location

Location

La posizione di partenza di questo passaggio.

end_location

Location

La posizione di destinazione di questo passaggio.

navigation_instruction

NavigationInstruction

Istruzioni di navigazione.

travel_advisory

RouteLegStepTravelAdvisory

Contiene le informazioni aggiuntive che l'utente deve conoscere, ad esempio possibili limitazioni nelle zone di traffico, in un passaggio della tappa.

localized_values

RouteLegStepLocalizedValues

Rappresentazioni di testo delle proprietà di RouteLegStep.

transit_details

RouteLegStepTransitDetails

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

travel_mode

RouteTravelMode

La modalità di viaggio utilizzata per questo passaggio.

RouteLegStepLocalizedValues

Rappresentazioni di testo di determinate proprietà.

Campi
distance

LocalizedText

Distanza da percorrere 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 per il passaggio.

localized_values

TransitDetailsLocalizedValues

Rappresentazioni di testo 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 destinazione.

headway

Duration

Specifica l'ora prevista come durata tra le partenze dalla stessa fermata in questo momento. Ad esempio, con un valore di intervallo in secondi pari a 600, dovresti aspettarti un'attesa di dieci minuti se perdi l'autobus.

transit_line

TransitLine

Informazioni sulla linea di trasporto pubblico utilizzata in questo passaggio.

stop_count

int32

Il numero di fermate dalla fermata di partenza a quella di arrivo. Questo conteggio include la fermata di arrivo, ma esclude la fermata 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 visualizzato negli orari e nelle insegne per identificare una corsa 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, in California, alle 15:10 nei giorni feriali per Sacramento, in California.

TransitDetailsLocalizedValues

Descrizioni localizzate dei valori per RouteTransitDetails.

Campi
arrival_time

LocalizedTime

L'ora nella sua rappresentazione di testo formattato con un fuso orario corrispondente.

departure_time

LocalizedTime

L'ora nella sua rappresentazione di testo formattato con un fuso orario corrispondente.

TransitStopDetails

Dettagli sulle fermate dei trasporti pubblici per la linea RouteLegStep.

Campi
arrival_stop

TransitStop

Informazioni sulla fermata di arrivo per il 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 il passaggio.

RouteLegStepTravelAdvisory

Contiene le informazioni aggiuntive che l'utente deve conoscere, ad esempio le possibili limitazioni relative alle zone di traffico in un tratto.

Campi
speed_reading_intervals[]

SpeedReadingInterval

NOTA: questo campo non è attualmente compilato.

RouteLegTravelAdvisory

Contiene le informazioni aggiuntive che l'utente deve conoscere in un passaggio della tratta, ad esempio possibili limitazioni nelle zone a traffico limitato.

Campi
toll_info

TollInfo

Contiene informazioni sui pedaggi per la RouteLeg specifica. Questo campo viene compilato solo se prevediamo che ci siano pedaggi sulla RouteLeg. Se questo campo è impostato, ma il sottocampo estimated_price non è compilato, ci aspettiamo che la strada contenga pedaggi, ma non conosciamo un prezzo stimato. Se questo campo non esiste, significa che non è previsto alcun pedaggio per RouteLeg.

speed_reading_intervals[]

SpeedReadingInterval

Intervalli di lettura rapida che descrivono la densità del traffico. Applicabile in caso di preferenze di routing TRAFFIC_AWARE e TRAFFIC_AWARE_OPTIMAL. Gli intervalli coprono l'intero polilinea del RouteLeg senza sovrapposizioni. Il punto di inizio di un intervallo specificato corrisponde al punto di fine 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. Punto di passaggio di destinazione

RouteMatrixElement

Contiene le informazioni sui percorsi calcolati per una coppia di 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 il percorso è stato trovato o meno. Indipendentemente dallo stato.

distance_meters

int32

La distanza percorsa dal percorso, in metri.

duration

Duration

Il tempo necessario per percorrere il percorso. Se imposti routing_preference su TRAFFIC_UNAWARE, questo valore corrisponde 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 il percorso senza tenere conto delle condizioni del traffico.

travel_advisory

RouteTravelAdvisory

Informazioni aggiuntive sul percorso. ad esempio informazioni su limitazioni e pedaggi

fallback_info

FallbackInfo

In alcuni casi, quando il server non è in grado di calcolare il percorso con le preferenze specificate per questa particolare coppia di origine/destinazione, potrebbe ricorrere a un'altra modalità di calcolo. 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 di testo delle proprietà di RouteMatrixElement.

origin_index

int32

Indice a partire da zero dell'origine nella richiesta.

destination_index

int32

Indice a partire da zero della destinazione nella richiesta.

LocalizedValues

Rappresentazioni di testo di determinate proprietà.

Campi
distance

LocalizedText

Distanza da percorrere rappresentata in formato di testo.

duration

LocalizedText

Durata rappresentata in forma di testo tenendo conto delle condizioni del traffico. Nota: se non sono state richieste informazioni sul traffico, questo valore corrisponde a quello di 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 di testo.

RouteMatrixElementCondition

La condizione del percorso restituito.

Enum
ROUTE_MATRIX_ELEMENT_CONDITION_UNSPECIFIED Viene utilizzato solo quando status dell'elemento non è OK.
ROUTE_EXISTS È stato trovato un percorso e sono state compilate le informazioni corrispondenti 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

Un'unica origine per ComputeRouteMatrixRequest

Campi
waypoint

Waypoint

Obbligatorio. Punto di riferimento di origine

route_modifiers

RouteModifiers

Facoltativo. Modificatori per ogni percorso che prende questa stazione come origine

RouteModifiers

Incapsula 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 possibile, dando la preferenza ai percorsi che non le contengono. Si applica solo a DRIVE e TWO_WHEELER RouteTravelMode.

avoid_highways

bool

Se impostato su true, evita le autostrade, se possibile, dando la preferenza ai percorsi che non le contengono. Si applica solo a DRIVE e TWO_WHEELER RouteTravelMode.

avoid_ferries

bool

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

avoid_indoor

bool

Se impostato su true, evita la navigazione al chiuso, se possibile, dando la preferenza ai percorsi che non contengono navigazione al chiuso. Si applica solo al WALK RouteTravelMode.

vehicle_info

VehicleInfo

Specifica le informazioni sul veicolo.

toll_passes[]

TollPass

Incapsula le informazioni sulle tessere per il pedaggio. Se vengono forniti permessi di pedaggio, l'API tenta di restituire il prezzo del permesso. Se non vengono forniti permessi di pedaggio, 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 che l'utente deve conoscere, ad esempio eventuali limitazioni nelle zone di traffico.

Campi
toll_info

TollInfo

Contiene informazioni sui pedaggi lungo il percorso. Questo campo viene compilato solo se sono previsti pedaggi lungo il percorso. Se questo campo è impostato, ma il sottocampo estimatedPrice non è compilato, l'itinerario contiene pedaggi, ma il prezzo stimato è sconosciuto. Se questo campo non è impostato, non sono previsti pedaggi lungo il percorso.

speed_reading_intervals[]

SpeedReadingInterval

Intervalli di lettura rapida che descrivono la densità del traffico. Applicabile in caso di preferenze di routing TRAFFIC_AWARE e TRAFFIC_AWARE_OPTIMAL. Gli intervalli coprono l'intero polilinea del percorso senza sovrapposizioni. Il punto di inizio di un intervallo specificato corrisponde al punto di fine 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.

route_restrictions_partially_ignored

bool

Il percorso restituito potrebbe avere limitazioni non adatte alla modalità di viaggio o ai modificatori di percorso richiesti.

transit_fare

Money

Se presente, contiene i costi totali 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 sulle tariffe per tutti i passaggi di 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 mancare marciapiedi, percorsi pedonali o ciclabili ben segnalati. Devi mostrare questo avviso all'utente per tutti i percorsi a piedi, in bicicletta e su due ruote che mostri nella tua app.

Enum
TRAVEL_MODE_UNSPECIFIED Nessuna modalità di viaggio specificata. Il valore predefinito è DRIVE.
DRIVE Viaggiare in autovettura.
BICYCLE Viaggia in bicicletta.
WALK Viaggia a piedi.
TWO_WHEELER Veicolo a motore a due ruote. Ad esempio, moto. Tieni presente che questa modalità è diversa dalla modalità di viaggio BICYCLE, che copre la modalità a propulsione umana.
TRANSIT Viaggia con i percorsi dei trasporti pubblici, 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 tenere conto delle condizioni del traffico in tempo reale. Adatta 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 temporaneamente chiuse. I risultati di una determinata richiesta possono variare nel tempo a causa di cambiamenti nella rete stradale, condizioni di traffico medio aggiornate e la natura distribuita del servizio. I risultati possono variare anche tra percorsi quasi equivalenti in qualsiasi momento o con qualsiasi frequenza.
TRAFFIC_AWARE Calcola i percorsi tenendo conto delle condizioni del traffico in tempo reale. A differenza di TRAFFIC_AWARE_OPTIMAL, vengono applicate alcune ottimizzazioni per ridurre notevolmente 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ù alta.

SpeedReadingInterval

Indicatore della densità del traffico su un tratto contiguo di un polilinea o un percorso. Dato un percorso con punti P_0, P_1, ... , P_N (indice a partire da 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 nel polilinea.

end_polyline_point_index

int32

L'indice finale di questo intervallo nel polilinea.

Campo unione speed_type.

speed_type può essere solo uno dei seguenti:

speed

Speed

Velocità del traffico in questo intervallo.

Velocità

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

Enum
SPEED_UNSPECIFIED Valore predefinito. Questo valore non è utilizzato.
NORMAL Velocità normale, nessun rallentamento rilevato.
SLOW Rallentamento rilevato, ma non si è formato ingorgo.
TRAFFIC_JAM È stato rilevato un ingorgo.

TollInfo

Incapsula le informazioni sui pedaggi su un Route o su un RouteLeg.

Campi
estimated_price[]

Money

L'importo monetario dei pedaggi per Route o RouteLeg corrispondente. Questo elenco contiene un importo monetario per ogni valuta che dovrebbe essere addebitato 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ù voci per riflettere i pedaggi in valute diverse.

TollPass

Elenco delle tessere per pedaggi supportate in tutto il mondo.

Enum
TOLL_PASS_UNSPECIFIED Non utilizzato. Se viene utilizzato questo valore, la richiesta non va a buon fine.
AU_ETOLL_TAG Telepass di Sydney. Per ulteriori dettagli, visita la pagina https://www.myetoll.com.au.
AU_EWAY_TAG Telepass di Sydney. Per ulteriori dettagli, visita la pagina https://www.tollpay.com.au.
AU_LINKT Telepass valido in tutta l'Australia. Per ulteriori dettagli, visita la pagina https://www.linkt.com.au/.
AR_TELEPASE Telepass per l'Argentina. Per ulteriori dettagli, visita la pagina https://telepase.com.ar
BR_AUTO_EXPRESO Telepass per il Brasile. Per ulteriori dettagli, visita la pagina https://www.autoexpreso.com
BR_CONECTCAR Telepass per il Brasile. Per ulteriori dettagli, visita la pagina https://conectcar.com.
BR_MOVE_MAIS Telepass per il Brasile. Per ulteriori dettagli, visita la pagina https://movemais.com.
BR_PASSA_RAPIDO Telepass per il Brasile. Per ulteriori dettagli, visita la pagina https://pasorapido.gob.do/
BR_SEM_PARAR Telepass per il Brasile. Per ulteriori dettagli, visita la pagina https://www.semparar.com.br.
BR_TAGGY Telepass per il Brasile. Per ulteriori dettagli, visita la pagina https://taggy.com.br.
BR_VELOE Telepass per il Brasile. Per ulteriori dettagli, visita la pagina https://veloe.com.br/site/onde-usar.
CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD Passaggio di frontiera dal Canada agli Stati Uniti.
CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD Passaggio di frontiera dal Canada agli 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 Passaggio di frontiera dal Canada agli Stati Uniti.
ID_E_TOLL Indonesia. Carta elettronica fornita da più banche utilizzata per pagare i pedaggi. Tutte le e-card tramite 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 per targhe statali HP.
JP_ETC Giappone ETC. Sistema elettronico wireless per la riscossione dei pedaggi. https://www.go-etc.jp/
JP_ETC2 Giappone ETC2.0. 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 Telepass messicano. 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 in Messico. 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 in Messico. Uno dei tanti che operano a Città del Messico. https://www.televia.com.mx
MX_VIAPASS Telepass 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 una tessera FasTrak oltre all'adesivo Clean Air Vehicle (CAV) emesso 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 Los Angeles, Stati Uniti.
US_LA_TOLL_TAG Los Angeles, Stati Uniti.
US_MA_EZPASSMA MA, Stati Uniti.
US_MD_EZPASSMD MD, Stati Uniti.
US_ME_EZPASSME ME, USA.
US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD MI, USA.
US_MI_BCPASS MI, USA.
US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG MI, USA.
US_MI_IQ_PROX_CARD

MI, USA. È stato ritirato perché questo tipo di tessera non esiste più.

US_MI_IQ_TAG MI, USA.
US_MI_MACKINAC_BRIDGE_MAC_PASS MI, USA.
US_MI_NEXPRESS_TOLL MI, USA.
US_MN_EZPASSMN MN, Stati Uniti.
US_NC_EZPASSNC NC, USA.
US_NC_PEACH_PASS NC, USA.
US_NC_QUICK_PASS NC, USA.
US_NH_EZPASSNH NH, Stati Uniti.
US_NJ_DOWNBEACH_EXPRESS_PASS NJ, Stati Uniti.
US_NJ_EZPASSNJ NJ, Stati Uniti.
US_NY_EXPRESSPASS New York, Stati Uniti.
US_NY_EZPASSNY New York, Stati Uniti.
US_OH_EZPASSOH OH, Stati Uniti.
US_PA_EZPASSPA Pennsylvania, Stati Uniti.
US_RI_EZPASSRI RI, Stati Uniti.
US_SC_PALPASS SC, USA.
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 Virginia, 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

Specifica le ipotesi da utilizzare per il calcolo del tempo nel traffico. Questa impostazione influisce sul valore restituito nel campo duration della risposta, che contiene il tempo previsto nel traffico in base alle medie storiche.

Enum
TRAFFIC_MODEL_UNSPECIFIED Non utilizzato. Se specificato, il valore predefinito è BEST_GUESS.
BEST_GUESS Indica che il valore duration restituito dovrebbe essere la stima migliore del tempo di percorrenza in base alle informazioni note sulle condizioni di traffico storiche e in tempo reale. Il traffico in tempo reale diventa più importante man mano che departure_time si avvicina.
PESSIMISTIC Indica che la durata restituita deve 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 può essere superato.
OPTIMISTIC Indica che la durata restituita deve essere inferiore al tempo di percorrenza effettivo nella maggior parte dei giorni, anche se in alcuni giorni con condizioni di traffico particolarmente buone il tempo di percorrenza può essere inferiore a questo valore.

TransitAgency

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

Campi
name

string

Il nome dell'azienda di trasporto pubblico.

phone_number

string

Il numero di telefono della società di trasporto pubblico formattato in base alla località.

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 gestisce questa linea.

name

string

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

uri

string

L'URI per questa linea di trasporto pubblico fornito dall'azienda di trasporto pubblico.

color

string

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

icon_uri

string

L'URI dell'icona associata a questa riga.

name_short

string

Il nome breve di questa linea di trasporto pubblico. In genere, questo nome è 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 esadecimale.

vehicle

TransitVehicle

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

TransitPreferences

Preferenze per i percorsi basati su TRANSIT che influiscono sul percorso restituito.

Campi
allowed_travel_modes[]

TransitTravelMode

Un insieme di modalità di viaggio da utilizzare per ottenere un percorso TRANSIT. Il valore predefinito è costituito da tutte le modalità di viaggio supportate.

routing_preference

TransitRoutingPreference

Una preferenza di routing che, se specificata, influisce sul 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 il percorso 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 trasporti pubblici specificata.
BUS Viaggiare in autobus.
SUBWAY Viaggia in metropolitana.
TRAIN Viaggiare in treno.
LIGHT_RAIL Viaggia in metropolitana leggera o in tram.
RAIL Viaggiare in treno. È equivalente a una combinazione di SUBWAY, TRAIN e LIGHT_RAIL.

TransitStop

Informazioni su una fermata del trasporto pubblico.

Campi
name

string

Il nome della fermata di 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 del 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 dei trasporti locali.

TransitVehicleType

Il tipo di veicoli per i percorsi di trasporto pubblico.

Enum
TRANSIT_VEHICLE_TYPE_UNSPECIFIED Non utilizzato.
BUS Autobus.
CABLE_CAR Un veicolo che funziona su un cavo, solitamente a terra. Le funivie aeree possono essere di tipo GONDOLA_LIFT.
COMMUTER_TRAIN Treno suburbano.
FERRY Traghetto.
FUNICULAR Un veicolo che viene tirato su una ripida salita da un cavo. Una funicolare è in genere composta da due vetture, ciascuna delle quali funge da contrappeso per l'altra.
GONDOLA_LIFT Una funivia.
HEAVY_RAIL Treni pesanti.
HIGH_SPEED_TRAIN Treno ad alta velocità.
INTERCITY_BUS Autobus interurbano.
LONG_DISTANCE_TRAIN Treno a lunga percorrenza.
METRO_RAIL Metropolitana leggera.
MONORAIL Monorotaia.
OTHER Tutti gli altri veicoli.
RAIL Ferrovia.
SHARE_TAXI Il taxi condiviso è un tipo di autobus che può far scendere e salire i passeggeri ovunque lungo il percorso.
SUBWAY Metropolitana leggera sotterranea.
TRAM Metropolitana leggera sopraelevata.
TROLLEYBUS Filobus.

Unità

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

Enum
UNITS_UNSPECIFIED Unità di misura non specificate. L'impostazione predefinita è l'unità di misura dedotta dalla richiesta.
METRIC Unità di misura metriche.
IMPERIAL Unità di misura imperiali (britanniche).

VehicleEmissionType

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

Enum
VEHICLE_EMISSION_TYPE_UNSPECIFIED Nessun tipo di emissione specificato. Il valore predefinito è GASOLINE.
GASOLINE Veicolo alimentato a benzina.
ELECTRIC Veicolo elettrico.
HYBRID Veicolo con alimentazione ibrida (ad esempio benzina + elettrica).
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 al DRIVE RouteTravelMode.

Waypoint

Incapsula un waypoint. I waypoint segnano l'inizio e la fine di un percorso e includono le fermate intermedie lungo il percorso.

Campi
via

bool

Contrassegni questo waypoint come traguardo anziché come punto di sosta. Per ogni waypoint non intermedio nella richiesta, la risposta aggiunge una voce all'array legs per fornire i dettagli delle soste intermedie in quel tratto del viaggio. Imposta questo valore su true se vuoi che l'itinerario passi per questo waypoint senza fermarsi. I waypoint stradali non causano l'aggiunta di una voce all'array legs, ma indirizzano il viaggio attraverso il waypoint. Puoi impostare questo valore solo sui waypoint intermedi. La richiesta non va a buon fine se imposti questo campo sui waypoint terminal. 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 alla fermata dei veicoli, dove l'intenzione è il ritiro o il reso. Quando imposti questo valore, il percorso calcolato non includerà i waypoint non via su strade non adatte al ritiro e al reso. Questa opzione funziona solo per le modalità di viaggio DRIVE e TWO_WHEELER e quando location_type è Location.

side_of_road

bool

Indica che la posizione di questo waypoint è destinata a avere una preferenza per la fermata del veicolo su un determinato lato della strada. Quando imposti questo valore, il percorso passerà attraverso la località in modo che il veicolo possa fermarsi sul lato della strada verso cui è inclinata la località rispetto al 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 PDI associato al waypoint.

address

string

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