Package google.maps.routes.v1

Indice

RoutesPreferred

L'API Routes Preferred.

ComputeCustomRoutes

rpc ComputeCustomRoutes(ComputeCustomRoutesRequest) returns (ComputeCustomRoutesResponse)

Dato un insieme di tappe terminali e intermedi e un obiettivo di percorso, calcola il percorso migliore per raggiungerlo. Restituisce anche il percorso più veloce e il percorso più breve come percorsi di riferimento.

NOTA: questo metodo richiede l'indicazione di una maschera per il campo della 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 dei campi separati da virgole. Consulta questa documentazione dettagliata su come creare i percorsi dei campi.

Ad esempio, in questo metodo:

  • Maschera per tutti i campi disponibili (per l'ispezione manuale): X-Goog-FieldMask: *
  • Maschera per il campo delle informazioni su distanze di percorso, durate, token e pedaggi: X-Goog-FieldMask: routes.route.distanceMeters,routes.route.duration,routes.token,routes.route.travelAdvisory.tollInfo

Google sconsiglia l'utilizzo della maschera per il campo di risposta con caratteri jolly (*) o di specificarne la maschera 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. In futuro potremmo aggiungere altri campi di risposta e questi nuovi campi potrebbero richiedere tempi di calcolo aggiuntivi. Se selezioni tutti i campi o tutti i campi al livello più alto, potresti riscontrare un peggioramento delle prestazioni perché qualsiasi nuovo campo che aggiungiamo verrà incluso automaticamente nella risposta.
  • La selezione solo dei campi necessari comporta una riduzione delle dimensioni della risposta e, di conseguenza, una velocità effettiva di rete superiore.
Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.
ComputeRouteMatrix

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 l'indicazione di una maschera per il campo della 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 dei campi separati da virgole. Consulta questa documentazione dettagliata su come creare i percorsi dei campi.

Ad esempio, in questo metodo:

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

È fondamentale includere status nella maschera del campo, altrimenti tutti i messaggi sembreranno corretti. Google sconsiglia l'utilizzo della maschera del campo di risposta con 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. In futuro potremmo aggiungere altri campi di risposta e questi nuovi campi potrebbero richiedere tempi di calcolo aggiuntivi. Se selezioni tutti i campi o tutti i campi al livello più alto, potresti riscontrare un peggioramento delle prestazioni perché qualsiasi nuovo campo che aggiungiamo verrà incluso automaticamente nella risposta.
  • La selezione solo dei campi necessari comporta una riduzione delle dimensioni della risposta e, di conseguenza, una velocità effettiva di rete superiore.
Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.
ComputeRoutes

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)

Restituisce il percorso principale insieme a percorsi alternativi facoltativi, in base a una serie di tappe terminal e intermedi.

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

Ad esempio, in questo metodo:

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

Google sconsiglia l'utilizzo della maschera per il campo di risposta con caratteri jolly (*) oppure specifica la maschera del 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. In futuro potremmo aggiungere altri campi di risposta e questi nuovi campi potrebbero richiedere tempi di calcolo aggiuntivi. Se selezioni tutti i campi o tutti i campi al livello più alto, potresti riscontrare un peggioramento delle prestazioni perché qualsiasi nuovo campo che aggiungiamo verrà incluso automaticamente nella risposta.
  • La selezione solo dei campi necessari comporta una riduzione delle dimensioni della risposta e, di conseguenza, una velocità effettiva di rete superiore.
Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.

ComputeCustomRoutesRequest

Messaggio di richiesta ComputeCustomRoutes.

Campi
origin

Waypoint

Obbligatorio. Waypoint di partenza.
destination

Waypoint

Obbligatorio. Waypoint di destinazione.
intermediates[]

Waypoint

Campo facoltativo. Una serie di tappe lungo il percorso (esclusi i punti terminali), che consentono di fermarsi o di passare. Sono supportati fino a 25 tappe intermedi.
travel_mode

RouteTravelMode

