Package google.maps.routes.v1

Indice

RoutesPreferred

API Routes Preferred.

ComputeCustomRoutes

rpc ComputeCustomRoutes(ComputeCustomRoutesRequest) returns (ComputeCustomRoutesResponse)

Dato un insieme di tappe terminali e intermedie e un obiettivo del percorso, calcola il percorso migliore per l'obiettivo. Restituisce anche il percorso più veloce e quello più breve come percorsi di riferimento.

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 di percorsi dei campi separati da virgole. 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 delle distanze, delle durate, dei token e delle informazioni sui pedaggi dell'itinerario: X-Goog-FieldMask: routes.route.distanceMeters,routes.route.duration,routes.token,routes.route.travelAdvisory.tollInfo

Google sconsiglia l'utilizzo della maschera di risposta con carattere jolly (*) o la specifica della maschera di 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 tempi di calcolo aggiuntivi. 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, la dimensione della risposta sarà inferiore e quindi la velocità effettiva della rete sarà maggiore.
Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/maps-platform.routespreferred

Per saperne di più, consulta la panoramica di OAuth 2.0.
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 di percorsi dei campi separati da virgole. 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, 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 del campo, altrimenti tutti i messaggi sembreranno corretti. 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 tempi di calcolo aggiuntivi. 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, la dimensione della risposta sarà inferiore e quindi la velocità effettiva della rete sarà maggiore.
Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/maps-platform.routespreferred

Per saperne di più, consulta la panoramica di OAuth 2.0.
ComputeRoutes

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)

Restituisce la route principale insieme agli itinerari alternativi facoltativi, 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 (consulta i parametri URL e le intestazioni disponibili). Il valore è un elenco di percorsi dei campi separati da virgole. Consulta la documentazione dettagliata su come costruire 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 del campo di risposta con carattere jolly (*) o la specifica della maschera del 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 tempi di calcolo aggiuntivi. 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, la dimensione della risposta sarà inferiore e quindi la velocità effettiva della rete sarà maggiore.
Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/maps-platform.routespreferred

Per saperne di più, consulta la panoramica di OAuth 2.0.

ComputeCustomRoutesRequest

Messaggio di richiesta ComputeCustomRoutes.

Campi
origin

Waypoint

Obbligatorio. Tappa di origine.
destination

Waypoint

Obbligatorio. Waypoint di destinazione.
intermediates[]

Waypoint

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

RouteTravelMode

Facoltativo. Specifica la modalità di trasporto. Sono supportati solo DRIVE e "TWO_WHEELER".
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. Se imposti questo valore su un orario già trascorso, la richiesta non va a buon fine.
route_modifiers

RouteModifiers

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

RouteObjective

Obbligatorio. Un obiettivo del percorso da ottimizzare.
language_code

string

Facoltativo. Il codice lingua BCP-47, ad esempio "en-US" o "sr-Latn". Per saperne di più, 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 itinerario.
units

Units

Facoltativo. Specifica le unità di misura per i campi di visualizzazione. Ciò include il campo instruction in NavigationInstruction. Le unità di misura utilizzate per il percorso, la tratta, 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 richiesta.

ComputeCustomRoutesResponse

Messaggio di risposta ComputeCustomRoutes.

Campi
routes[]

CustomRoute

I percorsi "migliori" per lo scopo del percorso inserito.
fastest_route

CustomRoute

Il percorso di riferimento più veloce.
shortest_route

CustomRoute

Il percorso di riferimento più breve.
fallback_info

FallbackInfo

Informazioni di riserva per le route personalizzate.

FallbackInfo

