Package google.maps.routing.v2

Indice

Route

L'API Routes.

Matrice ComputeRoute

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)

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

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

Ad esempio, con questo metodo:

  • Maschera dei campi di tutti i campi disponibili (per l'ispezione manuale): X-Goog-FieldMask: *
  • Maschera sul campo delle durate del percorso, delle distanze, dello stato degli elementi, delle condizioni e degli indici degli elementi (un esempio di configurazione di produzione): X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration

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

  • Selezionare solo i campi necessari aiuta il nostro server a salvare i cicli di calcolo, consentendoci di restituirti il risultato con una latenza più bassa.
  • Selezionare solo i campi necessari nel job di produzione assicura prestazioni di latenza stabili. In futuro potremmo aggiungere altri campi di risposta, che potrebbero richiedere un tempo di calcolo aggiuntivo. Se selezioni tutti i campi o selezioni tutti i campi al livello più alto, il rendimento potrebbe peggiorare perché tutti i nuovi campi che aggiungiamo verranno automaticamente inclusi nella risposta.
  • Selezionare solo i campi necessari riduce le dimensioni della risposta e, di conseguenza, la velocità effettiva di rete.
Route di calcolo

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)

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

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

Ad esempio, con questo metodo:

  • Maschera dei campi di tutti i campi disponibili (per l'ispezione manuale): X-Goog-FieldMask: *
  • Maschera sul 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 caratteri jolly (*) o specifica la maschera di campo al livello superiore (routes) perché:

  • Selezionare solo i campi necessari aiuta il nostro server a salvare i cicli di calcolo, consentendoci di restituirti il risultato con una latenza più bassa.
  • Selezionare solo i campi necessari nel job di produzione assicura prestazioni di latenza stabili. In futuro potremmo aggiungere altri campi di risposta, che potrebbero richiedere un tempo di calcolo aggiuntivo. Se selezioni tutti i campi o selezioni tutti i campi al livello più alto, il rendimento potrebbe peggiorare perché tutti i nuovi campi che aggiungiamo verranno automaticamente inclusi nella risposta.
  • Selezionare solo i campi necessari riduce le dimensioni della risposta e, di conseguenza, la velocità effettiva di rete.

richiesta di route Matrix Compute

Messaggio di richiesta ComputeRouteMatrix

Campi
origins[]

RouteMatrixOrigin

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

  • In ogni caso, il numero di elementi (origini × destinazioni) non deve essere maggiore di 625.
  • Il numero di elementi (origini × destinazioni) non deve essere maggiore di 100 se routing_preference è impostato su TRAFFIC_AWARE_OPTIMAL.
  • Il numero di tappe (origini + destinazioni) specificato come place_id non deve essere maggiore di 50.
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 il percorso. 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 extra 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 sarà l'ora in cui hai effettuato la richiesta. Se imposti questo valore su un'ora già verificatasi, la richiesta non andrà a buon fine.
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 del supporto per le lingue per l'elenco delle lingue supportate. Se non fornisci questo valore, la lingua di visualizzazione viene dedotta dalla località della prima origine.
region_code

string

Campo facoltativo. Il codice regione, specificato come valore di ccTLD ("dominio di primo livello") a due caratteri. Per ulteriori informazioni, visita la pagina 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 possono essere utilizzati per completare la richiesta. Nota: questi calcoli aggiuntivi potrebbero restituire campi aggiuntivi nella risposta. Questi campi aggiuntivi devono essere specificati anche nella maschera del campo da restituire nella risposta.

Extracomputazione

Calcolo aggiuntivo da eseguire durante il completamento della richiesta.

Enum
EXTRA_COMPUTATION_UNSPECIFIED Non utilizzato. Le richieste contenenti questo valore avranno esito negativo.
TOLLS Informazioni sul pedaggio per gli elementi della matrice.

Richiesta ComputeRoutes

Messaggio di richiesta ComputeRoutes.

Campi
origin

Waypoint

Obbligatorio. Punto di partenza.
destination

Waypoint

Obbligatorio. Waypoint di destinazione.
intermediates[]

Waypoint

Campo facoltativo. Un insieme di tappe lungo il percorso (esclusi i punti terminal), per fermarti 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 il percorso. 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 extra 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

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, per impostazione predefinita verrà utilizzato l'orario in cui hai effettuato la richiesta. Se imposti questo valore su un'ora già verificatasi, la richiesta non andrà a buon fine.
compute_alternative_routes

bool

Campo facoltativo. Specifica se calcolare i percorsi alternativi oltre al percorso. Non vengono restituiti percorsi alternativi per le richieste che hanno 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 del supporto per le lingue per l'elenco delle lingue supportate. Se non fornisci questo valore, la lingua di visualizzazione viene dedotta dalla posizione della richiesta di percorso.
region_code

string

Campo facoltativo. Il codice regione, specificato come valore di ccTLD ("dominio di primo livello") a due caratteri. Per ulteriori informazioni, visita la pagina 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. incluso il campo instruction in NavigationInstruction. Le unità di misura utilizzate per il percorso, la tratta, la distanza percorsa e la durata non sono influenzate da questo valore. Se non fornisci questo valore, le unità display vengono dedotte dalla posizione della richiesta.
requested_reference_routes[]

ReferenceRoute

Campo facoltativo. Specifica le route di riferimento da calcolare come parte della richiesta, oltre a quella predefinita. Un percorso di riferimento è un percorso con un obiettivo di calcolo di percorso diverso da quello predefinito. Ad esempio, un calcolo del percorso di riferimento FUEL_EFFICIENT tiene conto di vari parametri che genererebbero un percorso ottimale per il consumo di carburante.
extra_computations[]

ExtraComputation

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

Extracomputazione

Calcolo aggiuntivo da eseguire durante il completamento della richiesta.

Enum
EXTRA_COMPUTATION_UNSPECIFIED Non utilizzato. Le richieste contenenti questo valore avranno esito negativo.
TOLLS Informazioni sul pedaggio per i percorsi.
FUEL_CONSUMPTION Consumo stimato di carburante per i percorsi.
TRAFFIC_ON_POLYLINE Polilinee consapevoli per il traffico lungo i percorsi.

Percorso di riferimento

Una route di riferimento supportata su ComputeRoutesRequest.

Enum
REFERENCE_ROUTE_UNSPECIFIED Non utilizzato. Le richieste contenenti questo valore non vanno a buon fine.
FUEL_EFFICIENT Percorso a basso consumo di carburante. Le route etichettate con questo valore vengono determinate come ottimizzate per parametri come il consumo di carburante.

Risposta ComputeRoutes

ComputeRoutes il messaggio di risposta.

Campi
routes[]

Route

Contiene un array di route calcolate (fino a tre) quando specifichi compute_alternatives_routes e contiene una sola route 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 della route con tutte le preferenze di input, potrebbe utilizzare un metodo di calcolo diverso. Se viene utilizzata la modalità riserva, questo campo contiene informazioni dettagliate sulla risposta di riserva. In caso contrario, questo campo non è impostato.
geocoding_results

GeocodingResults

Contiene informazioni sulla risposta di geocodifica per i 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 di riserva.

Campi
routing_mode

FallbackRoutingMode

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

FallbackReason

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

Motivo di 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 tua modalità di routing preferita, ma siamo riusciti a restituire un risultato calcolato con una modalità alternativa.
LATENCY_EXCEEDED Non siamo riusciti a completare il calcolo con la modalità di routing che hai scelto in tempo, ma abbiamo potuto restituire un risultato calcolato utilizzando una modalità alternativa.

Modalità 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 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".

Punto di accesso geocodificato

Dettagli sulle località utilizzate come tappe. Compilato solo per i punti intermedi degli indirizzi. Include dettagli sui risultati di geocodifica ai fini di determinare l'indirizzo geocodificato.

Campi
geocoder_status

Status

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

string

I tipi di risultato, 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 far corrispondere parte dell'indirizzo richiesto. Ti consigliamo di esaminare la richiesta originale per verificare l'eventuale 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 tappe corrispondente è un punto intermedio.

Risultati di geocodifica

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

Campi
origin

GeocodedWaypoint

Waypoint geocodificato origine.
destination

GeocodedWaypoint

Waypoint geocodificato di destinazione.
intermediates[]

GeocodedWaypoint

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

Località

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

Campi
lat_lng

LatLng

Le coordinate geografiche del punto di accesso.
heading

Int32Value

La direzione della bussola associata alla direzione del flusso del traffico. Questo valore viene utilizzato per specificare il lato della strada da utilizzare per il salita e la discesa. I valori di intestazione possono essere compresi tra 0 e 360, dove 0 specifica l'intestazione del nord, 90 specifica il orientamento del 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 specifica l'azione di navigazione da intraprendere per il passaggio corrente (ad es. svolta a sinistra, unione, dritta e così via).

Enum
MANEUVER_UNSPECIFIED Non utilizzato.
TURN_SLIGHT_LEFT Gira leggermente verso sinistra.
TURN_SHARP_LEFT Gira tutto a sinistra.
UTURN_LEFT Fai una inversione a sinistra.
TURN_LEFT Gira a sinistra.
TURN_SLIGHT_RIGHT Gira leggermente verso destra.
TURN_SHARP_RIGHT Gira tutto a destra.
UTURN_RIGHT Fai una inversione a U verso destra.
TURN_RIGHT Gira a destra.
STRAIGHT Vai dritto.
RAMP_LEFT Prendi la rampa a sinistra.
RAMP_RIGHT Prendi la rampa giusta.
MERGE Entra nel traffico.
FORK_LEFT Prendi la forchetta sinistra.
FORK_RIGHT Prendi la forchetta giusta.
FERRY Prendi il traghetto.
FERRY_TRAIN Prendi il treno che porta al traghetto.
ROUNDABOUT_LEFT Alla sinistra, alla rotonda.
ROUNDABOUT_RIGHT Alla destra, alla rotonda.

Include istruzioni di navigazione per un RouteLegStep

Campi
maneuver

Maneuver

Riepiloga le istruzioni di navigazione del passaggio corrente (ad es. gira a sinistra, unisci, dritto e così via). Questo campo determina quale icona mostrare.
instructions

string

Istruzioni per navigare in questo passaggio.

Polilinea

Incapsula una polilinea codificata.

Campi
Campo di 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 mediante l'algoritmo di codifica delle polilinee.
geo_json_linestring

Struct

Specifica una polilinea utilizzando il formato LineString GeoJSON

Codifica Polyline

Specifica il tipo di polilinea da restituire.

Enum
POLYLINE_ENCODING_UNSPECIFIED Nessuna preferenza di tipo 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à (Polineline)

Un insieme di valori che specifica 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à, che viene composta utilizzando più punti rispetto a OVERVIEW, a un costo superiore. Utilizza questo valore quando hai bisogno di una maggiore precisione.
OVERVIEW Specifica una polilinea panoramica, che è composta da un numero ridotto di punti. Utilizza questo valore quando visualizzi una panoramica del percorso. L'utilizzo di questa opzione ha una latenza di richieste inferiore rispetto all'uso dell'opzione HIGH_QUALITY.

Itinerario

Incapsula un percorso costituito da una serie di tratti di strada collegati che uniscono i tappe iniziali, finali e intermedie.

Campi
route_labels[]

RouteLabel

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

RouteLeg

Una raccolta di gambe (segmenti di percorso tra tappe) che compongono il percorso. Ogni tratta corrisponde alla corsa tra due tappe non via. Ad esempio, una route senza tappe intermedie ha una sola estremità. Una route che include un waypoint intermedio non via ha due giri. Un percorso che include un sentiero intermedio via ha una tratto. L'ordine delle gambe corrisponde all'ordine dei tappe da origin a intermediates e destination.
distance_meters

int32

La distanza percorsa del percorso, in metri.
duration

Duration

Il tempo necessario per esplorare il percorso. Se imposti routing_preference su TRAFFIC_UNAWARE, questo 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 considerare le condizioni del traffico.
polyline

Polyline

La polilinea del percorso generale. Questa polilinea sarà la polilinea combinata di tutti i legs.
description

string

Una descrizione del percorso.
warnings[]

string

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

Viewport

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

RouteTravelAdvisory

Ulteriori informazioni sul percorso.
route_token

string

Token di percorso sicuro per il Web con codifica Web che può essere trasmesso a NavigazioneSDK, che consente all'SDK di navigazione di ricostruire il percorso durante la navigazione e, in caso di reindirizzamento, onorare l'intenzione originale quando viene richiamato Routes ComputeRoutes. I clienti devono considerare questo token come un blob opaco. NOTA: Route.route_token è disponibile soltanto per le richieste che hanno impostato ComputeRoutesRequest.routing_preference su TRAFFIC_AWARE o TRAFFIC_AWARE_OPTIMAL. Inoltre, Route.route_token non è supportato per le richieste che hanno punti di via.

Etichetta route

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

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 viene specificato ComputeRoutesRequest.compute_alternative_routes.
FUEL_EFFICIENT Percorso a basso consumo di carburante. Le route etichettate con questo valore vengono determinate come ottimizzate per i parametri Eco, ad esempio il consumo di carburante.

Gamba percorso

Incapsula un segmento tra tappe non via.

Campi
distance_meters

int32

La distanza percorsa dal percorso, in metri.
duration

Duration

Il tempo necessario per spostarti nella 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 per questa gamba. Viene inclusa la polilinea di ogni step.
start_location

Location

La posizione iniziale di questa gamba. Potrebbe essere diverso da quello fornito (origin). Ad esempio, questo è il punto sulla strada quando origin non è vicino a una strada.
end_location

Location

La posizione finale di questa gamba. Potrebbe essere diverso da quello fornito (destination). Ad esempio, questo è il punto sulla strada quando destination non è vicino a una strada.
steps[]

RouteLegStep

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

RouteLegTravelAdvisory

Racchiude le informazioni aggiuntive di cui l'utente deve essere informato, ad esempio la possibile restrizione della zona di traffico e così via su una tratta di percorso.

RouteLegStep

Incapsula un segmento di RouteLeg. Un passaggio corrisponde a una singola istruzione di navigazione. Le parti del percorso sono composte da una serie di passaggi.

Campi
distance_meters

int32

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

Duration

La durata del viaggio in questo passaggio senza considerare le condizioni del traffico. In alcuni casi, questo campo potrebbe non avere 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

Include le informazioni aggiuntive di cui l'utente deve essere informato, ad esempio la possibile limitazione di zona di traffico in un passaggio della gamba.

Avviso di RouteLegStepTravel

Include le informazioni aggiuntive di cui l'utente deve essere informato, ad esempio la possibile limitazione di zona di traffico in un passaggio della gamba.

Campi
speed_reading_intervals[]

SpeedReadingInterval

NOTA: questo campo non è compilato al momento.

Avviso di RouteLegTravel

Racchiude le informazioni aggiuntive di cui l'utente deve essere informato, ad esempio la possibile restrizione della zona di traffico e così via su una tratta di percorso.

Campi
toll_info

TollInfo

Include informazioni sui pedaggi per la RouteLeg specifica. Questo campo viene compilato solo se prevediamo che i pedaggi siano presenti su RouteLeg. Se questo campo è impostato, ma il sottocampo stima_prezzo non è compilato, prevediamo che la strada contenga pedaggi, ma non conosciamo un prezzo stimato. Se questo campo non esiste, non è previsto alcun pedaggio per la 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 del RouteLg senza sovrapposizione. Il punto iniziale di un intervallo specificato è uguale al punto finale dell'intervallo precedente.

Esempio:

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

Destinazione matrice

Un'unica destinazione per ComputeRouteMatrixRequest

Campi
waypoint

Waypoint

Obbligatorio. Waypoint di destinazione

Elemento Matrice Route

Incapsula 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 percorsa del percorso, in metri.
duration

Duration

Il tempo necessario per esplorare il percorso. Se imposti routing_preference su TRAFFIC_UNAWARE, questo 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 considerare le condizioni del traffico.
travel_advisory

RouteTravelAdvisory

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

FallbackInfo

In alcuni casi, quando il server non è in grado di calcolare il percorso con le preferenze indicate per questa particolare coppia di origine/destinazione, può tornare a utilizzare una modalità di calcolo diversa. Se viene utilizzata la modalità riserva, questo campo contiene informazioni dettagliate sulla risposta di riserva. In caso contrario, questo campo non è impostato.
origin_index

int32

Indice basato su zero dell'origine nella richiesta.
destination_index

int32

Indice basato sulla destinazione della richiesta.

Condizione Element MatrixElement

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.

Origine origine route

Un'unica origine per ComputeRouteMatrixRequest

Campi
waypoint

Waypoint

Obbligatorio. Waypoint origine
route_modifiers

RouteModifiers

Campo facoltativo. Modificatori per tutte le route che utilizzano questa origine

Modificatori

Include un insieme di condizioni facoltative da soddisfare per il calcolo dei percorsi.

Campi
avoid_tolls

bool

Consente di specificare se evitare le strade a pedaggio, se ragionevoli. Verrà data la preferenza ai percorsi che non contengono strade a pedaggio. Si applica solo alle modalità di viaggio DRIVE e TWO_WHEELER.
avoid_highways

bool

Specifica se evitare le autostrade quando è ragionevole. Verrà data la preferenza ai percorsi che non contengono autostrade. Si applica solo alle modalità di viaggio DRIVE e TWO_WHEELER.
avoid_ferries

bool

Specifica se evitare i traghetti ove ragionevole. Verrà data la preferenza ai percorsi che non contengono viaggi in traghetto. Si applica solo alle modalità di viaggio DRIVE e TWO_WHEELER.
avoid_indoor

bool

Specifica se evitare di navigare in ambienti interni ove ragionevole. Verrà data la preferenza ai percorsi che non contengono la navigazione in ambienti interni. Si applica solo alla modalità di viaggio WALK.
vehicle_info

VehicleInfo

Specifica le informazioni del veicolo.
toll_passes[]

TollPass

Include informazioni sui pedaggi. Se vengono forniti i pedaggi, l'API tenta di restituire il prezzo del pass. Se non vengono forniti i pedaggi, l'API considera il pedaggio come sconosciuto e cerca di restituire il prezzo in contanti. Si applica solo alle modalità di viaggio DRIVE e TWO_WHEELER.

RouteTravelAdvisory

Racchiude le informazioni aggiuntive di cui l'utente deve essere informato, ad esempio la possibile limitazione di zona di traffico e così via.

Campi
toll_info

TollInfo

Include informazioni sui pedaggi lungo il percorso. Questo campo viene compilato solo se prevediamo che i pedaggi siano presenti lungo il percorso. Se questo campo è impostato, ma il sottocampo stima_prezzo non è compilato, prevediamo che la strada contenga pedaggi, ma non conosciamo un prezzo stimato. Se questo campo non viene configurato, prevediamo che non venga addebitato alcun costo per la route.
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 iniziale di un intervallo specificato è uguale al punto finale dell'intervallo precedente.

Esempio:

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

int64

La previsione del consumo di carburante in microlitri.

PercorsoPercorso

Un insieme di valori utilizzato per specificare la modalità di viaggio. NOTA: i percorsi A PIÙ Devi mostrare questo avviso all'utente per tutti i percorsi a piedi, in bicicletta e a due ruote che mostri nell'app.

Enum
TRAVEL_MODE_UNSPECIFIED Nessuna modalità di viaggio specificata. Il valore predefinito è DRIVE.
DRIVE Viaggia in auto.
BICYCLE Viaggia in bicicletta.
WALK Viaggia a piedi.
TWO_WHEELER Veicolo a motore a due ruote. Ad esempio, moto. Tieni presente che questo differisce dalla modalità di viaggio BICYCLE che copre la modalità a comando umano.

Preferenza di routing

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

Enum
ROUTING_PREFERENCE_UNSPECIFIED Nessuna preferenza di routing specificata. Il valore predefinito è TRAFFIC_UNAWARE.
TRAFFIC_UNAWARE Calcola i percorsi senza prendere in considerazione le condizioni del traffico in tempo reale. Idoneo quando le condizioni del traffico non sono importanti o non sono applicabili. L'utilizzo di questo valore produce la latenza più bassa possibile. Nota: per RouteTravelMode DRIVE e TWO_WHEELER la scelta di percorso e durata si basa sulla rete stradale e sulle condizioni di traffico indipendenti dal tempo. I risultati di una determinata richiesta possono variare nel tempo a causa di cambiamenti della rete stradale, condizioni di traffico medie aggiornate e natura distribuita del servizio. Inoltre, i risultati possono variare tra percorsi quasi equivalenti in qualsiasi momento o con una certa frequenza.
TRAFFIC_AWARE Calcola i percorsi tenendo in considerazione le condizioni del traffico in tempo reale. A differenza di TRAFFIC_AWARE_OPTIMAL, alcune ottimizzazioni vengono applicate per ridurre in modo significativo la latenza.
TRAFFIC_AWARE_OPTIMAL Calcola i percorsi tenendo in considerazione le condizioni del traffico in tempo reale, senza applicare la maggior parte delle ottimizzazioni del rendimento. L'utilizzo di questo valore genera la latenza massima.

Intervallo lettura veloce

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

Campi
start_polyline_point_index

int32

L'indice iniziale di questo intervallo nella polilinea.
end_polyline_point_index

int32

L'indice finale di questo intervallo nella polilinea.

Campo di unione speed_type.

speed_type può essere solo uno dei seguenti:
speed

Speed

Velocità del traffico in questo intervallo.

Velocità

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

Enum
SPEED_UNSPECIFIED Valore predefinito. Questo valore non è 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 le informazioni sul pedaggio su una Route o su un RouteLeg.

Campi
estimated_price[]

Money

L'importo monetario dei pedaggi per la route o la route corrispondente. Questo elenco contiene un importo in denaro per ogni valuta che dovrebbe essere addebitata dalle stazioni pedaggi. In genere questo elenco contiene una sola voce per i percorsi con pedaggi in una valuta. Per i viaggi internazionali, questo elenco può contenere più voci che riflettono i pedaggi in valute diverse.

Pass pedaggio

Elenco di pedaggi disponibili in tutto il mondo che supportiamo.

Enum
TOLL_PASS_UNSPECIFIED Non utilizzato. Se questo valore viene utilizzato, la richiesta non andrà a buon fine.
AU_ETOLL_TAG Pedaggio di Sydney. Ulteriori dettagli sono disponibili all'indirizzo https://www.myetoll.com.au.
AU_EWAY_TAG Pedaggio di Sydney. Ulteriori dettagli sono disponibili all'indirizzo https://www.tollpay.com.au.
AU_LINKT Pass per l'Australia. Ulteriori dettagli sono disponibili all'indirizzo https://www.linkt.com.au/.
AR_TELEPASE Pass pedaggio Argentina. Scopri di più all'indirizzo https://telepase.com.ar
BR_AUTO_EXPRESO Pass pedaggio per il Brasile. Vedi ulteriori dettagli all'indirizzo https://www.autoexpreso.com
BR_CONECTCAR Pass pedaggio per il Brasile. Ulteriori dettagli sono disponibili all'indirizzo https://conectcar.com.
BR_MOVE_MAIS Pass pedaggio per il Brasile. Vedi ulteriori dettagli all'indirizzo https://movemais.com.
BR_PASSA_RAPIDO Pass pedaggio per il Brasile. Vedi ulteriori dettagli all'indirizzo https://pasorapido.gob.do/.
BR_SEM_PARAR Pass pedaggio per il Brasile. Ulteriori dettagli sono disponibili all'indirizzo https://www.semparar.com.br.
BR_TAGGY Pass pedaggio per il Brasile. Ulteriori dettagli sono disponibili all'indirizzo https://taggy.com.br.
BR_VELOE Pass pedaggio per il Brasile. Ulteriori dettagli sono disponibili all'indirizzo https://veloe.com.br/site/onde-usar.
CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD Transazione di confine tra Canada e Stati Uniti.
CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD Transazione di confine tra Canada e Stati Uniti.
CA_US_BLUE_WATER_EDGE_PASS Ontario, Canada, Michigan, attraversamento di confine con gli Stati Uniti.
CA_US_CONNEXION Ontario, Canada, Michigan, attraversamento di confine con gli Stati Uniti.
CA_US_NEXUS_CARD Transazione di confine tra Canada e Stati Uniti.
ID_E_TOLL Indonesia. Carta elettronica fornita da più banche per il pagamento dei pedaggi. Tutte le e-card tramite le banche vengono addebitate allo stesso modo, quindi è necessario un solo valore enum. Esempio: 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 stato di HP.
MX_IAVE Pass per pedaggi in Messico. https://iave.capufe.gob.mx/#/
MX_PASE Messico https://www.pase.com.mx
MX_QUICKPASS Messico https://operadoravial.com/quick-pass/
MX_SISTEMA_TELEPEAJE_CHIHUAHUA http://appsh.chihuahua.gob.mx/transparencia/?doc=/ingresos/TelepeajeFormato4.pdf
MX_TAG_IAVE Messico
MX_TAG_TELEVIA Compagnia di pedaggi in Messico Uno dei tanti che opera a Città del Messico. Ulteriori dettagli sono disponibili all'indirizzo https://www.televia.com.mx.
MX_TELEVIA Compagnia di pedaggi in Messico Uno dei tanti presenti a Città del Messico. https://www.televia.com.mx
MX_VIAPASS Pass per pedaggi in Messico Ulteriori dettagli sono disponibili all'indirizzo https://www.viapass.com.mx/viapass/web_home.json.
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 ha un pass FasTrak oltre all'adesivo Clean Air Vehicle (CAV) 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 in Florida, Stati Uniti.
US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD in Florida, Stati Uniti.
US_FL_EPASS in Florida, Stati Uniti.
US_FL_GIBA_TOLL_PASS in Florida, Stati Uniti.
US_FL_LEEWAY in Florida, Stati Uniti.
US_FL_SUNPASS in Florida, Stati Uniti.
US_FL_SUNPASS_PRO in Florida, Stati Uniti.
US_IL_EZPASSIL IL, USA.
US_IL_IPASS IL, USA.
US_IN_EZPASSIN IN, USA.
US_KS_BESTPASS_HORIZON KS, USA.
US_KS_KTAG KS, USA.
US_KS_NATIONALPASS KS, USA.
US_KS_PREPASS_ELITEPASS KS, USA.
US_LA_GEAUXPASS Los Angeles, Stati Uniti.
US_LA_TOLL_TAG Los Angeles, Stati Uniti.
US_MA_EZPASSMA MA, USA.
US_MD_EZPASSMD MD, USA.
US_ME_EZPASSME ME, USA.
US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD MI, USA.
US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG MI, USA.
US_MI_IQ_PROX_CARD MI, USA.
US_MI_MACKINAC_BRIDGE_MAC_PASS MI, USA.
US_MI_NEXPRESS_TOLL MI, USA.
US_MN_EZPASSMN MN, Stati Uniti.
US_NC_EZPASSNC NC, USA
US_NC_PEACH_PASS NC, USA
US_NC_QUICK_PASS NC, USA
US_NH_EZPASSNH NH, Stati Uniti.
US_NJ_DOWNBEACH_EXPRESS_PASS NJ, Stati Uniti.
US_NJ_EZPASSNJ NJ, Stati Uniti.
US_NY_EXPRESSPASS NY, USA.
US_NY_EZPASSNY NY, USA.
US_OH_EZPASSOH OH, USA.
US_PA_EZPASSPA PA, Stati Uniti.
US_RI_EZPASSRI RI, USA.
US_SC_PALPASS SC, 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_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, Stati Uniti.
US_WA_GOOD_TO_GO WA, Stati Uniti.
US_WV_EZPASSWV WV, USA.
US_WV_MEMORIAL_BRIDGE_TICKETS WV, USA.
US_WV_NEWELL_TOLL_BRIDGE_TICKET WV, USA.

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 per veicoli

Un insieme di valori che descrivono il tipo di emissioni del veicolo. Si applica solo alla modalità di viaggio DRIVE.

Enum
VEHICLE_EMISSION_TYPE_UNSPECIFIED Nessun tipo di emissione specificato. Il valore predefinito è GASOLINE.
GASOLINE Veicolo con benzina/benzina.
ELECTRIC Veicolo elettrico.
HYBRID Veicolo ibrido a gas (ad esempio benzina + elettrico).
DIESEL Veicolo diesel.

Informazioni veicolo

Incapsula le informazioni del veicolo, ad esempio l'ultimo carattere della targa.

Campi
emission_type

VehicleEmissionType

Descrive il tipo di emissione del veicolo. Si applica solo alla modalità di viaggio DRIVE.

Waypoint

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

Campi
via

bool

Contrassegna questo passaggio come un punto di riferimento piuttosto che un punto di sosta. Per ogni waypoint non passabile presente nella richiesta, la risposta aggiunge una voce all'array legs per fornire i dettagli delle fermate della corsa. Imposta questo valore su true quando vuoi che il percorso passi attraverso questo punto di via senza fermarti. Tramite i tappe non viene aggiunta una voce all'array di legs, ma instradano il percorso attraverso la via. Puoi impostare questo valore soltanto su tappe intermedie. La richiesta non va a buon fine se imposti questo campo su tappe per terminali. Se il criterio ComputeRoutesRequest.optimize_waypoint_order è impostato su true, questo campo non può essere impostato su true; in caso contrario, la richiesta non andrà a buon fine.
vehicle_stopover

bool

Indica che il punto di via dei veicoli è pensato per fermarsi a un punto in cui è quello di salire o scendere. Quando imposti questo valore, il percorso calcolato non includerà tappe non via lungo le strade non adatte alla salita e alla riconsegna. Questa opzione funziona solo per le modalità di viaggio DRIVE e TWO_WHEELER e quando location_type è location.
side_of_road

bool

Indica che la posizione di questo Waypoint deve avere la preferenza per consentire al veicolo di fermarsi su un determinato lato della strada. Quando imposti questo valore, il percorso attraversa la posizione in modo che il veicolo possa fermarsi sul lato della strada per cui la posizione è orientata dal centro della strada. Questa opzione funziona solo per le modalità di viaggio "DRIVE" e "TWO_WHEELER".
Campo di unione location_type. Diversi modi per rappresentare una località. location_type può essere solo uno dei seguenti:
location

Location

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

string

L'ID del luogo di interesse associato al punto di accesso.
address

string

Un indirizzo leggibile o un Plus Code. Per informazioni dettagliate, visita la pagina https://plus.codes.