Campo facoltativo. Specifica la modalità di trasporto. Al momento è supportato solo Drive.
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 molto lunga, viene restituito un errore. In futuro, potremmo implementare un meccanismo di riserva per utilizzare un'opzione diversa quando l'opzione preferita non dà un risultato valido. 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 sarà l'ora in cui hai effettuato la richiesta. Se imposti questo valore su un orario già verificato, la richiesta non andrà a buon fine.
route_modifiers

RouteModifiers

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

RouteObjective

Obbligatorio. Un obiettivo di percorso per cui ottimizzare.
language_code

string

Campo facoltativo. Il codice lingua BCP-47, ad esempio "en-US" o "sr-Latn". Per ulteriori informazioni, vedi http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Consulta la pagina Supporto delle lingue per consultare l'elenco delle lingue supportate. Se non specifichi questo valore, la lingua di visualizzazione viene dedotta dalla località della richiesta di route.
units

Units

Campo facoltativo. Specifica le unità di misura per i campi di visualizzazione. Questo include il campo instruction in NavigationInstruction. Le unità di misura utilizzate per percorso, tratta, distanza dei passi e durata non sono interessate da questo valore. Se non specifichi questo valore, le unità di visualizzazione vengono dedotte dalla località della richiesta.

ComputeCustomRoutesResponse

Messaggio di risposta ComputeCustomRoutes.

Campi
routes[]

CustomRoute

I percorsi "migliori" per l'obiettivo del percorso di input.
fastest_route

CustomRoute

Il percorso di riferimento più veloce.
shortest_route

CustomRoute

Il percorso di riferimento più breve.
fallback_info

FallbackInfo

Informazioni di riserva per le route personalizzate.

FallbackInfo

Incapsula le informazioni di fallback per ComputeCustomRoutes. ComputeCustomRoutes esegue due tipi di fallback:

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

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

Campi
routing_mode

FallbackRoutingMode

Modalità di routing utilizzata per la risposta. Se è stata attivata la modalità di riserva, la modalità potrebbe essere diversa da quella delle preferenze di routing impostate nella richiesta del client originale.
routing_mode_reason

FallbackReason

Il motivo per cui è stata utilizzata la risposta di riserva al posto della risposta originale. Questo campo viene compilato solo quando viene attivata la modalità di riserva e viene restituita la risposta di riserva.
route_objective

FallbackRouteObjective

L'obiettivo del percorso utilizzato per la risposta. Se è stato attivato il fallback, l'obiettivo potrebbe essere diverso dall'obiettivo di route fornito nella richiesta originale del client.

FallbackRouteObjective

RouteObjective utilizzato per la risposta.

Enum
FALLBACK_ROUTE_OBJECTIVE_UNSPECIFIED Obiettivo del percorso di riserva non specificato.
FALLBACK_RATECARD_WITHOUT_TOLL_PRICE_DATA Se il cliente richiede il RateCard e imposta include_tolls su true e Google non dispone di dati sui prezzi dei pedaggi per il percorso, l'API utilizza il RateCard senza considerare il prezzo del pedaggio.

ComputeRouteMatrixRequest

Messaggio di richiesta ComputeRouteMatrix

Campi
origins[]

RouteMatrixOrigin

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

  • Il numero di elementi (origini × destinazioni) non deve essere superiore a 625.
  • Il numero di elementi (origini × destinazioni) non deve essere superiore a 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 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 molto lunga, viene restituito un errore. In futuro, potremmo implementare un meccanismo di riserva per utilizzare un'opzione diversa quando l'opzione preferita non dà un risultato valido. 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 corrisponde all'ora in cui hai effettuato la richiesta. Se imposti questo valore su un orario già verificato, la richiesta non andrà a buon fine.

ComputeRoutesRequest

Messaggio di richiesta ComputeRoutes.

Campi
origin

Waypoint

Obbligatorio. Waypoint di partenza.
destination

Waypoint

Obbligatorio. Waypoint di destinazione.
intermediates[]

Waypoint