Contiene le informazioni di riserva per ComputeCustomRoutes. ComputeCustomRoutes esegue due tipi di fallback:

  1. Se non riesce a calcolare l'itinerario utilizzando routing_preference richiesto dal cliente, passerà a un'altra modalità di routing. In questo caso, fallback_routing_mode e routing_mode_fallback_reason vengono utilizzati per comunicare la modalità di routing di riserva utilizzata, nonché il motivo del fallback.

  2. Se non riesce a calcolare un percorso "migliore" per l'obiettivo del percorso specificato dal cliente, potrebbe ripiegare su un altro obiettivo. fallback_route_objective viene utilizzato per comunicare l'obiettivo della route di riserva.

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.
routing_mode_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.
route_objective

FallbackRouteObjective

L'obiettivo del percorso utilizzato per la risposta. Se è stato attivato il fallback, la destinazione potrebbe essere diversa da quella dell'itinerario fornita nella richiesta originale del client.

FallbackRouteObjective

RouteObjective utilizzato per la risposta.

Enum
FALLBACK_ROUTE_OBJECTIVE_UNSPECIFIED Obiettivo della route di riserva non specificato.
FALLBACK_RATECARD_WITHOUT_TOLL_PRICE_DATA Se il cliente richiede RateCard e imposta include_tolls su true e Google non dispone dei dati sul prezzo del pedaggio per l'itinerario, l'API esegue il fallback a RateCard senza considerare il prezzo del pedaggio.

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:

  • Il numero di elementi (origini × destinazioni) non deve essere superiore a 625 in nessun caso.
  • Il numero di elementi (origini × destinazioni) non deve essere superiore a 100 se routing_preference è impostato su TRAFFIC_AWARE_OPTIMAL.
  • Il numero di waypoint (origini + destinazioni) specificati come place_id non deve essere superiore a 50.
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. Se imposti questo valore su un orario già trascorso, la richiesta non va a buon fine.

ComputeRoutesRequest

Messaggio di richiesta di ComputeRoutes.

Campi
origin

Waypoint

Obbligatorio. Tappa di origine.
destination

Waypoint

Obbligatorio. Waypoint di destinazione.
intermediates[]

Waypoint

Facoltativo. Un insieme di tappe lungo il percorso (esclusi i punti terminali), per 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. Se imposti questo valore su un orario già trascorso, la richiesta non va a buon fine.
compute_alternative_routes

bool

Facoltativo. Specifica se calcolare percorsi alternativi oltre al percorso. Non vengono restituiti itinerari alternativi per le richieste con tappe intermedie.
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 saperne di più, 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 itinerario.
units

Units

Facoltativo. Specifica le unità di misura per i campi di visualizzazione. Ciò include il campo instruction in NavigationInstruction. Le unità di misura utilizzate per il percorso, la tratta, 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 richiesta.
optimize_waypoint_order

bool

Se optimizeWaypointOrder è impostato su true, viene effettuato un tentativo di riordinare i waypoint intermedi specificati per ridurre al minimo il costo complessivo del percorso. Se uno dei waypoint intermedi è un waypoint, la richiesta non va a buon fine. Usa ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index per trovare il nuovo ordine. Se routes.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 è vuoto.

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.

CustomRoute

Contiene una route personalizzata calcolata in base all'obiettivo della route specificato dal cliente. CustomRoute contiene una route e un token di route, che possono essere passati a NavSDK per ricostruire la route personalizzata per la navigazione passo passo.

Campi
route

Route

Il percorso considerato "migliore" per l'obiettivo del percorso di input.
token

string

Token di percorso con codifica Base64 sicuro per il web che può essere passato a NavSDK, che consente a NavSDK di ricostruire il percorso durante la navigazione e, in caso di ricalcolo del percorso, di rispettare l'intenzione originale quando viene chiamato RoutesPreferred ComputeCustomRoutes. I clienti devono trattare questo token come un blob opaco.

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 è stato possibile completare il calcolo con la modalità di routing 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 per calcolare la risposta è stata utilizzata la modalità di routing TRAFFIC_UNAWARE.
FALLBACK_TRAFFIC_AWARE Indica che per calcolare la risposta è stata utilizzata la modalità di routing TRAFFIC_AWARE.

Località

