Package google.maps.routing.v2

Indice

Route

L'API Routes.

MatricerouteRoute

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)

Recupera un elenco di origini e destinazioni e restituisce un flusso contenente informazioni sul percorso per ogni combinazione di origine e destinazione.

NOTA: questo metodo richiede di specificare una maschera da 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 le intestazioni e i parametri URL disponibili). Il valore è un elenco di percorsi di campo separati da virgole. Consulta questa documentazione dettagliata su come creare i percorsi dei campi.

Ad esempio, con questo metodo:

  • Maschera di campo di tutti i campi disponibili (per l'ispezione manuale): X-Goog-FieldMask: *
  • Maschera di campo delle durate, delle distanze, dello stato degli elementi, delle condizioni e degli indici degli elementi (un esempio di configurazione della 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 caratteri jolly (*) perché:

  • La selezione dei soli campi necessari consente al nostro server di salvare i cicli di calcolo, consentendoci di restituirti il risultato con una latenza inferiore.
  • La selezione dei soli campi necessari nel job di produzione garantisce prestazioni di latenza stabili. Potremmo aggiungere altri campi di risposta in futuro e questi nuovi campi potrebbero richiedere più tempo di calcolo. Se selezioni tutti i campi o se selezioni tutti i campi al livello più alto, potresti riscontrare un peggioramento del rendimento perché qualsiasi nuovo campo aggiunto verrà automaticamente incluso nella risposta.
  • Se selezioni solo i campi necessari, ottieni una dimensione di risposta inferiore e quindi una velocità effettiva di rete più elevata.
Route Compute

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)

Restituisce il percorso principale insieme a percorsi alternativi facoltativi, considerati un insieme di terminali e tappe intermedie.

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

Ad esempio, con questo metodo:

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

Google sconsiglia l'utilizzo della maschera di campo con caratteri jolly (*) o specifica la maschera di campo al livello superiore (routes) perché:

  • La selezione dei soli campi necessari consente al nostro server di salvare i cicli di calcolo, consentendoci di restituirti il risultato con una latenza inferiore.
  • La selezione dei soli campi necessari nel job di produzione garantisce prestazioni di latenza stabili. Potremmo aggiungere altri campi di risposta in futuro e questi nuovi campi potrebbero richiedere più tempo di calcolo. Se selezioni tutti i campi o se selezioni tutti i campi al livello più alto, potresti riscontrare un peggioramento del rendimento perché qualsiasi nuovo campo aggiunto verrà automaticamente incluso nella risposta.
  • Se selezioni solo i campi necessari, ottieni una dimensione di risposta inferiore e quindi una velocità effettiva di rete più elevata.

Richiesta di calcolo delle matrici

Messaggio di richiesta ComputeRouteMatrix

Campi
origins[]

RouteMatrixOrigin

Obbligatorio. Array di origini, che determina le righe della matrice di risposta. Sono previste diverse restrizioni alle dimensioni per la cardinalità di origini e destinazioni:

  • La somma del numero di origini + il numero di destinazioni specificate come place_id o address non deve essere maggiore di 50.
  • Il prodotto del numero di origini × il numero di destinazioni non deve comunque essere superiore a 625.
  • Il prodotto del numero di origini × numero di destinazioni non deve essere maggiore di 100 se routing_preference è impostato su TRAFFIC_AWARE_OPTIMAL.
  • Il prodotto del numero di origini × numero di destinazioni non deve essere maggiore di 100 se la modalità_viaggio è impostata su TRANSIT.
destinations[]

RouteMatrixDestination

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

RouteTravelMode

Campo facoltativo. Specifica la modalità di trasporto.
routing_preference

RoutingPreference

Campo facoltativo. Specifica come calcolare la route. Il server tenta di utilizzare la preferenza di routing selezionata per calcolare la route. Se la preferenza di routing genera un errore o una latenza particolarmente 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

Campo facoltativo. L'orario di partenza. Se non imposti questo valore, il valore predefinito corrisponderà all'ora in cui hai effettuato la richiesta. NOTA: puoi specificare un departure_time in passato solo quando RouteTravelMode è impostato su TRANSIT.
arrival_time

Timestamp

Campo 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

Campo facoltativo. Il codice lingua BCP-47, ad esempio "en-US" o "sr-Latn". Per ulteriori informazioni, visita il sito http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Visita la pagina Assistenza per le lingue per l'elenco delle lingue supportate. Se non specifichi questo valore, la lingua di visualizzazione viene dedotta dalla località della prima origine.
region_code

string

Campo facoltativo. Il codice regione, specificato come valore di due caratteri ccTLD ("dominio di primo livello"). Per ulteriori informazioni, visita https://en.wikipedia.org/wiki/List_of_Internet_top-level_domains#Country_code_top-level_domains.
extra_computations[]

ExtraComputation

Campo facoltativo. Un elenco di calcoli aggiuntivi che potrebbero essere utilizzati per completare la richiesta. Nota: questi calcoli aggiuntivi potrebbero restituire campi aggiuntivi nella risposta. Questi campi aggiuntivi devono essere specificati anche nella maschera del campo da restituire nella risposta.
traffic_model

TrafficModel

Campo facoltativo. Specifica le ipotesi da utilizzare per il calcolo del tempo di 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. Il valore predefinito è BEST_GUESS se il traffico è richiesto e TrafficModel non è specificato.
transit_preferences

TransitPreferences

Campo facoltativo. Specifica le preferenze che influenzano la route restituita per TRANSIT route. NOTA: puoi specificare un transit_preferences solo quando RouteTravelMode è impostato su TRANSIT.

Extracomputazione

Calcoli aggiuntivi da eseguire durante il completamento della richiesta.

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

Richiesta route route

Messaggio di richiesta ComputeRoutes.

Campi
origin

Waypoint

Obbligatorio. Waypoint di origine.
destination

Waypoint

Obbligatorio. Waypoint di destinazione.
intermediates[]

Waypoint

Campo facoltativo. Un insieme di tappe lungo il percorso (esclusi i punti di ritiro), per fermarsi o passare. Sono supportati fino a 25 tappe intermedie.
travel_mode

RouteTravelMode

Campo facoltativo. Specifica la modalità di trasporto.
routing_preference

RoutingPreference

Campo facoltativo. Specifica come calcolare la route. Il server tenta di utilizzare la preferenza di routing selezionata per calcolare la route. Se la preferenza di routing genera un errore o una latenza particolarmente lunga, verrà 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

Campo facoltativo. Specifica la tua preferenza per la qualità della polilinea.
polyline_encoding

PolylineEncoding

Campo facoltativo. Specifica la codifica preferita per la polilinea.
departure_time

Timestamp

Campo facoltativo. L'orario di partenza. Se non imposti questo valore, il valore predefinito corrisponderà all'ora in cui hai effettuato la richiesta. NOTA: puoi specificare un departure_time in passato solo quando RouteTravelMode è impostato su TRANSIT.
arrival_time

Timestamp

Campo 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.
compute_alternative_routes

bool

Campo facoltativo. Specifica se calcolare i percorsi alternativi oltre al percorso. Non vengono restituiti percorsi alternativi per le richieste con tappe intermedie.
route_modifiers

RouteModifiers

Campo facoltativo. Un insieme di condizioni da soddisfare che influiscono sul modo in cui vengono calcolati i percorsi.
language_code

string

Campo facoltativo. Il codice lingua BCP-47, ad esempio "en-US" o "sr-Latn". Per ulteriori informazioni, visita il sito http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Visita la pagina Assistenza per le lingue per l'elenco delle lingue supportate. Se non specifichi questo valore, la lingua di visualizzazione viene dedotta dal percorso della richiesta di percorso.
region_code

string

Campo facoltativo. Il codice regione, specificato come valore di due caratteri ccTLD ("dominio di primo livello"). Per ulteriori informazioni, visita https://en.wikipedia.org/wiki/List_of_Internet_top-level_domains#Country_code_top-level_domains.
units

Units

Campo 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 gamba, la distanza percorsa e la durata non sono interessate da questo valore. Se non specifichi questo valore, le unità di visualizzazione verranno dedotte dalla posizione della prima origine.
optimize_waypoint_order

bool

Campo facoltativo. Se è impostata su true, il servizio tenta di ridurre al minimo il costo complessivo del percorso riordinando i tappe intermedie intermedi. La richiesta non va a buon fine se uno qualsiasi dei tappe intermedie è di tipo via. Utilizza ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index per trovare il nuovo ordine. Se ComputeRoutesResponseroutes.optimized_intermediate_waypoint_index non è richiesto nell'intestazione X-Goog-FieldMask, la richiesta non riesce. Se il criterio optimize_waypoint_order è impostato su false, ComputeRoutesResponse.optimized_intermediate_waypoint_index sarà vuoto.
requested_reference_routes[]

ReferenceRoute

Campo facoltativo. Specifica le route di riferimento da calcolare come parte della richiesta oltre alla route predefinita. Una route di riferimento è una route con un obiettivo di calcolo del percorso diverso rispetto alla route predefinita. Ad esempio, un calcolo del percorso di riferimento FUEL_EFFICIENT prende in considerazione vari parametri che genererebbero un percorso ottimale per il consumo di carburante.
extra_computations[]

ExtraComputation

Campo facoltativo. Un elenco di calcoli aggiuntivi che potrebbero essere utilizzati per completare la richiesta. Nota: questi calcoli aggiuntivi potrebbero restituire campi aggiuntivi nella risposta. Questi campi aggiuntivi devono essere specificati anche nella maschera del campo da restituire nella risposta.
traffic_model

TrafficModel

Campo facoltativo. Specifica le ipotesi da utilizzare per il calcolo del tempo di traffico. Questa impostazione influisce sul valore restituito nel campo Durata in Route e RouteLeg che contiene il tempo previsto nel traffico in base alle medie storiche. TrafficModel è disponibile solo per le richieste che hanno impostato RoutingPreference su TRAFFIC_AWARE_OPTIMAL e RouteTravelMode su DRIVE. Il valore predefinito è BEST_GUESS se il traffico è richiesto e TrafficModel non è specificato.
transit_preferences

TransitPreferences

Campo facoltativo. Specifica le preferenze che influenzano la route restituita per TRANSIT route. NOTA: puoi specificare un transit_preferences solo quando RouteTravelMode è impostato su TRANSIT.

Extracomputazione

Calcoli aggiuntivi da eseguire durante il completamento della richiesta.

Enum
EXTRA_COMPUTATION_UNSPECIFIED Non utilizzato. Le richieste contenenti questo valore non andranno a buon fine.
TOLLS Informazioni sul pedaggio per i percorsi.
FUEL_CONSUMPTION Consumo stimato di carburante per i percorsi.
TRAFFIC_ON_POLYLINE Polilinee attente al traffico per i percorsi.
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS Istruzioni di navigazione presentate come stringa di testo HTML formattata. Questi contenuti sono da leggere così come sono. Questi contenuti sono solo a scopo di visualizzazione. Non analizzarlo in modo programmatico.

Percorso di riferimento

Una route di riferimento supportata in ComputeRoutesRequest.

Enum
REFERENCE_ROUTE_UNSPECIFIED Non utilizzato. Richieste contenenti questo valore non riuscite.
FUEL_EFFICIENT Percorso a basso consumo di carburante. I percorsi etichettati con questo valore sono determinati per l'ottimizzazione in base a parametri quali il consumo di carburante.

ComputeRoutesResponse

ComputeRoutes il messaggio di risposta.

Campi
routes[]

Route

Contiene un array di route calcolate (fino a tre) quando specifichi compute_alternatives_routes e contiene un solo percorso in caso contrario. Se questo array contiene più voci, la prima è la route più consigliata. Se la matrice è vuota, significa che non è stato trovato 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 utilizzare 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 tappe specificati come indirizzi.

Informazioni di riserva

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 dalla tua modalità preferita come riserva.

Campi
routing_mode

FallbackRoutingMode

Modalità di routing utilizzata per la risposta. Se è stato attivato il procedimento di riserva, la modalità potrebbe differire dalla preferenza di routing impostata nella richiesta 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 una risposta di riserva.

Motivo riserva

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 delle route con la modalità di routing che preferisci, ma siamo riusciti a restituire un risultato calcolato con una modalità alternativa.
LATENCY_EXCEEDED Non è stato possibile completare il calcolo della modalità di routing che hai scelto in tempo, ma abbiamo potuto restituire un risultato calcolato con una modalità alternativa.

Percorso di routing di riserva

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

Enum
FALLBACK_ROUTING_MODE_UNSPECIFIED Non utilizzato.
FALLBACK_TRAFFIC_UNAWARE Indica che il google.maps.routing.v2.RoutingPreference TRAFFIC_UNAWARE è stato utilizzato per calcolare la risposta.
FALLBACK_TRAFFIC_AWARE Indica che il RoutingPreference TRAFFIC_AWARE è stato utilizzato per calcolare la risposta.

Punto di accesso geocodificato

Dettagli sui luoghi utilizzati come tappe. Completato solo per i Waypoint degli indirizzi. Include i dettagli sui risultati della geocodifica allo scopo di determinare a cosa è stato geocodificato l'indirizzo.

Campi
geocoder_status

Status

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

string

Il tipo o i tipi di risultati, sotto forma di zero o più tag di tipo. Tipi supportati: https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types
partial_match

bool

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

string

L'ID del luogo per questo risultato.
intermediate_waypoint_request_index

int32

L'indice del waypoint intermedio corrispondente nella richiesta. Compilato solo se il Waypoint corrispondente è un Waypoint intermedio.

Risultati di geocodifica

Contiene GeocodedWaypoints per i punti di arrivo, di destinazione e intermedi. Completato solo per i Waypoint degli indirizzi.

Campi
origin

GeocodedWaypoint

Waypoint geocodificato dell'origine.
destination

GeocodedWaypoint

Waypoint geocodificato di destinazione.
intermediates[]

GeocodedWaypoint

Un elenco di tappe intermedie geocodificate contenenti un campo indice che corrisponde alla posizione zero-point del punto di arrivo nell'ordine in cui sono stati specificati nella richiesta.

Ora localizzata

Descrizione localizzata dell'ora.

Campi
time

LocalizedText

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

string

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

Località

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

Campi
lat_lng

LatLng

Le coordinate geografiche del punto di arrivo.
heading

Int32Value

L'intestazione della bussola associata alla direzione del flusso di traffico. Questo valore specifica il lato della strada per il prelievo e l'uscita. I valori delle intestazioni possono essere compresi tra 0 e 360, dove 0 specifica un'intestazione di direzione a nord, 90 specifica un'intestazione di scadenza a est e così via. Puoi utilizzare questo campo solo per DRIVE e TWO_WHEELER RouteTravelMode.

Manovra

Un insieme di valori che specifica l'azione di navigazione da eseguire per il passaggio corrente (ad es. svolta a sinistra, unione, dritto e così via).

Enum
MANEUVER_UNSPECIFIED Non utilizzato.
TURN_SLIGHT_LEFT Svolta leggermente a sinistra.
TURN_SHARP_LEFT Svolta tutto a sinistra.
UTURN_LEFT Fai una svolta a sinistra.
TURN_LEFT Svolta a sinistra.
TURN_SLIGHT_RIGHT Ruota leggermente a destra.
TURN_SHARP_RIGHT Svolta tutto a destra.
UTURN_RIGHT Fai una svolta a U corretta.
TURN_RIGHT Svolta a destra.
STRAIGHT Vai dritto.
RAMP_LEFT Prendi la rampa a sinistra.
RAMP_RIGHT Prendi la rampa giusta.
MERGE Unisci nel traffico.
FORK_LEFT Prendi la forcella a sinistra.
FORK_RIGHT Prendi la forcella giusta.
FERRY Prendi il traghetto.
FERRY_TRAIN Prendi il treno che porta al traghetto.
ROUNDABOUT_LEFT Svolta a sinistra alla rotonda.
ROUNDABOUT_RIGHT Svolta a destra alla rotatoria.
DEPART Manovra iniziale.
NAME_CHANGE Utilizzato per indicare un cambiamento del nome della via.

Incapsula le istruzioni di navigazione per un RouteLegStep

Campi
maneuver

Maneuver

Incapsula le istruzioni di navigazione per il passaggio corrente (ad es. gira a sinistra, unisci, dritto e così via). Questo campo determina quale icona visualizzare.
instructions

string

Istruzioni per la navigazione in questo passaggio.

Polilinea

Incapsula una polilinea codificata.

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

string

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

Struct

Specifica una polilinea utilizzando il formato LineString GeoJSON

Codifica di Polyline

Specifica il tipo 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 polilinea.
GEO_JSON_LINESTRING Specifica una polilinea utilizzando il formato LineString GeoJSON

Qualità Polilinea

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

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

Itinerario

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

Campi
route_labels[]

RouteLabel

Etichette di Route utili per identificare le proprietà specifiche del percorso da confrontare con altri.
legs[]

RouteLeg

Un insieme di gambe (segmenti di percorso tra punti intermedi) che compongono il percorso. Ogni gamba corrisponde alla corsa tra due Waypoints non via. Ad esempio, un percorso senza tappe intermedi ha una sola tratta. Una route che include un waypoint intermedio non via ha due tratti. Una rotta che include un Waypoint intermedio via ha una tratta. L'ordine delle gambe corrisponde all'ordine dei tappe da origin a intermediates e destination.
distance_meters

int32

La distanza di percorrenza del percorso, in metri.
duration

Duration

Il tempo necessario per seguire il percorso. Se imposti routing_preference su TRAFFIC_UNAWARE, il valore sarà 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 attraverso il percorso senza prendere in considerazione le condizioni del traffico.
polyline

Polyline

La polilinea del percorso complessivo. Questa polilinea è la polilinea combinata di tutti i legs.
description

string

Una descrizione del percorso.
warnings[]

string

Un array di avvisi da mostrare quando si mostra il percorso.
viewport

Viewport

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

RouteTravelAdvisory

Ulteriori informazioni sul percorso.
optimized_intermediate_waypoint_index[]

int32

Se imposti optimize_waypoint_order su true, questo campo contiene l'ordine ottimizzato dei tappe intermedie. In caso contrario, il campo è vuoto. Ad esempio, se specifichi un input di Origine: LA; Waypoint intermedi: Dallas, Bangor, Phoenix; Destinazione: New York; e l'ordine intermedio dei Waypoint ottimizzati è Phoenix, Dallas, Bangor, questo campo conterrà 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 di route con protezione Base64 e sicuro per il Web che può essere trasmesso all'SDK di navigazione, che consente all'SDK di ricostruire la route durante la navigazione e, in caso di cambio di percorso, di rispettare l'intenzione originale quando hai creato la route chiamando ComputeRoutes. I clienti devono considerare questo token come un blob opaco. Non è destinata alla lettura o alla mutazione. NOTA: Route.route_token è disponibile solo per le richieste che hanno impostato ComputeRoutesRequest.routing_preference su TRAFFIC_AWARE o TRAFFIC_AWARE_OPTIMAL. Route.route_token non è supportato per le richieste che hanno punti di via.

Valori RouteLocalized

Rappresentazioni di testo di determinate proprietà.

Campi
distance

LocalizedText

Distanza percorsa in forma di testo.
duration

LocalizedText

Durata che tiene conto delle condizioni del traffico, sotto forma di testo. Nota: se non hai richiesto informazioni sul traffico, il valore sarà lo stesso di static_duration.
static_duration

LocalizedText

La durata senza tenere conto delle condizioni del traffico, rappresentata sotto forma di testo.
transit_fare

LocalizedText

Tariffa per il trasporto pubblico rappresentata sotto forma di testo.

Etichetta route

Etichette di Route utili per identificare le proprietà specifiche del percorso da confrontare con altri.

Enum
ROUTE_LABEL_UNSPECIFIED Predefinito - Non utilizzato.
DEFAULT_ROUTE La route "migliore" predefinita restituita per il calcolo delle route.
DEFAULT_ROUTE_ALTERNATE Un'alternativa al percorso "migliore" predefinito. Route come questa verranno restituite quando compute_alternative_routes è specificato.
FUEL_EFFICIENT Percorso a basso consumo di carburante. I percorsi etichettati con questo valore sono determinati per l'ottimizzazione in base ai parametri Eco, come il consumo di carburante.

Gamba del percorso

Contiene un segmento tra i tappe non via.

Campi
distance_meters

int32

La distanza di percorrenza del percorso, in metri.
duration

Duration

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

Duration

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

Polyline

La polilinea complessiva di questa gamba che comprende la polilinea di ogni step.
start_location

Location

La posizione iniziale di questa gamba. Questa località potrebbe essere diversa da quella specificata in origin. Ad esempio, quando il origin specificato non si trova vicino a una strada, questo è un punto sulla strada.
end_location

Location

La posizione finale di questa gamba. Questa località potrebbe essere diversa da quella specificata in destination. Ad esempio, quando il destination specificato non si trova vicino a una strada, questo è un punto sulla strada.
steps[]

RouteLegStep

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

RouteLegTravelAdvisory

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

RouteLegLocalizedValues

Rappresentazioni di testo delle proprietà di RouteLeg.
steps_overview

StepsOverview

Panoramica dei passaggi della RouteLeg. Questo campo viene compilato solo per le route TRANSIT.

ValoriLegLocalizzati

Rappresentazioni di testo di determinate proprietà.

Campi
distance

LocalizedText

Distanza percorsa in forma di testo.
duration

LocalizedText

Durata che tiene conto delle condizioni del traffico, sotto forma di testo. Nota: se non hai richiesto informazioni sul traffico, il valore sarà lo stesso di static_duration.
static_duration

LocalizedText

La durata senza tenere conto delle condizioni del traffico, rappresentata sotto forma di testo.

Panoramica dei passaggi

Fornisce una panoramica delle informazioni relative a un elenco di RouteLegStep.

Campi
multi_modal_segments[]

MultiModalSegment

Riepiloga le informazioni sui diversi segmenti multimodali di RouteLeg.steps. Questo campo non viene compilato se RouteLeg non contiene segmenti multimodali nei passaggi.

Segmento multimodale

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

Campi
navigation_instruction

NavigationInstruction

Istruzioni di navigazione per il segmento multimodale.
travel_mode

RouteTravelMode

La modalità di viaggio del segmento multimodale.
step_start_index

int32

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

int32

L'indice RouteLegStep corrispondente che si trova alla fine di un segmento multimodale.

RouteLegStep

Contiene un segmento di RouteLeg. Un passaggio corrisponde a una singola istruzione di navigazione. Le gambe del percorso sono composte da gradini.

Campi
distance_meters

int32

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

Duration

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

Polyline

La polilinea associata a questo passaggio.
start_location

Location

La posizione iniziale 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 su cui l'utente deve essere informato, ad esempio possibili limitazioni di zona di traffico, su un passaggio di gamba.
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.

ValoriLocalizzatiP non

Rappresentazioni di testo di determinate proprietà.

Campi
distance

LocalizedText

Distanza percorsa in forma di testo.
static_duration

LocalizedText

La durata senza tenere conto delle condizioni del traffico, rappresentata sotto forma di testo.

Dettaglio RouteLegStepTransit

Informazioni aggiuntive per RouteLegStep relative a TRANSIT percorsi.

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 percorrere su questa linea come indicato sul veicolo o alla fermata di partenza. La direzione è spesso la stazione del capolinea.
headway

Duration

Specifica l'orario previsto come durata tra le partenze dalla stessa fermata in questo momento. Ad esempio, con un valore di 600 secondi per la differenza, ti aspetteresti un'attesa di dieci minuti se dovessi perdere l'autobus.
transit_line

TransitLine

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

int32

Il numero di fermate dalla partenza alla fermata dell'arrivo. Questo conteggio include la fermata di arrivo, ma esclude la fermata di partenza. Ad esempio, se il percorso parte dalla fermata A, attraversa le fermate B e C e arriva alla fermata D, stop_count restituisce 3.
trip_short_text

string

Il testo visualizzato negli orari e sui cartelli per identificare un viaggio con il trasporto pubblico ai passeggeri. Il testo deve identificare in modo univoco una corsa entro un giorno di servizio. Ad esempio "538" è il trip_short_text del treno Amtrak che parte da San Jose, CA, alle 15:10 nei giorni feriali, per Sacramento, in California.

Valori TransitLocalLocalizedValues

Descrizioni localizzate dei valori per RouteTransitDetails.

Campi
arrival_time

LocalizedTime

L'ora nella rappresentazione testuale formattata con il fuso orario corrispondente.
departure_time

LocalizedTime

L'ora nella rappresentazione testuale formattata con il fuso orario corrispondente.

Dettagli fermata trasporto pubblico

Dettagli sulle fermate del trasporto pubblico per RouteLegStep

Campi
arrival_stop

TransitStop

Informazioni sulla fermata di arrivo del passaggio.
arrival_time

Timestamp

L'orario di arrivo previsto del passaggio.
departure_stop

TransitStop

Informazioni sulla fermata del passaggio.
departure_time

Timestamp

L'orario di partenza stimato per il passaggio.

Avvertenza - RouteLegStepTravel

Contiene le informazioni aggiuntive su cui deve essere informato l'utente, ad esempio possibili limitazioni del traffico in un passaggio della gamba.

Campi
speed_reading_intervals[]

SpeedReadingInterval

NOTA: questo campo non è attualmente compilato.

Avvertenza RouteLegTravel

Contiene le informazioni aggiuntive su cui l'utente deve essere informato durante un passaggio, come le possibili limitazioni di traffico.

Campi
toll_info

TollInfo

Contiene informazioni sui pedaggi per l'RouteLeg specifico. Questo campo viene compilato solo se ci sono pedaggi per RouteLeg. Se questo campo viene impostato, ma il campo stimato del prezzo non è compilato, ci aspettiamo che la strada contenga pedaggi, ma non conosciamo un prezzo stimato. Se questo campo non esiste, non verrà addebitato alcun costo sulla RouteLeg.
speed_reading_intervals[]

SpeedReadingInterval

Intervalli di lettura della velocità che descrivono nel dettaglio la densità del traffico. Applicabile in caso di preferenze di routing di TRAFFIC_AWARE e TRAFFIC_AWARE_OPTIMAL. Gli intervalli coprono l'intera polilinea di RouteLeg senza sovrapposizioni. Il punto di inizio di un intervallo specificato è uguale 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).

Destinazione RouteMatrix

Un'unica destinazione per ComputeRouteMatrixRequest

Campi
waypoint

Waypoint

Obbligatorio. Waypoint di destinazione

Elemento RouteMatrix

Contiene le informazioni di percorso calcolate per una coppia di origine/destinazione nell'API ComputeRouteMatrix. Questo protocollo può essere trasmesso al client.

Campi
status

Status

Codice di stato di errore per questo elemento.
condition

RouteMatrixElementCondition

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

int32

La distanza di percorrenza del percorso, in metri.
duration

Duration

Il tempo necessario per seguire il percorso. Se imposti routing_preference su TRAFFIC_UNAWARE, il valore sarà 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 nel percorso senza tenere in considerazione le condizioni del traffico.
travel_advisory

RouteTravelAdvisory

Ulteriori informazioni sul percorso. Ad esempio, informazioni sulle restrizioni e informazioni sui pedaggi
fallback_info

FallbackInfo

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

LocalizedValues

Rappresentazioni di testo delle proprietà di RouteMatrixElement.
origin_index

int32

Indice a base zero dell'origine nella richiesta.
destination_index

int32

Indice a zero zero della destinazione nella richiesta.

Valori localizzati

Rappresentazioni di testo di determinate proprietà.

Campi
distance

LocalizedText

Distanza percorsa in forma di testo.
duration

LocalizedText

Durata rappresentata sotto forma di testo tenendo conto delle condizioni del traffico. Nota: se le informazioni sul traffico non sono state richieste, questo valore è lo stesso di static_duration.
static_duration

LocalizedText

Durata rappresentata sotto forma di testo senza tenere conto delle condizioni del traffico.
transit_fare

LocalizedText

Tariffa per il trasporto pubblico rappresentata sotto forma di testo.

Condizione elemento route matrix

La condizione del percorso restituito.

Enum
ROUTE_MATRIX_ELEMENT_CONDITION_UNSPECIFIED Utilizzato solo quando status dell'elemento non va bene.
ROUTE_EXISTS È stato trovato un percorso e le informazioni corrispondenti sono state inserite 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. Waypoint di origine
route_modifiers

RouteModifiers

Campo facoltativo. Modificatori per ogni percorso che accetta questa origine

Modificatori di route

Incapsula un insieme di condizioni facoltative da soddisfare nel calcolo dei percorsi.

Campi
avoid_tolls

bool

Se la norma è impostata su true, consente di evitare strade a pedaggio, ove ragionevoli, dando la priorità a percorsi che non includono strade a pedaggio. Si applica solo ai RouteTravelMode di DRIVE e TWO_WHEELER.
avoid_highways

bool

Se la norma è impostata su true, consente di evitare autostrade ove ragionevoli, dando priorità a percorsi che non contengono autostrade. Si applica solo ai RouteTravelMode di DRIVE e TWO_WHEELER.
avoid_ferries

bool

Se impostato su true, evita i traghetti dove è ragionevole, privilegiando le rotte che non contengono traghetti. Si applica solo a RouteTravelMode di DRIVE e TWO_WHEELER.
avoid_indoor

bool

Se il criterio è impostato su true, evita di navigare all'interno, ove ragionevole, dando la priorità a percorsi che non contengono questo tipo di navigazione. Si applica solo a WALK RouteTravelMode.
vehicle_info

VehicleInfo

Specifica le informazioni sul veicolo.
toll_passes[]

TollPass

Incapsula informazioni sui pedaggi. Se vengono forniti i pedaggi, l'API tenta di restituire il prezzo del pass. Se i pedaggi non vengono forniti, l'API considera il pedaggio come sconosciuto e tenta di restituire il prezzo in contanti. Si applica solo ai RouteTravelMode di DRIVE e TWO_WHEELER.

Avvertenza itinerario di viaggio

Contiene le informazioni aggiuntive su cui deve essere informato l'utente, ad esempio possibili limitazioni del traffico.

Campi
toll_info

TollInfo

Contiene informazioni sui pedaggi del percorso. Questo campo viene compilato solo se sono previste pedaggi lungo il percorso. Se questo campo viene impostato, ma il campo stimato di PricePrice non viene compilato, la route contiene pedaggi, ma il prezzo stimato è sconosciuto. Se questo campo non è impostato, non sono previsti pedaggi per il percorso.
speed_reading_intervals[]

SpeedReadingInterval

Intervalli di lettura della velocità che descrivono nel dettaglio la densità del traffico. Applicabile in caso di preferenze di routing di TRAFFIC_AWARE e TRAFFIC_AWARE_OPTIMAL. Gli intervalli coprono l'intera polilinea del percorso senza sovrapposizioni. Il punto di inizio di un intervallo specificato è uguale 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 previsto di carburante in microlitri.
route_restrictions_partially_ignored

bool

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

Money

Se presente, contiene la tariffa totale o i costi dei biglietti su questo percorso. Questa proprietà viene restituita solo per richieste TRANSIT e solo per i percorsi in cui sono disponibili informazioni sulle tariffe per tutti i passaggi relativi al trasporto pubblico.

Percorso dei percorsi

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

Enum
TRAVEL_MODE_UNSPECIFIED Nessuna modalità di viaggio specificata. Il valore predefinito è DRIVE.
DRIVE Si viaggia in autovettura.
BICYCLE Viaggiare in bicicletta.
WALK Viaggiare a piedi.
TWO_WHEELER Veicolo a motore a due ruote. Ad esempio, moto. Tieni presente che è diversa dalla modalità di viaggio a BICYCLE, che include la modalità a energia umana.
TRANSIT Viaggiare con percorsi dei mezzi pubblici, ove disponibili.

RoutingPreferenza.

Un insieme di valori che specifichi i fattori da considerare nel calcolo del percorso.

Enum
ROUTING_PREFERENCE_UNSPECIFIED Nessuna preferenza di routing specificata. Il valore predefinito è TRAFFIC_UNAWARE.
TRAFFIC_UNAWARE Calcola le route senza tenere 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 genera la latenza più bassa. Nota: per RouteTravelMode DRIVE e TWO_WHEELER la scelta di percorso e durata si basa sulla rete stradale e sulle condizioni di traffico medie indipendenti dal tempo. I risultati di una determinata richiesta possono variare nel tempo a causa di cambiamenti nella rete stradale, delle condizioni di traffico medie aggiornate e della natura distribuita del servizio. I risultati possono variare anche tra percorsi quasi equivalenti in qualsiasi momento o a seconda della frequenza.
TRAFFIC_AWARE Calcola i percorsi che prendono in considerazione le condizioni del traffico in tempo reale. A differenza di TRAFFIC_AWARE_OPTIMAL, alcune ottimizzazioni vengono applicate per ridurre significativamente la latenza.
TRAFFIC_AWARE_OPTIMAL Calcola i percorsi tenendo conto delle condizioni del traffico in tempo reale, senza applicare la maggior parte delle ottimizzazioni del rendimento. L'utilizzo di questo valore genera la massima latenza.

Intervallo lettura veloce

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

Campi
start_polyline_point_index

int32

L'indice iniziale di questo intervallo nella polilinea.
end_polyline_point_index

int32

L'indice finale di questo intervallo nella polilinea.

Campo unione speed_type.

speed_type può essere solo uno dei seguenti:
speed

Speed

Velocità del traffico in questo intervallo.

Velocità

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

Enum
SPEED_UNSPECIFIED Valore predefinito. Questo valore non è utilizzato.
NORMAL Velocità normale, non viene rilevato alcun rallentamento.
SLOW È stato rilevato un rallentamento, ma non si è verificato alcun ingorgo.
TRAFFIC_JAM Ingorgo rilevato.

Informazioni pedaggi

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

Campi
estimated_price[]

Money

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

Pass pedaggio

Elenco di pedaggi in tutto il mondo che supportiamo.

Enum
TOLL_PASS_UNSPECIFIED Non utilizzato. Se viene utilizzato questo valore, la richiesta non riesce.
AU_ETOLL_TAG Pass a Sydney. Per ulteriori dettagli, visita https://www.myetoll.com.au.
AU_EWAY_TAG Pass a Sydney. Ulteriori dettagli sono disponibili all'indirizzo https://www.tollpay.com.au.
AU_LINKT Pass pedaggio in Australia. Per ulteriori dettagli, visita https://www.linkt.com.au/.
AR_TELEPASE Pass a pedaggio in Argentina. Vedi ulteriori dettagli su https://telepase.com.ar
BR_AUTO_EXPRESO Pass a pagamento per il Brasile. Vedi ulteriori dettagli all'indirizzo https://www.autoexpreso.com
BR_CONECTCAR Pass a pagamento per il Brasile. Vedi ulteriori dettagli su https://conectcar.com.
BR_MOVE_MAIS Pass a pagamento per il Brasile. Vedi ulteriori dettagli all'indirizzo https://movemais.com.
BR_PASSA_RAPIDO Pass a pagamento per il Brasile. Vedi i dettagli aggiuntivi all'indirizzo https://pasorapido.gob.do/
BR_SEM_PARAR Pass a pagamento per il Brasile. Per ulteriori dettagli, visita https://www.semparar.com.br.
BR_TAGGY Pass a pagamento per il Brasile. Per ulteriori dettagli, visita https://taggy.com.br.
BR_VELOE Pass a pagamento per il Brasile. Ulteriori dettagli sono disponibili all'indirizzo https://veloe.com.br/site/onde-usar.
CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD Attraversamento del confine tra Canada e Stati Uniti.
CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD Attraversamento del confine tra Canada e Stati Uniti.
CA_US_BLUE_WATER_EDGE_PASS 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 tra Canada e Stati Uniti.
ID_E_TOLL Indonesia. Carta elettronica fornita da più banche per pagare i pedaggi. Tutte le carte elettroniche tramite banche hanno lo stesso costo, 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 lo stato HP.
MX_IAVE Pass per il pedaggio in Messico. https://iave.capufe.gob.mx/#/
MX_PASE Messico https://www.pase.com.mx
MX_QUICKPASS Messico https://operadoravial.com/quick-pass/
MX_SISTEMA_TELEPEAJE_CHIHUAHUA http://appsh.chihuahua.gob.mx/transparencia/?doc=/ingresos/TelepeajeFormato4.pdf
MX_TAG_IAVE Messico
MX_TAG_TELEVIA Compagnia di pedaggi per il Messico. Uno dei tanti attivi a Città del Messico. Per ulteriori dettagli, visita https://www.televia.com.mx.
MX_TELEVIA Compagnia di pedaggi per il Messico. Uno dei tanti attivi a Città del Messico. https://www.televia.com.mx
MX_VIAPASS Pass per il pedaggio in Messico. Vedi ulteriori informazioni su https://www.viapass.com.mx/viapass/web_home.aspx.
US_AL_FREEDOM_PASS AL, USA.
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 dispone di un pass FasTrak oltre all'adesivo CAV (Clean Air Vehicle) rilasciato dalla 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, USA.
US_IL_IPASS IL, USA.
US_IN_EZPASSIN IN, USA.
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, USA.
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. Obsoleto perché questo tipo di pass 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, USA.
US_NC_EZPASSNC NC, USA.
US_NC_PEACH_PASS NC, USA.
US_NC_QUICK_PASS NC, USA.
US_NH_EZPASSNH NH, USA.
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, USA.
US_PA_EZPASSPA PA, USA.
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, USA.
US_VA_EZPASSVA VA, Stati Uniti.
US_WA_BREEZEBY WA, USA.
US_WA_GOOD_TO_GO WA, USA.
US_WV_EZPASSWV WV, USA.
US_WV_MEMORIAL_BRIDGE_TICKETS WV, USA.
US_WV_NEWELL_TOLL_BRIDGE_TICKET WV, USA.

Modello di traffico

Specifica le ipotesi da utilizzare per il calcolo del tempo di 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 duration deve restituire la migliore stima del tempo di percorrenza in base alle informazioni note sulle condizioni di traffico storiche e sul traffico in tempo reale. Il traffico in tempo reale diventa sempre più importante in prossimità di departure_time.
PESSIMISTIC Indica che la durata del reso deve essere più lunga del tempo di percorrenza effettivo nella maggior parte dei giorni, anche se i giorni occasionali con condizioni del traffico particolarmente negative possono superare questo valore.
OPTIMISTIC Indica che la durata del reso deve essere inferiore al tempo di percorrenza effettivo nella maggior parte dei giorni, anche se i giorni occasionali con condizioni del traffico particolarmente positive potrebbero essere più rapidi rispetto a questo valore.

Azienda trasporto pubblico

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 formattato dell'azienda di trasporto pubblico.
uri

string

URI dell'azienda di trasporto pubblico.

Linea di trasporto pubblico

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

Campi
agencies[]

TransitAgency

L'azienda di trasporto che gestisce questa linea di trasporto pubblico.
name

string

Il nome completo di questa linea di trasporto pubblico, ad esempio "Via Verdi Corso Italia".
uri

string

L'URI di questa linea di trasporto pubblico indicato dall'azienda di trasporto pubblico.
color

string

Il colore di uso comune 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 sull'insegna per questa linea. Rappresentato in esadecimale.
vehicle

TransitVehicle

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

Preferenze di trasporto pubblico

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

Campi
allowed_travel_modes[]

TransitTravelMode

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

TransitRoutingPreference

Una preferenza di routing che, se specificata, influisce sulla route TRANSIT restituita.

TransitRoutingPreferenza

Specifica le preferenze di percorso per i percorsi del trasporto pubblico.

Enum
TRANSIT_ROUTING_PREFERENCE_UNSPECIFIED Nessuna preferenza specificata.
LESS_WALKING Indica che il percorso calcolato dovrebbe preferire un numero limitato di tratti di camminata.
FEWER_TRANSFERS Indica che il percorso calcolato dovrebbe preferire un numero limitato di cambi.

Mezzo di trasporto pubblico

Un insieme di valori utilizzato per specificare la modalità di trasporto pubblico.

Enum
TRANSIT_TRAVEL_MODE_UNSPECIFIED Nessuna modalità di trasporto pubblico specificata.
BUS Viaggia in autobus.
SUBWAY Viaggia in metropolitana.
TRAIN Viaggia in treno.
LIGHT_RAIL Viaggia in metropolitana leggera o tram.
RAIL Viaggia in treno. Equivale a una combinazione di SUBWAY, TRAIN e LIGHT_RAIL.

Fermata trasporto pubblico

Informazioni su una fermata del trasporto pubblico.

Campi
name

string

Il nome della fermata del trasporto pubblico.
location

Location

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

Trasporto pubblico

Informazioni su un veicolo utilizzato nei percorsi di trasporto pubblico.

Campi
name

LocalizedText

Il nome di questo veicolo, 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 locale per il trasporto pubblico.

Tipo di veicolo trasporto pubblico

Il tipo di veicoli per i percorsi del 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 del tipo GONDOLA_LIFT.
COMMUTER_TRAIN Ferrovia suburbana.
FERRY Traghetto.
FUNICULAR Un veicolo che sale su una pendenza. Una funicolare di solito è costituita da due carrozze, ciascuna delle quali funge da contrappeso per l'altra.
GONDOLA_LIFT Una funivia.
HEAVY_RAIL Ferrovia pesante.
HIGH_SPEED_TRAIN Treno ad alta velocità.
INTERCITY_BUS Autobus interurbano.
LONG_DISTANCE_TRAIN Treno a lunga percorrenza.
METRO_RAIL Metropolitana leggera.
MONORAIL Monorotaia.
OTHER Tutti gli altri veicoli.
RAIL Ferrovia.
SHARE_TAXI Il taxi condiviso è un tipo di autobus con la possibilità di scendere e prendere passeggeri ovunque sul suo percorso.
SUBWAY Metropolitana leggera sotterranea.
TRAM Metropolitana leggera fuori terra.
TROLLEYBUS Tram.

Unità

Un insieme di valori che specifica l'unità di misura utilizzata nel display.

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

Tipo di emissione del veicolo

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

Enum
VEHICLE_EMISSION_TYPE_UNSPECIFIED Nessun tipo di emissione specificato. Il valore predefinito è GASOLINE.
GASOLINE Veicolo a benzina/carburante.
ELECTRIC Veicolo alimentato a elettricità.
HYBRID Veicolo ibrido a carburante (ad es. benzina + elettrico).
DIESEL Veicolo diesel.

Info veicolo

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

Campi
emission_type

VehicleEmissionType

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

Waypoint

Incapsula un tappeto. I tappe consentono di contrassegnare sia l'inizio che la fine di un percorso e includono fermate intermedie lungo il percorso.

Campi
via

bool

Contrassegna questo tappa come un punto di riferimento anziché come punto di sosta. Per ogni waypoint non inviato tramite richiesta, la risposta aggiunge una voce all'array legs per fornire i dettagli delle fermate sulla tratta della corsa. Imposta questo valore su true quando vuoi che il percorso superi questa tappa senza fermarti. Tramite i tappe non viene aggiunta una voce all'array di legs, ma instradano il percorso attraverso la tappa. Puoi impostare questo valore solo per i tappe che sono intermedi. La richiesta non va a buon fine se imposti questo campo sui punti intermedi. Se il criterio ComputeRoutesRequest.optimize_waypoint_order viene impostato su vero, questo campo non può essere impostato su vero, altrimenti la richiesta non riesce.
vehicle_stopover

bool

Indica che il waypoint è destinato ai veicoli che si fermano, dove l'intenzione è di salita o di discesa. Quando imposti questo valore, il percorso calcolato non includerà tappe non via rispetto alle strade non adatte al ritiro e alla partenza. Questa opzione funziona solo per le modalità di viaggio DRIVE e TWO_WHEELER, mentre quando location_type è Location.
side_of_road

bool

Indica che la posizione di questo waypoint ha lo scopo di avere la preferenza che il veicolo si fermi in un determinato lato della strada. Quando imposti questo valore, il percorso passa attraverso la posizione in modo che il veicolo possa fermarsi sul lato della strada a cui si punta la posizione dal centro della strada. Questa opzione funziona solo per "DRIVE" e "TWO_WHEELER" RouteTravelMode.
Campo unione location_type. Diversi modi di 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 del PDI associato al tappeto.
address

string

Indirizzo leggibile o Plus Code. Vedi https://plus.codes per i dettagli.