Campo facoltativo. Una serie di tappe lungo il percorso (esclusi i punti terminali), che consentono di fermarsi o di passare. Sono supportati fino a 25 tappe intermedi.
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 molto lunga, viene restituito un errore. In futuro, potremmo implementare un meccanismo di riserva per utilizzare un'opzione diversa quando l'opzione preferita non dà un risultato valido. 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 sarà l'ora in cui hai effettuato la richiesta. Se imposti questo valore su un orario già verificato, la richiesta non andrà a buon fine.
compute_alternative_routes

bool

Specifica se calcolare percorsi alternativi in aggiunta al percorso.
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, vedi http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Consulta la pagina Supporto delle lingue per consultare l'elenco delle lingue supportate. Se non specifichi questo valore, la lingua di visualizzazione viene dedotta dalla località della richiesta di route.
units

Units

Campo facoltativo. Specifica le unità di misura per i campi di visualizzazione. Questo include il campo instruction in NavigationInstruction. Le unità di misura utilizzate per percorso, tratta, distanza dei passi e durata non sono interessate da questo valore. Se non specifichi questo valore, le unità di visualizzazione vengono dedotte dalla località della richiesta.
optimize_waypoint_order

bool

Se OptimizeWaypointOrder è impostato su true, viene effettuato un tentativo di riordinamento dei punti intermedi intermedi specificati per ridurre al minimo il costo complessivo del percorso. Se uno qualsiasi dei punti intermedi intermedi si trova attraverso un tappa, la richiesta non va a buon fine. Utilizza ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index per trovare il nuovo ordine. Se route.optimized_intermediate_waypoint_index non è richiesta nell'intestazione X-Goog-FieldMask, la richiesta non va a buon fine. Se OptimizeWaypointOrder è impostato su false, ComputeRoutesResponse.optimized_intermediate_waypoint_index è vuoto.

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 una sola route quando non lo specifichi. Quando questo array contiene più voci, la prima è il percorso più consigliato. Se l'array è vuoto, significa che non è stato trovato alcun percorso.
fallback_info

FallbackInfo

In alcuni casi, quando il server non è in grado di calcolare i risultati delle route con tutte le preferenze di input, potrebbe utilizzare un metodo di calcolo diverso per farlo. Quando viene utilizzata la modalità di riserva, questo campo contiene informazioni dettagliate sulla risposta di riserva. In caso contrario, il campo non viene configurato.

CustomRoute

Incapsula una route personalizzata calcolata in base all'obiettivo di route specificato dal cliente. CustomRoute contiene un token e uno di route, che possono essere trasmessi a NavSDK per ricostruire il percorso personalizzato per la navigazione passo passo.

Campi
route

Route

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

string

Token di route sicuro per il Web con codifica Base64 che può essere trasmesso a NavSDK, che consente a NavSDK di ricostruire il percorso durante la navigazione e, in caso di rielaborazione del percorso, rispetta l'intenzione originale quando viene chiamato RoutesPreferred ComputeCustomRoutes. I clienti dovrebbero considerare questo token come un blob opaco.

FallbackInfo

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

Campi
routing_mode

FallbackRoutingMode

Modalità di routing utilizzata per la risposta. Se è stata attivata la modalità di riserva, la modalità potrebbe essere diversa da quella delle preferenze di routing impostate nella richiesta del client originale.
reason

FallbackReason

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

FallbackReason

Motivi per l'utilizzo della risposta di riserva.

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

FallbackRoutingMode

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

Enum
FALLBACK_ROUTING_MODE_UNSPECIFIED Non utilizzato.
FALLBACK_TRAFFIC_UNAWARE Indica che la modalità di routing "TRAFFIC_UNAWARE" è stata utilizzata per calcolare la risposta.
FALLBACK_TRAFFIC_AWARE Indica che la modalità di routing "TRAFFIC_AWARE" è stata utilizzata per calcolare la risposta.

Località

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

Campi
lat_lng

LatLng

Le coordinate geografiche del tappa.
heading

Int32Value