Incapsula una posizione (un punto geografico e un orientamento facoltativo).

Campi
lat_lng

LatLng

Le coordinate geografiche del waypoint.
heading

Int32Value

La direzione della bussola associata alla direzione del flusso di traffico. Questo valore specifica il lato della strada da utilizzare 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 le modalità di viaggio DRIVE e TWO_WHEELER.

Manovra

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 il bivio a sinistra.
FORK_RIGHT Prendi il bivio 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.
DESTINATION Utilizzato per indicare l'arrivo a una destinazione.
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

Contiene 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 tipi:
encoded_polyline

string

La codifica della stringa della polilinea utilizzando l'algoritmo di codifica delle polilinee.
geo_json_linestring

Struct

Specifica una polilinea utilizzando il formato LineString GeoJSON.

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 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 rispetto a OVERVIEW, a scapito 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 comporta una latenza delle richieste inferiore rispetto all'utilizzo dell'opzione HIGH_QUALITY.

Inoltra

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

Campi
legs[]

RouteLeg

Un insieme di tratte (segmenti di percorso tra i waypoint) che compongono l'itinerario. Ogni tratta corrisponde al viaggio tra due waypoint non via. Ad esempio, un percorso senza tappe intermedie ha una sola tratta. Un itinerario 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 viaggio del percorso, 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 ComputeRoutesRequest.optimize_waypoint_order è impostato su true, questo campo contiene l'ordine ottimizzato dei waypoint intermedi. In caso contrario, questo campo è vuoto. Ad esempio, supponiamo che l'input sia Origine: Los Angeles; Intermedi: Dallas, Bangor, Phoenix; Destinazione: New York; e che l'ordine ottimizzato dei waypoint intermedi sia: Phoenix, Dallas, Bangor. Quindi questo campo contiene i valori [2, 0, 1]. L'indice inizia con 0 per il primo waypoint intermedio.

RouteLeg

Incapsula un segmento tra 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 nella tratta, calcolata senza tenere conto delle condizioni del traffico.
polyline

Polyline

La polilinea complessiva per questa tratta. Ciò include la polilinea di ogni step.
start_location

Location

La posizione di partenza di questa tappa. Potrebbe essere diverso da origin fornito. 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 di destinazione di questa tratta. Potrebbe essere diverso da destination fornito. 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 la possibile limitazione della zona di traffico ecc. in una tratta del percorso.

RouteLegStep

Contiene un segmento di un RouteLeg. Un passaggio corrisponde a una singola istruzione di navigazione. Le tappe di un itinerario 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 la possibile limitazione della zona di traffico in una tappa del percorso.

RouteLegStepTravelAdvisory

Contiene le informazioni aggiuntive di cui l'utente deve essere informato, ad esempio la possibile limitazione 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 di cui l'utente deve essere informato, ad esempio la possibile limitazione della zona di traffico ecc. in una tratta del percorso.

Campi
toll_info

TollInfo

Contiene informazioni sui pedaggi per lo specifico RouteLeg. Questo campo viene compilato solo se prevediamo che ci siano pedaggi sulla RouteLeg. 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 questo campo non esiste, non è presente alcun pedaggio sulla RouteLeg.
speed_reading_intervals[]

SpeedReadingInterval

Intervalli di lettura rapida che mostrano la densità del traffico. Applicabile in caso di preferenze di routing TRAFFIC_AWARE e TRAFFIC_AWARE_OPTIMAL. 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 rotta calcolate per una coppia origine/destinazione nell'API ComputeRouteMatrix. Questo proto può essere trasmesso in streaming al client.

Campi
origin_index

int32

Indice in base zero dell'origine nella richiesta.
destination_index

int32

Indice in base zero della destinazione nella richiesta.
status

Status

Codice di stato dell'errore per questo elemento.
condition

RouteMatrixElementCondition

Indica se il percorso è stato trovato o meno. Indipendentemente dallo stato.
distance_meters

int32