L'intestazione della bussola associata alla direzione del flusso del traffico. Questo valore viene utilizzato per specificare il lato della strada da utilizzare per il prelievo e il ritiro. I valori di intestazione possono essere compresi tra 0 e 360, dove 0 indica la direzione verso nord, 90 indica la direzione verso nord e così via. Puoi utilizzare questo campo solo per le modalità di viaggio DRIVE e TWO_WHEELER.

Manovra

Un insieme di valori che specificano l'azione di navigazione da intraprendere per il passaggio corrente (ad es. svolta a sinistra, unisci, dritto 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 svolta a U verso sinistra.
TURN_LEFT Gira a sinistra.
TURN_SLIGHT_RIGHT Gira leggermente verso destra.
TURN_SHARP_RIGHT Gira tutto a destra.
UTURN_RIGHT Fai una svolta a U verso destra.
TURN_RIGHT Gira a destra.
STRAIGHT Vai dritto.
RAMP_LEFT Prendi lo svincolo a sinistra.
RAMP_RIGHT Prendi la rampa a destra.
MERGE fondersi con il traffico.
FORK_LEFT Prendi il bivio a sinistra.
FORK_RIGHT Prendi la forchetta a destra.
FERRY Prendi il traghetto.
FERRY_TRAIN Prendi il treno che porta al traghetto.
ROUNDABOUT_LEFT Gira a sinistra alla rotonda.
ROUNDABOUT_RIGHT Gira a destra alla rotonda.
Campi
maneuver

Maneuver

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

string

Istruzioni per l'esplorazione di questo passaggio.

Polilinea

Incapsula una polilinea codificata.

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

string

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

Struct

Specifica una polilinea utilizzando il formato LineString GeoJSON

PolylineEncoding

Specifica il tipo preferito di polilinea da restituire.

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

PolylineQuality

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

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

Route

Incapsula un percorso, costituito da una serie di tratti di strada collegati che uniscono i punti di partenza, di arrivo e intermedi.

Campi
legs[]

RouteLeg

Un insieme di tratti (segmenti di percorso tra i tappe) che compongono il percorso. Ogni tratto corrisponde alla corsa tra due Waypoint non via. Ad esempio, un percorso senza tappe intermedie ha una sola tratta. Un percorso che include un tappa intermedia non via ha due tappe. Un percorso che include un tappa intermedia via ha una tratta. L'ordine dei tratti corrisponde all'ordine dei Waypoint da origin a intermediates a destination.
distance_meters

int32

La distanza da percorrere del percorso, in metri.
duration

Duration

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

Polyline

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

string

Una descrizione del percorso.
warnings[]

string

Un array di avvisi da mostrare quando viene visualizzato il percorso.
viewport

Viewport

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

RouteTravelAdvisory

Informazioni aggiuntive sul percorso.
optimized_intermediate_waypoint_index[]

int32

Se ComputeRoutesRequest.optimize_waypoint_order è impostato su true, questo campo contiene l'ordine ottimizzato dei Waypoint intermedi, altrimenti il campo è vuoto. Ad esempio, supponiamo che l'input sia Origine: LA; Intermedi: Dallas, Bangor, Phoenix; Destinazione: New York; e l'ordine dei punti intermedi ottimizzato sia Phoenix, Dallas, Bangor. Questo campo contiene i valori [2, 0, 1]. L'indice inizia con 0 per il primo tappa intermedio.

RouteLeg

Incapsula un segmento tra tappe non via.

Campi
distance_meters

int32

La distanza da percorrere per la tratta del percorso, in metri.
duration

Duration

Il tempo necessario per navigare nella gamba. Se route_preference è impostato su TRAFFIC_UNAWARE, questo valore equivale 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, calcolata senza tenere conto delle condizioni del traffico.
polyline

Polyline

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

Location

La posizione di partenza di questa tappa. Potrebbe essere diverso dal valore origin fornito. Ad esempio, quando l'elemento origin fornito non è vicino a una strada, significa che è un punto della strada.
end_location

Location

La posizione finale di questa tappa. Potrebbe essere diverso dal valore destination fornito. Ad esempio, quando l'elemento destination fornito non è vicino a una strada, significa che è un punto della 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 di cui è necessario informare l'utente, come eventuali limitazioni delle zone a traffico e così via, nella tratta del percorso.

RouteLegStep

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

Campi
distance_meters

int32

La distanza da percorrere per questo passo, in metri. In alcuni casi, questo campo potrebbe non avere un valore.
static_duration

Duration

La durata del viaggio attraverso questo passaggio senza tenere in considerazione 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

Contiene le informazioni aggiuntive di cui è necessario informare l'utente, come la possibile limitazione delle zone di traffico in un passo della tappa.

RouteLegStepTravelAdvisory

Contiene le informazioni aggiuntive di cui è necessario informare l'utente, come la possibile limitazione delle zone di traffico in un passo della tratta.

Campi
speed_reading_intervals[]

SpeedReadingInterval

Intervalli di lettura della velocità che forniscono dettagli sulla densità del traffico. Applicabile in caso di preferenze di routing TRAFFIC_AWARE e TRAFFIC_AWARE_OPTIMAL. Gli intervalli coprono l'intera polilinea di RouteLegStep senza sovrapposizioni. Il punto iniziale di un intervallo specificato corrisponde al punto finale dell'intervallo precedente.

Esempio:

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

RouteLegTravelAdvisory

Contiene le informazioni aggiuntive di cui è necessario informare l'utente, come eventuali limitazioni delle zone a traffico e così via, nella tratta del percorso.

Campi
toll_info

TollInfo

Contiene le informazioni sui pedaggi sul RouteLeg specifico. Questo campo viene compilato solo se è previsto il pagamento di pedaggi sulla RouteLeg. Se questo campo è impostato, ma il campo secondario Estimated_price non è compilato, prevediamo che la strada contenga pedaggi, ma non sappiamo un prezzo stimato. Se questo campo non esiste, non è previsto alcun pedaggio sulla RouteLeg.
speed_reading_intervals[]

SpeedReadingInterval

Intervalli di lettura della velocità che forniscono dettagli sulla densità del traffico. Applicabile in caso di preferenze di routing TRAFFIC_AWARE e TRAFFIC_AWARE_OPTIMAL. Gli intervalli coprono l'intera polilinea di RouteLg senza sovrapposizioni. Il punto iniziale di un intervallo specificato corrisponde al punto finale dell'intervallo precedente.

Esempio:

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

RouteMatrixDestination

Una singola destinazione per ComputeRouteMatrixRequest

Campi
waypoint

Waypoint

Obbligatorio. Waypoint di destinazione

RouteMatrixElement

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

Campi
origin_index

int32

Indice in base zero dell'origine nella richiesta.
destination_index

int32

Indice in base zero della destinazione nella richiesta.
status

Status

Codice di stato di errore per questo elemento.
condition

RouteMatrixElementCondition

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

int32

La distanza da percorrere del percorso, in metri.
duration

Duration

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

RouteTravelAdvisory

Informazioni aggiuntive sul percorso. Ad esempio: informazioni sulle limitazioni e sui pedaggi
fallback_info

FallbackInfo

In alcuni casi, quando il server non è in grado di calcolare la route con le preferenze specificate per questa particolare coppia 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, il campo non viene configurato.

RouteMatrixElementCondition

La condizione della route che viene restituita.

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

RouteMatrixOrigin

Una singola origine per ComputeRouteMatrixRequest

Campi
waypoint

Waypoint

Obbligatorio. Waypoint di partenza
route_modifiers

RouteModifiers

Campo facoltativo. Modificatori per ogni percorso che prende questa come origine

RouteModifiers

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

Campi
avoid_tolls

bool

Specifica se evitare le strade a pedaggio dove è ragionevole. 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, ove ragionevole. La preferenza verrà data ai percorsi che non contengono autostrade. Si applica solo alle modalità di viaggio DRIVE e TWO_WHEELER.
avoid_ferries