La distanza di viaggio del percorso, 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.

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, ad esempio distance_meters o duration, non verranno compilati nell'elemento.

RouteMatrixOrigin

Una singola origine per ComputeRouteMatrixRequest

Campi
waypoint

Waypoint

Obbligatorio. Tappa di origine
route_modifiers

RouteModifiers

Facoltativo. Modificatori per ogni percorso che ha questa posizione come 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 alle modalità di viaggio DRIVE e TWO_WHEELER.
avoid_highways

bool

Se impostato su true, evita le autostrade quando è ragionevole, dando la preferenza ai percorsi che non le includono. Si applica solo alle modalità di viaggio DRIVE e TWO_WHEELER.
avoid_ferries

bool

Se impostato su true, evita i traghetti, se ragionevole, dando la preferenza ai percorsi che non li includono. Si applica solo alle modalità di viaggio DRIVE e TWO_WHEELER.
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 alla modalità di viaggio WALK.
vehicle_info

VehicleInfo

Specifica le informazioni sul veicolo.
toll_passes[]

TollPass

Contiene informazioni sui telepedaggi. Se vengono forniti i telepedaggi, l'API tenta di restituire il prezzo del telepedaggio. Se i telepedaggi non vengono forniti, l'API li considera sconosciuti e tenta di restituire il prezzo in contanti. Si applica solo alle modalità di viaggio DRIVE e TWO_WHEELER.

RouteObjective

Contiene un obiettivo da ottimizzare in base a ComputeCustomRoutes.

Campi
Campo unione objective. L'obiettivo del percorso. objective può essere solo uno dei seguenti tipi:
rate_card

RateCard

L'obiettivo RateCard.

RateCard

Incapsula un obiettivo di percorso RateCard.

Campi
cost_per_minute

MonetaryCost

Facoltativo. Costo al minuto.
cost_per_km

MonetaryCost

Facoltativo. Costo per chilometro.
include_tolls

bool

Facoltativo. Se includere il costo del pedaggio nel costo complessivo.

MonetaryCost

Incapsula il costo utilizzato nel tariffario.

Campi
value

double

Obbligatorio. Il valore del costo in valuta locale dedotto dalla richiesta.

RouteTravelAdvisory

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

Campi
toll_info

TollInfo

Contiene informazioni sui pedaggi sul percorso. Questo campo viene compilato solo se prevediamo che ci siano pedaggi sul percorso. 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 questo campo non è impostato, prevediamo che non ci siano pedaggi sulla route.
speed_reading_intervals[]

SpeedReadingInterval

Intervalli di lettura rapida che mostrano la densità del traffico. Applicabile in caso di preferenze di routing TRAFFIC_AWARE e TRAFFIC_AWARE_OPTIMAL. 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).

RouteTravelMode

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

Enum
TRAVEL_MODE_UNSPECIFIED Nessuna modalità di trasporto specificata. Il valore predefinito è DRIVE.
DRIVE Viaggia in auto.
BICYCLE Viaggi 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.
TAXI

Viaggio in taxi autorizzato, che potrebbe consentire al veicolo di viaggiare su corsie riservate ai taxi in alcune zone.

La modalità TAXI è una funzionalità sperimentale. Se i clienti richiedono un itinerario in TAXI in una città in cui i dati sulle corsie dei taxi non sono disponibili, viene restituito un itinerario in AUTO.

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_AWARE.
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 del traffico medie indipendenti dal tempo, non sulle condizioni stradali attuali. Di conseguenza, gli itinerari potrebbero includere strade temporaneamente chiuse. I risultati di una determinata richiesta possono variare nel tempo a causa di modifiche alla rete stradale, aggiornamenti delle condizioni del traffico medie 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. 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, 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 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. In JSON, quando l'indice è 0, il campo sembra non compilato.
end_polyline_point_index

int32