bool

Consente di specificare se evitare i traghetti, ove ragionevole. La preferenza verrà data ai percorsi che non consentono gli spostamenti con traghetti. Si applica solo alle modalità di viaggio DRIVE e TWO_WHEELER.
avoid_indoor

bool

Consente di specificare se evitare la navigazione al chiuso dove è ragionevole. Verrà data la preferenza ai percorsi che non contengono la navigazione interna. Si applica solo alla modalità di viaggio WALK.
vehicle_info

VehicleInfo

Specifica le informazioni del veicolo.
toll_passes[]

TollPass

Contiene le informazioni sui pass per pedaggi. Se vengono forniti i pedaggi, l'API prova a restituire il prezzo del pass. Se i pass pedaggi non vengono forniti, l'API considera il pedaggio come sconosciuto e tenta di restituire il prezzo in contanti. Si applica solo alle modalità di viaggio Drive e TWO_WHEELER.

RouteObjective

Incapsula un obiettivo per l'ottimizzazione da parte di ComputeCustomRoutes.

Campi
rate_card

RateCard

L'obiettivo del tariffario.

RateCard

Incapsula l'obiettivo di percorso di un tariffario.

Campi
cost_per_minute

MonetaryCost

Campo facoltativo. Costo al minuto.
cost_per_km

MonetaryCost

Campo facoltativo. Costo per chilometro.
include_tolls

bool

Campo facoltativo. Indica se includere il costo del pedaggio nel costo complessivo.

MonetaryCost

Include il costo utilizzato nel tariffario.

Campi
value

double

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

RouteTravelAdvisory

Contiene le informazioni aggiuntive di cui l'utente dovrebbe essere informato, come eventuali limitazioni delle zone a traffico e così via.

Campi
toll_info

TollInfo

Contiene informazioni sui pedaggi sul percorso. Questo campo viene compilato solo se è previsto il pedaggio sul percorso. Se questo campo è impostato, ma il campo secondario Estimated_price non è compilato, prevediamo che la strada contenga pedaggi, ma non sappiamo un prezzo stimato. Se questo campo non viene impostato, non è previsto alcun pedaggio sul percorso.
speed_reading_intervals[]

SpeedReadingInterval

Intervalli di lettura della velocità che forniscono dettagli sulla densità del traffico. Applicabile in caso di preferenze di routing TRAFFIC_AWARE e TRAFFIC_AWARE_OPTIMAL. Gli intervalli coprono l'intera polilinea del percorso senza sovrapposizioni. Il punto iniziale di un intervallo specificato corrisponde al punto finale dell'intervallo precedente.

Esempio:

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

RouteTravelMode

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

Enum
TRAVEL_MODE_UNSPECIFIED Nessuna modalità di viaggio specificata. Il valore predefinito è DRIVE.
DRIVE Viaggia in auto con passeggeri.
BICYCLE Viaggia in bicicletta.
WALK Viaggia a piedi.
TWO_WHEELER Veicolo motorizzato a due ruote. Ad esempio, motocicletta. Tieni presente che è diversa dalla modalità di viaggio BICYCLE, che copre la modalità a energia umana.
TAXI

Viaggia con un taxi con licenza, che in alcune aree potrebbe consentire di viaggiare su corsie preferenziali.

La modalità TAXI è una funzionalità sperimentale. Se il cliente richiede un percorso TAXI in una città in cui i dati sulle piste di taxi non sono disponibili, viene restituito un percorso TRUST.

RoutingPreference

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_AWARE.
TRAFFIC_UNAWARE Calcola le route senza prendere in considerazione le condizioni del traffico. Adatto quando le condizioni del traffico non sono importanti. L'uso di questo valore produce la latenza più bassa.
TRAFFIC_AWARE Calcola i percorsi tenendo conto delle condizioni del traffico. A differenza di TRAFFIC_AWARE_OPTIMAL, alcune ottimizzazioni vengono applicate per ridurre significativamente la latenza.
TRAFFIC_AWARE_OPTIMAL Calcola i percorsi prendendo in considerazione le condizioni del traffico, senza applicare la maggior parte delle ottimizzazioni del rendimento. L'uso di questo valore produce la massima latenza.

SpeedReadingInterval

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 in base zero), SpeedReadingRange definisce un intervallo e descrive il relativo traffico utilizzando le categorie seguenti.

Campi
start_polyline_point_index

int32

L'indice iniziale di questo intervallo nella polilinea. In JSON, quando l'indice è pari a 0, il campo sembra non essere compilato.
end_polyline_point_index

int32

L'indice finale di questo intervallo nella polilinea. In JSON, quando l'indice è pari a 0, il campo sembra non essere compilato.
speed

Speed

Velocità del traffico in questo intervallo.

Velocità

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

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

TollInfo

Contiene le informazioni sui pedaggi su una linea Route o una RouteLeg.

Campi
estimated_price[]

Money

L'importo monetario dei pedaggi per il percorso o la RouteLeg corrispondente. Questo elenco contiene un importo in denaro per ogni valuta che si prevede vengano addebitati dalle stazioni a pedaggio. In genere questo elenco contiene una sola voce per i percorsi con pedaggio in una valuta. Per le corse internazionali, questo elenco può contenere più articoli per riflettere i pedaggi in valute diverse.

TollPass

Elenco di pedaggi per il pagamento in tutto il mondo supportati.

Enum
TOLL_PASS_UNSPECIFIED Non utilizzato. Se viene utilizzato questo valore, la richiesta non va a buon fine.
AU_ETOLL_TAG Uno dei tanti fornitori di pass per il pedaggio di Sydney. https://www.myetoll.com.au
AU_EWAY_TAG Uno dei tanti fornitori di pass per il pedaggio di Sydney. https://www.tollpay.com.au/
AU_LINKT Pass pedaggio per tutta l'Australia. Ulteriori dettagli sono disponibili all'indirizzo https://www.linkt.com.au/.
AR_TELEPASE Pass pedaggio per l'Argentina. Ulteriori dettagli sono disponibili all'indirizzo https://telepase.com.ar
BR_AUTO_EXPRESO Pass pedaggio brasiliano. Ulteriori dettagli sono disponibili all'indirizzo https://www.autoexpreso.com
BR_CONECTCAR Pass pedaggio brasiliano. Ulteriori dettagli sono disponibili all'indirizzo https://conectcar.com.
BR_MOVE_MAIS Pass pedaggio brasiliano. Ulteriori dettagli sono disponibili all'indirizzo https://movemais.com.
BR_PASSA_RAPIDO Pass pedaggio brasiliano. Ulteriori dettagli sono disponibili alla pagina https://pasorapido.gob.do/
BR_SEM_PARAR Pass pedaggio brasiliano. Ulteriori dettagli sono disponibili all'indirizzo https://www.semparar.com.br.
BR_TAGGY Pass pedaggio brasiliano. Ulteriori dettagli sono disponibili all'indirizzo https://taggy.com.br.
BR_VELOE Pass pedaggio brasiliano. Ulteriori dettagli sono disponibili all'indirizzo https://veloe.com.br/site/onde-usar.
CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD Passaggio di confine tra Canada e Stati Uniti.
CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD Passaggio di confine tra Canada e Stati Uniti.
CA_US_BLUE_WATER_EDGE_PASS Confine tra Ontario, Canada e Michigan, Stati Uniti.
CA_US_CONNEXION Confine tra Ontario, Canada e Michigan, Stati Uniti.
CA_US_NEXUS_CARD Passaggio di confine tra Canada e Stati Uniti.
ID_E_TOLL Indonesia. Carta elettronica fornita da più banche utilizzata per pagare i pedaggi. Il costo delle carte elettroniche tramite banche è invariato, quindi è necessario un solo valore di enumerazione. Ad es. Banca 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 dalla targa di stato HP.
MX_TAG_IAVE Pass pedaggio per il Messico.
MX_TAG_TELEVIA Società del pedaggio messicano. Uno dei tanti attivi a Città del Messico. Ulteriori dettagli sono disponibili all'indirizzo https://www.televia.com.mx.
MX_VIAPASS Pass pedaggio per il Messico. Ulteriori dettagli sono disponibili all'indirizzo https://www.viapass.com.mx/viapass/web_home.aspx.
US_AL_FREEDOM_PASS AL, USA.
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS Oklahoma, Stati Uniti.
US_CA_FASTRAK in California, Stati Uniti.
US_CA_FASTRAK_CAV_STICKER Indica che il conducente è in possesso di un pass FasTrak oltre all'adesivo Clean Air Vehicle (CAV) rilasciato dalla motorizzazione. 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 India, 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, Stati Uniti.
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, USA.
US_NC_EZPASSNC NC, Stati Uniti.
US_NC_PEACH_PASS NC, Stati Uniti.
US_NC_QUICK_PASS NC, Stati Uniti.
US_NH_EZPASSNH NH, USA.
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 Ohio, Stati Uniti.
US_PA_EZPASSPA PA, USA.
US_RI_EZPASSRI RI, USA.
US_SC_PALPASS SC, USA.
US_TX_BANCPASS TX, USA.
US_TX_DEL_RIO_PASS TX, USA.
US_TX_EFAST_PASS TX, USA.
US_TX_EAGLE_PASS_EXPRESS_CARD TX, USA.
US_TX_EPTOLL TX, USA.
US_TX_EZ_CROSS TX, USA.
US_TX_EZTAG TX, USA.
US_TX_LAREDO_TRADE_TAG TX, USA.
US_TX_PLUSPASS TX, USA.
US_TX_TOLLTAG TX, USA.
US_TX_TXTAG TX, USA.
US_TX_XPRESS_CARD TX, USA.
US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD UT, USA.
US_VA_EZPASSVA VA, USA.
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 nella visualizzazione.

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