L'indice finale di questo intervallo nella polilinea. In JSON, quando l'indice è 0, il campo sembra non compilato.
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 rallentamento rilevato.
SLOW Rallentamento rilevato, ma non si è formata una coda.
TRAFFIC_JAM È stato rilevato un ingorgo stradale.

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 dai caselli. In genere questo elenco contiene un solo elemento per i percorsi con pedaggi in una sola valuta. Per i viaggi internazionali, questo elenco potrebbe contenere più elementi per riflettere i pedaggi in valute diverse.

TollPass

Elenco dei telepedaggi in tutto il mondo che supportiamo.

Enum
TOLL_PASS_UNSPECIFIED Non utilizzato. Se viene utilizzato questo valore, la richiesta non riesce.
AU_ETOLL_TAG Uno dei tanti fornitori di telepedaggio di Sydney. https://www.myetoll.com.au
AU_EWAY_TAG Uno dei tanti fornitori di telepedaggio di Sydney. 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 Telepedaggio in Argentina. Per maggiori dettagli, visita la pagina https://telepase.com.ar
BR_AUTO_EXPRESO Telepedaggio in Brasile. Per ulteriori dettagli, visita la pagina https://www.autoexpreso.com
BR_CONECTCAR Telepedaggio in Brasile. Per ulteriori dettagli, visita la pagina https://conectcar.com.
BR_MOVE_MAIS Telepedaggio in Brasile. Per ulteriori dettagli, visita la pagina https://movemais.com.
BR_PASSA_RAPIDO Telepedaggio in Brasile. Per ulteriori dettagli, visita la pagina https://pasorapido.gob.do/
BR_SEM_PARAR Telepedaggio in Brasile. Per ulteriori dettagli, visita la pagina https://www.semparar.com.br.
BR_TAGGY Telepedaggio in Brasile. Per ulteriori dettagli, visita la pagina https://taggy.com.br.
BR_VELOE Telepedaggio in Brasile. Per ulteriori dettagli, visita la pagina https://veloe.com.br/site/onde-usar.
CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD Attraversamento del confine dal Canada agli Stati Uniti.
CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD Attraversamento del confine tra Canada e Stati Uniti.
CA_US_BLUE_WATER_EDGE_PASS Attraversamento del confine tra Ontario, Canada e Michigan, Stati Uniti.
CA_US_CONNEXION Attraversamento del confine tra Ontario, Canada e Michigan, Stati Uniti.
CA_US_NEXUS_CARD Attraversamento del confine dal Canada agli 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 ETC giapponese. 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 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 Messico 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. Uno dei tanti 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, Stati Uniti.
US_CA_FASTRAK CA, USA.
US_CA_FASTRAK_CAV_STICKER Indica che il conducente ha un abbonamento FasTrak oltre all'adesivo per veicoli a basse emissioni (CAV) rilasciato dal DMV. https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
US_CO_EXPRESSTOLL CO, Stati Uniti.
US_CO_GO_PASS CO, Stati Uniti.
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, Stati Uniti.
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. 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, 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 New Jersey, Stati Uniti.
US_NJ_EZPASSNJ New Jersey, Stati Uniti.
US_NY_EXPRESSPASS New York, Stati Uniti.
US_NY_EZPASSNY NY, USA.
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, USA
US_WV_NEWELL_TOLL_BRIDGE_TICKET WV, Stati Uniti.

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 (inglese).

VehicleEmissionType

Un insieme di valori che descrivono il tipo di emissione del veicolo. Si applica solo alla modalità di viaggio IN AUTO.

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 carburante ibrido (ad esempio benzina + elettricità).

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

Incapsula 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 controllo 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. I waypoint intermedi 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 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 viaggio 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 l'arresto del veicolo su un lato specifico 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 le modalità di viaggio "AUTO" e "DUE RUOTE".
Campo unione location_type. Diversi modi per rappresentare una località. location_type può essere solo uno dei seguenti tipi:
location

Location

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

string

L'ID luogo POI associato al waypoint.