VehicleEmissionType

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

Enum
VEHICLE_EMISSION_TYPE_UNSPECIFIED Nessun tipo di emissione specificato. Il valore predefinito è GASOLINE.
GASOLINE Veicolo a benzina/a benzina.
ELECTRIC Veicolo alimentato a energia elettrica.
HYBRID Un veicolo ibrido (ad esempio benzina + elettrico).

VehicleInfo

Racchiude le informazioni sul 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 tappa. I Waypoint indicano sia l'inizio che la fine di un percorso e includono fermate intermedie.

Campi
via

bool

Contrassegna questo tappa come un traguardo anziché un punto di sosta. Per ogni tappe non in transito nella richiesta, la risposta aggiunge una voce all'array legs per fornire i dettagli degli scali nel tratto della corsa in questione. Imposta questo valore su true se vuoi che il percorso attraversi questo punto di tappa senza fermarsi. Tramite i tappe non viene aggiunta una voce all'array legs, ma instradano il viaggio attraverso il tappeto. Puoi impostare questo valore solo sui tappe intermedi. La richiesta non va a buon fine se imposti questo campo sui tappe del terminal. Se ComputeRoutesRequest.optimize_waypoint_order è impostato su true, questo campo non può essere impostato su true. In caso contrario, la richiesta non va a buon fine.
vehicle_stopover

bool

Indica che il Waypoint è destinato ai veicoli di fermarsi con l'intenzione di prelievo o discesa. Se imposti questo valore, il percorso calcolato non includerà tappe non via su strade non adatte per prelievo e discesa. 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 tappa deve avere una preferenza affinché il veicolo si fermi su un determinato lato della strada. Quando imposti questo valore, il percorso attraverserà la posizione, in modo che il veicolo possa fermarsi sul lato della strada verso il quale la posizione è orientata rispetto al centro della strada. Questa opzione funziona solo per le modalità di viaggio "Drive" e "TWO_WHEELER" e quando "location_type" è impostato su "location".
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, compresa un'intestazione facoltativa.
place_id

string

L'ID del luogo del PDI associato al tappa.