Indice
RoutesPreferred
(interfaccia)ComputeCustomRoutesRequest
(messaggio)ComputeCustomRoutesResponse
(messaggio)ComputeCustomRoutesResponse.FallbackInfo
(messaggio)ComputeCustomRoutesResponse.FallbackInfo.FallbackRouteObjective
(enum)ComputeRouteMatrixRequest
(messaggio)ComputeRoutesRequest
(messaggio)ComputeRoutesResponse
(messaggio)CustomRoute
(messaggio)FallbackInfo
(messaggio)FallbackReason
(enum)FallbackRoutingMode
(enum)Location
(messaggio)Maneuver
(enum)NavigationInstruction
(messaggio)Polyline
(messaggio)PolylineEncoding
(enum)PolylineQuality
(enum)Route
(messaggio)RouteLeg
(messaggio)RouteLegStep
(messaggio)RouteLegStepTravelAdvisory
(messaggio)RouteLegTravelAdvisory
(messaggio)RouteMatrixDestination
(messaggio)RouteMatrixElement
(messaggio)RouteMatrixElementCondition
(enum)RouteMatrixOrigin
(messaggio)RouteModifiers
(messaggio)RouteObjective
(messaggio)RouteObjective.RateCard
(messaggio)RouteObjective.RateCard.MonetaryCost
(messaggio)RouteTravelAdvisory
(messaggio)RouteTravelMode
(enum)RoutingPreference
(enum)SpeedReadingInterval
(messaggio)SpeedReadingInterval.Speed
(enum)TollInfo
(messaggio)TollPass
(enum)Units
(enum)VehicleEmissionType
(enum)VehicleInfo
(messaggio)Waypoint
(messaggio)
RoutesPreferred
L'API Routes Preferred.
ComputeCustomRoutes |
---|
Dati un insieme di tappe terminali e intermedi e un obiettivo del percorso, calcola il percorso migliore per l'obiettivo del percorso. Restituisce anche il percorso più veloce e il percorso più breve come percorsi di riferimento. NOTA:questo metodo richiede la specifica di una maschera del campo di risposta nell'input. Puoi fornire la maschera del campo di risposta utilizzando il parametro URL Ad esempio, in questo metodo:
Google sconsiglia di utilizzare la maschera del campo di risposta con caratteri jolly (
|
ComputeRouteMatrix |
---|
Cerca un elenco di origini e destinazioni e restituisce uno stream contenente informazioni sul percorso per ogni combinazione di luogo di partenza e destinazione. NOTA:questo metodo richiede la specifica di una maschera del campo di risposta nell'input. Puoi fornire la maschera del campo di risposta utilizzando il parametro URL Ad esempio, in questo metodo:
È fondamentale includere
|
ComputeRoutes |
---|
Restituisce il percorso principale insieme a percorsi alternativi facoltativi, in base a un insieme di tappe terminal e intermedie. NOTA:questo metodo richiede la specifica di una maschera del campo di risposta nell'input. Puoi fornire la maschera del campo di risposta utilizzando il parametro URL Ad esempio, in questo metodo:
Google sconsiglia di utilizzare la maschera del campo di risposta con caratteri jolly (
|
ComputeCustomRoutesRequest
Messaggio di richiesta ComputeCustomRoutes.
Campi | |
---|---|
origin |
Obbligatorio. Tappa di partenza. |
destination |
Obbligatorio. Tappa di destinazione. |
intermediates[] |
(Facoltativo) Una serie di tappe lungo il percorso (esclusi i punti di arrivo), dove fermarti o passare. Sono supportate fino a 25 tappe intermedie. |
travel_mode |
(Facoltativo) Specifica la modalità di trasporto. Al momento è supportato solo Drive. |
routing_preference |
(Facoltativo) Specifica come calcolare la route. Il server tenta di utilizzare la preferenza di routing selezionata per calcolare il percorso. Se la preferenza di routing genera un errore o una latenza molto lunga, viene restituito un errore. In futuro, potremmo implementare un meccanismo di riserva per utilizzare un'opzione diversa quando l'opzione preferita non fornisce un risultato valido. Puoi specificare questa opzione solo quando |
polyline_quality |
(Facoltativo) Specifica la tua preferenza per la qualità della polilinea. |
polyline_encoding |
(Facoltativo) Specifica la codifica preferita per la polilinea. |
departure_time |
(Facoltativo) L'orario di partenza. Se non imposti questo valore, verrà usato per impostazione predefinita l'ora in cui hai effettuato la richiesta. Se imposti questo valore su un'ora già avvenuta, la richiesta non va a buon fine. |
route_modifiers |
(Facoltativo) Un insieme di condizioni da soddisfare che influiscono sulla modalità di calcolo delle route. |
route_objective |
Obbligatorio. Un obiettivo del percorso per cui eseguire l'ottimizzazione. |
language_code |
(Facoltativo) Il codice lingua BCP-47, ad esempio "en-US" o "sr-Latn". Per ulteriori informazioni, consulta http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Per l'elenco delle lingue supportate, consulta la sezione Supporto delle lingue. Se non fornisci questo valore, la lingua di visualizzazione viene dedotta dalla posizione della richiesta di percorso. |
units |
(Facoltativo) Specifica le unità di misura per i campi di visualizzazione. È incluso il campo |
ComputeCustomRoutesResponse
Messaggio di risposta ComputeCustomRoutes.
Campi | |
---|---|
routes[] |
I percorsi "migliori" per l'obiettivo del percorso di input. |
fastest_route |
Il percorso di riferimento più veloce. |
shortest_route |
Il percorso di riferimento più breve. |
fallback_info |
Informazioni di riserva per le route personalizzate. |
FallbackInfo
Incapsula le informazioni di fallback per ComputeCustomRoutes. ComputeCustomRoutes esegue due tipi di fallback:
Se non riesce a calcolare il percorso utilizzando il routing_preference richiesto dal cliente, passerà a un'altra modalità di routing. In questo caso fallback_routing_mode e routing_mode_fallback_reason vengono utilizzati per comunicare la modalità di routing di riserva utilizzata, nonché il motivo per il fallback.
Se non riesce a calcolare un valore "migliore" per l'obiettivo del percorso specificato dal cliente, potrebbe utilizzare un altro obiettivo. fallback_route_objective viene utilizzato per comunicare l'obiettivo del percorso di fallback.
Campi | |
---|---|
routing_mode |
Modalità di routing utilizzata per la risposta. Se la modalità di riserva è stata attivata, la modalità potrebbe essere diversa dalla preferenza di routing impostata nella richiesta originale del client. |
routing_mode_reason |
Il motivo per cui è stata utilizzata la risposta di fallback 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 |
L'obiettivo della route utilizzato per la risposta. Se è stato attivato il fallback, l'obiettivo potrebbe essere diverso da quello del percorso fornito nella richiesta originale del cliente. |
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 tariffario e imposta include_tolls su true e Google non dispone dei dati relativi al prezzo del pedaggio per il percorso, l'API utilizza la scheda tariffaria senza considerare il prezzo del pedaggio. |
ComputeRouteMatrixRequest
Messaggio di richiesta ComputeRouteMatrix
Campi | |
---|---|
origins[] |
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:
|
destinations[] |
Obbligatorio. array di destinazioni, che determina le colonne della matrice di risposta. |
travel_mode |
(Facoltativo) Specifica la modalità di trasporto. |
routing_preference |
(Facoltativo) Specifica come calcolare la route. Il server tenta di utilizzare la preferenza di routing selezionata per calcolare il percorso. Se la preferenza di routing genera un errore o una latenza molto lunga, viene restituito un errore. In futuro, potremmo implementare un meccanismo di riserva per utilizzare un'opzione diversa quando l'opzione preferita non fornisce un risultato valido. Puoi specificare questa opzione solo quando |
departure_time |
(Facoltativo) L'orario di partenza. Se non imposti questo valore, verrà utilizzata per impostazione predefinita l'ora in cui hai effettuato la richiesta. Se imposti questo valore su un'ora già avvenuta, la richiesta non va a buon fine. |
ComputeRoutesRequest
Messaggio di richiesta ComputeRoutes.
Campi | |
---|---|
origin |
Obbligatorio. Tappa di partenza. |
destination |
Obbligatorio. Tappa di destinazione. |
intermediates[] |
(Facoltativo) Una serie di tappe lungo il percorso (esclusi i punti di arrivo), dove fermarti o passare. Sono supportate fino a 25 tappe intermedie. |
travel_mode |
(Facoltativo) Specifica la modalità di trasporto. |
routing_preference |
(Facoltativo) Specifica come calcolare la route. Il server tenta di utilizzare la preferenza di routing selezionata per calcolare il percorso. Se la preferenza di routing genera un errore o una latenza molto lunga, viene restituito un errore. In futuro, potremmo implementare un meccanismo di riserva per utilizzare un'opzione diversa quando l'opzione preferita non fornisce un risultato valido. Puoi specificare questa opzione solo quando |
polyline_quality |
(Facoltativo) Specifica la tua preferenza per la qualità della polilinea. |
polyline_encoding |
(Facoltativo) Specifica la codifica preferita per la polilinea. |
departure_time |
(Facoltativo) L'orario di partenza. Se non imposti questo valore, verrà usato per impostazione predefinita l'ora in cui hai effettuato la richiesta. Se imposti questo valore su un'ora già avvenuta, la richiesta non va a buon fine. |
compute_alternative_routes |
Specifica se calcolare percorsi alternativi in aggiunta al percorso. |
route_modifiers |
(Facoltativo) Un insieme di condizioni da soddisfare che influiscono sulla modalità di calcolo delle route. |
language_code |
(Facoltativo) Il codice lingua BCP-47, ad esempio "en-US" o "sr-Latn". Per ulteriori informazioni, consulta http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Per l'elenco delle lingue supportate, consulta la sezione Supporto delle lingue. Se non fornisci questo valore, la lingua di visualizzazione viene dedotta dalla posizione della richiesta di percorso. |
units |
(Facoltativo) Specifica le unità di misura per i campi di visualizzazione. È incluso il campo |
optimize_waypoint_order |
Se OptimizeWaypointOrder è impostato su true, viene effettuato un tentativo di riordinare le tappe intermedie specificate per ridurre al minimo il costo complessivo del percorso. Se una delle tappe intermedie è una tappa, la richiesta non va a buon fine. Utilizza ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index per trovare il nuovo ordine. Se route.ottimizza_intermediate_waypoint_index non viene richiesta nell'intestazione |
ComputeRoutesResponse
ComputeRoutes il messaggio di risposta.
Campi | |
---|---|
routes[] |
Contiene un array di route calcolate (fino a tre) quando specifichi compute_alternatives_routes e una sola route quando non li specifichi. Quando questo array contiene più voci, la prima è la route più consigliata. Se l'array è vuoto, significa che non è stato trovato alcun percorso. |
fallback_info |
In alcuni casi, quando il server non è in grado di calcolare i risultati del percorso con tutte le preferenze di input, può ricorrere a un metodo di calcolo diverso. Quando viene utilizzata la modalità di riserva, questo campo contiene informazioni dettagliate sulla risposta di riserva. In caso contrario, questo campo non viene impostato. |
CustomRoute
Incapsula una route personalizzata calcolata in base all'obiettivo della route specificato dal cliente. CustomRoute contiene un percorso e un token del percorso, che possono essere trasmessi a NavSDK per ricostruire il percorso personalizzato per la navigazione passo passo.
Campi | |
---|---|
route |
Il percorso considerato "migliore" per l'obiettivo della route di input. |
token |
Token di percorso sicuro per il web con codifica Base64 che può essere passato a NavSDK, che consente a NavSDK di ricostruire il percorso durante la navigazione e, in caso di cambio di percorso, rispetta l'intenzione originale quando viene chiamato RoutesPreferred ComputeCustomRoutes. I clienti devono trattare questo token come un blob opaco. |
FallbackInfo
Informazioni relative a come e perché è stato utilizzato un risultato di fallback. Se questo campo è impostato, significa che il server ha utilizzato una modalità di routing diversa da quella che preferisci come riserva.
Campi | |
---|---|
routing_mode |
Modalità di routing utilizzata per la risposta. Se la modalità di riserva è stata attivata, la modalità potrebbe essere diversa dalla preferenza di routing impostata nella richiesta originale del client. |
reason |
Il motivo per cui è stata utilizzata la risposta di fallback 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 di una 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 routing preferita, ma siamo riusciti a restituire un risultato calcolato da una modalità alternativa. |
FallbackRoutingMode
Modalità di routing effettiva utilizzata per la risposta di fallback restituita.
Enum | |
---|---|
FALLBACK_ROUTING_MODE_UNSPECIFIED |
Non utilizzato. |
FALLBACK_TRAFFIC_UNAWARE |
Indica "TRAFFIC_UNAWARE" per calcolare la risposta è stata usata la modalità di routing. |
FALLBACK_TRAFFIC_AWARE |
Indica "TRAFFIC_AWARE" per calcolare la risposta è stata usata la modalità di routing. |
Località
Incapsula una località (un punto geografico e un'intestazione facoltativa).
Campi | |
---|---|
lat_lng |
Le coordinate geografiche della tappa. |
heading |
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 ritiro e la discesa. I valori di intestazione possono essere compresi tra 0 e 360, dove 0 specifica l'intestazione verso nord, 90 specifica l'intestazione verso est e così via. È possibile utilizzare questo campo soltanto per le modalità di viaggio |
Manovra
Un insieme di valori che specifica l'azione di navigazione da eseguire per il passaggio corrente (ad es. girare a sinistra, unire, dritto e così via).
Enum | |
---|---|
MANEUVER_UNSPECIFIED |
Non utilizzato. |
TURN_SLIGHT_LEFT |
Gira leggermente a sinistra. |
TURN_SHARP_LEFT |
Gira tutto a sinistra. |
UTURN_LEFT |
Fai un'inversione a U a sinistra. |
TURN_LEFT |
Gira a sinistra. |
TURN_SLIGHT_RIGHT |
Gira leggermente a destra. |
TURN_SHARP_RIGHT |
Gira tutto a destra. |
UTURN_RIGHT |
Fai un'inversione a U verso destra. |
TURN_RIGHT |
Gira a destra. |
STRAIGHT |
Prosegui dritto. |
RAMP_LEFT |
Prendi la rampa a sinistra. |
RAMP_RIGHT |
Prendi la rampa a destra. |
MERGE |
Unisciti al traffico. |
FORK_LEFT |
Prendi la forcella a sinistra. |
FORK_RIGHT |
Prendi la forchetta destra. |
FERRY |
Prendi il traghetto. |
FERRY_TRAIN |
Prendi il treno che porta al traghetto. |
ROUNDABOUT_LEFT |
Alla rotonda, gira a sinistra. |
ROUNDABOUT_RIGHT |
Alla rotonda, gira a destra. |
Polilinea
Incapsula una polilinea codificata.
Campi | |
---|---|
Campo unione polyline_type . Incapsula il tipo di polilinea. Il valore predefinito è coded_polyline. polyline_type può essere solo uno dei seguenti: |
|
encoded_polyline |
La codifica stringa della polilinea utilizzando l'algoritmo di codifica delle polilinee. |
geo_json_linestring |
Specifica una polilinea utilizzando il formato LineString GeoJSON |
PolylineEncoding
Specifica il tipo preferito di polilinea da restituire.
Enum | |
---|---|
POLYLINE_ENCODING_UNSPECIFIED |
Nessuna preferenza di tipo di polilinea specificata. Il valore predefinito è ENCODED_POLYLINE . |
ENCODED_POLYLINE |
Specifica una polilinea codificata utilizzando l'algoritmo di codifica delle polilinee. |
GEO_JSON_LINESTRING |
Specifica una polilinea utilizzando il formato LineString GeoJSON |
PolylineQuality
Un insieme di valori che specifica la qualità della polilinea.
Enum | |
---|---|
POLYLINE_QUALITY_UNSPECIFIED |
Nessuna preferenza di qualità per la polilinea specificata. Il valore predefinito è OVERVIEW . |
HIGH_QUALITY |
Specifica una polilinea di alta qualità, composta da più punti di OVERVIEW , a scapito di maggiori dimensioni di risposta. Utilizza questo valore quando hai bisogno di 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 di richiesta inferiore rispetto all'uso dell'opzione HIGH_QUALITY . |
Percorso
Incapsula un percorso, composto da una serie di tratti di strada collegati che uniscono punti di partenza, arrivo e intermedi.
Campi | |
---|---|
legs[] |
Un insieme di tratti (segmenti di percorso tra tappe) che compongono il percorso. Ogni tratto corrisponde al percorso tra due Waypoint non |
distance_meters |
La distanza da percorrere in metri. |
duration |
Il tempo necessario per percorrere il percorso. Se imposti |
static_duration |
La durata del viaggio senza tenere conto delle condizioni del traffico. |
polyline |
La polilinea complessiva del percorso. Questa polilinea sarà la polilinea combinata di tutti gli elementi |
description |
Una descrizione del percorso. |
warnings[] |
Un array di avvisi da mostrare quando si visualizza il percorso. |
viewport |
Il riquadro di delimitazione dell'area visibile della polilinea. |
travel_advisory |
Ulteriori informazioni sul percorso. |
optimized_intermediate_waypoint_index[] |
Se ComputeRoutesRequest.optimize_waypoint_order è impostato su true, questo campo contiene l'ordine ottimizzato delle tappe intermedie. altrimenti il campo è vuoto. Ad esempio, supponiamo che l'input sia Origine: LA; Intermedi: Dallas, Bangor, Phoenix; Destinazione: New York; e l'ordine intermedio ottimizzato dei punti di riferimento è Phoenix, Dallas, Bangor. Questo campo contiene i valori [2, 0, 1]. L'indice inizia con 0 per la prima tappa intermedia. |
RouteLeg
Incapsula un segmento tra tappe non via
.
Campi | |
---|---|
distance_meters |
La distanza da percorrere della tratta del percorso, in metri. |
duration |
Il tempo necessario per muovere la gamba. Se |
static_duration |
La durata del viaggio, calcolata senza tenere conto delle condizioni del traffico. |
polyline |
La polilinea complessiva di questa gamba. È inclusa la polilinea di ogni |
start_location |
La posizione iniziale di questo tratto. Questo valore potrebbe essere diverso dal valore |
end_location |
La posizione finale di questa gamba. Questo valore potrebbe essere diverso dal valore |
steps[] |
Un array di passaggi che indicano i segmenti all'interno di questo tratto. Ogni passaggio rappresenta un'istruzione di navigazione. |
travel_advisory |
Raggruppano le informazioni aggiuntive di cui l'utente deve essere informato, ad esempio eventuali limitazioni in base al traffico e così via, su una tratta del percorso. |
RouteLegStep
Incapsula un segmento di un RouteLeg
. Un passaggio corrisponde a una singola istruzione di navigazione. I tratti di percorso sono costituiti da gradini.
Campi | |
---|---|
distance_meters |
La distanza da percorrere in metri di questo passo. In alcuni casi, questo campo potrebbe non avere un valore. |
static_duration |
La durata del viaggio attraverso questo passaggio senza prendere in considerazione le condizioni del traffico. In alcuni casi, questo campo potrebbe non avere un valore. |
polyline |
La polilinea associata a questo passaggio. |
start_location |
Il punto di partenza di questo passaggio. |
end_location |
La posizione finale di questo passaggio. |
navigation_instruction |
Istruzioni di navigazione. |
travel_advisory |
Incapsula le informazioni aggiuntive di cui l'utente deve essere informato, come la possibile limitazione di una zona di traffico in un passo. |
RouteLegStepTravelAdvisory
Incapsula le informazioni aggiuntive di cui l'utente deve essere informato, come la possibile limitazione di una zona di traffico in un passo.
Campi | |
---|---|
speed_reading_intervals[] |
Intervalli di lettura della velocità che descrivono in dettaglio la densità del traffico. Applicabile in caso di preferenze di routing per Esempio:
|
RouteLegTravelAdvisory
Raggruppano le informazioni aggiuntive di cui l'utente deve essere informato, ad esempio eventuali limitazioni in base al traffico e così via, su una tratta del percorso.
Campi | |
---|---|
toll_info |
Include informazioni sui pedaggi della RouteLeg specifica. Questo campo viene compilato solo se prevediamo la presenza di pedaggi sulla RouteLeg. Se questo campo è impostato, ma il campo secondarioestimated_price non è compilato, prevediamo che la strada contenga pedaggi, ma non conosciamo il prezzo stimato. Se questo campo non esiste, non è previsto alcun pedaggio sulla RouteLeg. |
speed_reading_intervals[] |
Intervalli di lettura della velocità che descrivono in dettaglio la densità del traffico. Applicabile in caso di preferenze di routing per Esempio:
|
RouteMatrixDestination
Una destinazione unica per ComputeRouteMatrixRequest
Campi | |
---|---|
waypoint |
Obbligatorio. Tappa di destinazione |
RouteMatrixElement
Incapsula le informazioni sulle route calcolate per una coppia origine/destinazione nell'API ComputeRouteMatrix. Questo protocollo può essere trasmesso in streaming al client.
Campi | |
---|---|
origin_index |
Indice in base zero dell'origine nella richiesta. |
destination_index |
Indice in base zero della destinazione nella richiesta. |
status |
Codice di stato di errore per questo elemento. |
condition |
Indica se il percorso è stato trovato o meno. Indipendente dallo stato. |
distance_meters |
La distanza da percorrere in metri. |
duration |
Il tempo necessario per percorrere il percorso. Se imposti |
static_duration |
La durata del viaggio senza tenere conto delle condizioni del traffico. |
travel_advisory |
Ulteriori informazioni sul percorso. Ad esempio: informazioni sulle restrizioni e sui pedaggi. |
fallback_info |
In alcuni casi, quando il server non è in grado di calcolare il percorso con le preferenze date per questa particolare coppia origine/destinazione, può ricorrere a una modalità di calcolo diversa. Quando viene utilizzata la modalità di riserva, questo campo contiene informazioni dettagliate sulla risposta di riserva. In caso contrario, questo campo non viene impostato. |
RouteMatrixElementCondition
La condizione della route restituita.
Enum | |
---|---|
ROUTE_MATRIX_ELEMENT_CONDITION_UNSPECIFIED |
Utilizzato solo quando status dell'elemento non è OK. |
ROUTE_EXISTS |
È stato trovato un percorso e sono state compilate le informazioni corrispondenti per l'elemento. |
ROUTE_NOT_FOUND |
Nessun percorso trovato. I campi contenenti informazioni sul percorso, come distance_meters o duration , non verranno compilati nell'elemento. |
RouteMatrixOrigin
Una singola origine per ComputeRouteMatrixRequest
Campi | |
---|---|
waypoint |
Obbligatorio. Tappa di partenza |
route_modifiers |
(Facoltativo) Modificatori per ogni percorso che lo considera come origine |
RouteModifiers
Incapsula un insieme di condizioni facoltative da soddisfare durante il calcolo dei percorsi.
Campi | |
---|---|
avoid_tolls |
Specifica se evitare le strade a pedaggio quando ragionevole. Verrà data la preferenza ai percorsi che non contengono strade a pedaggio. Si applica solo alle modalità di viaggio |
avoid_highways |
Specifica se evitare le autostrade in cui è ragionevole. Verrà data la preferenza ai percorsi che non contengono autostrade. Si applica solo alle modalità di viaggio |
avoid_ferries |
Specifica se evitare i traghetti quando è ragionevole. Verrà data la preferenza ai percorsi che non contengono viaggi tramite traghetti. Si applica solo alle modalità di viaggio |
avoid_indoor |
Specifica se evitare la navigazione al chiuso dove ragionevole. Verrà data la preferenza ai percorsi che non contengono la navigazione al chiuso. Si applica solo alla modalità di viaggio |
vehicle_info |
Specifica le informazioni del veicolo. |
toll_passes[] |
Contiene informazioni sui pedaggi. Se vengono forniti i pass per pedaggi, l'API tenta di restituire il prezzo del pass. Se 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 il quale eseguire l'ottimizzazione tramite ComputeCustomRoutes.
Campi | |
---|---|
rate_card |
L'obiettivo del tariffario. |
RateCard
Incapsula un obiettivo di percorso del tariffario.
Campi | |
---|---|
cost_per_minute |
(Facoltativo) Costo al minuto. |
cost_per_km |
(Facoltativo) Costo per chilometro. |
include_tolls |
(Facoltativo) Indica se includere il pedaggio nel costo complessivo. |
MonetaryCost
Include il costo utilizzato nel tariffario.
Campi | |
---|---|
value |
Obbligatorio. Il valore di costo in valuta locale dedotto dalla richiesta. |
RouteTravelAdvisory
Contiene informazioni aggiuntive di cui l'utente deve essere informato, ad esempio restrizioni relative a zone di traffico ecc.
Campi | |
---|---|
toll_info |
Contiene informazioni sui pedaggi lungo il percorso. Questo campo viene compilato solo se prevediamo la presenza di pedaggi sul percorso. Se questo campo è impostato, ma il campo secondarioestimated_price non è compilato, prevediamo che la strada contenga pedaggi, ma non conosciamo il prezzo stimato. Se questo campo non viene impostato, non è previsto alcun pedaggio sul percorso. |
speed_reading_intervals[] |
Intervalli di lettura della velocità che descrivono in dettaglio la densità del traffico. Applicabile in caso di preferenze di routing per Esempio:
|
RouteTravelMode
Un insieme di valori utilizzato per specificare la modalità di viaggio.
Enum | |
---|---|
TRAVEL_MODE_UNSPECIFIED |
Nessuna modalità di viaggio specificata. Il valore predefinito è DRIVE . |
DRIVE |
Viaggia in autovettura. |
BICYCLE |
Viaggiare in bicicletta. |
WALK |
Viaggia a piedi. |
TWO_WHEELER |
Veicolo motorizzato a due ruote. ad esempio moto. Tieni presente che questa modalità è diversa dalla modalità di viaggio BICYCLE , che copre la modalità a energia umana. |
TAXI |
Viaggia a bordo di un taxi con licenza, che potrebbe consentire al veicolo di viaggiare su corsie taxi specifiche in alcune aree. La modalità TAXI è una funzionalità sperimentale. Se il cliente richiede un percorso TAXI in una città in cui i dati relativi alle corsie dei taxi non sono disponibili, viene restituito un percorso Drive. |
RoutingPreference
Un insieme di valori che specificano i fattori da prendere in considerazione per il calcolo del percorso.
Enum | |
---|---|
ROUTING_PREFERENCE_UNSPECIFIED |
Nessuna preferenza di routing specificata. Il valore predefinito è TRAFFIC_AWARE . |
TRAFFIC_UNAWARE |
Calcola le route senza tenere conto delle condizioni del traffico. Adatta quando le condizioni del traffico non sono importanti. L'uso di questo valore produce la latenza più bassa. |
TRAFFIC_AWARE |
Calcola i percorsi prendendo in considerazione le condizioni del traffico. A differenza di TRAFFIC_AWARE_OPTIMAL , alcune ottimizzazioni vengono applicate per ridurre notevolmente 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 latenza massima. |
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), SpeedReadingInterval definisce un intervallo e descrive il relativo traffico utilizzando le seguenti categorie.
Campi | |
---|---|
start_polyline_point_index |
L'indice iniziale di questo intervallo nella polilinea. In JSON, quando l'indice è 0, il campo sembra non essere compilato. |
end_polyline_point_index |
L'indice finale di questo intervallo nella polilinea. In JSON, quando l'indice è 0, il campo sembra non essere compilato. |
speed |
Velocità del traffico in questo intervallo. |
Velocità
La classificazione della velocità delle polilinee 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 è formato un ingorgo. |
TRAFFIC_JAM |
Ingorgo stradale rilevato. |
TollInfo
Include le informazioni sui pedaggi su un Route
o su un RouteLeg
.
Campi | |
---|---|
estimated_price[] |
L'importo monetario dei pedaggi per la Route o RouteLeg corrispondente. Questo elenco contiene un importo per ogni valuta che dovrebbe essere addebitata dalle stazioni di pedaggio. In genere questo elenco contiene una sola voce per i percorsi con pedaggi in un'unica valuta. Per i viaggi internazionali, questo elenco può contenere più voci per indicare i pedaggi in valute diverse. |
TollPass
Elenco dei 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 |
Uno dei tanti fornitori di pedaggi di Sydney. https://www.myetoll.com.au |
AU_EWAY_TAG |
Uno dei tanti fornitori di pedaggi di Sydney. https://www.tollpay.com.au/ |
AU_LINKT |
Pass pedaggio per tutta l'Australia. Scopri di più all'indirizzo https://www.linkt.com.au/. |
AR_TELEPASE |
Pass pedaggio Argentina. Scopri ulteriori dettagli all'indirizzo https://telepase.com.ar |
BR_AUTO_EXPRESO |
pedaggio brasiliano. Scopri di più all'indirizzo https://www.autoexpreso.com |
BR_CONECTCAR |
pedaggio brasiliano. Scopri di più all'indirizzo https://conectcar.com. |
BR_MOVE_MAIS |
pedaggio brasiliano. Vedi ulteriori dettagli all'indirizzo https://movemais.com. |
BR_PASSA_RAPIDO |
pedaggio brasiliano. Scopri di più all'indirizzo https://pasorapido.gob.do/ |
BR_SEM_PARAR |
pedaggio brasiliano. Scopri di più all'indirizzo https://www.semparar.com.br. |
BR_TAGGY |
pedaggio brasiliano. Scopri di più all'indirizzo https://taggy.com.br. |
BR_VELOE |
pedaggio brasiliano. Scopri di più all'indirizzo https://veloe.com.br/site/onde-usar. |
CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD |
Passaggio dal Canada agli Stati Uniti. |
CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD |
Passaggio dal Canada agli Stati Uniti. |
CA_US_BLUE_WATER_EDGE_PASS |
Passaggio di confine tra l'Ontario, il Canada e il Michigan, Stati Uniti. |
CA_US_CONNEXION |
Passaggio di confine tra l'Ontario, il Canada e il Michigan, Stati Uniti. |
CA_US_NEXUS_CARD |
Passaggio dal Canada agli Stati Uniti. |
ID_E_TOLL |
Indonesia. Carta elettronica fornita da più banche utilizzata per pagare i pedaggi. L'addebito viene effettuato su tutte le e-card tramite banche, pertanto è 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 dalle targhe statali dell'HP. |
MX_TAG_IAVE |
Pedaggio per il Messico. |
MX_TAG_TELEVIA |
Società di pedaggi in Messico. Uno dei tanti che operano a Città del Messico. Consulta ulteriori dettagli all'indirizzo https://www.televia.com.mx. |
MX_VIAPASS |
Pedaggio per il Messico. Consulta ulteriori dettagli 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 |
AK, Stati Uniti. |
US_CA_FASTRAK |
Canada, Stati Uniti d'America. |
US_CA_FASTRAK_CAV_STICKER |
Indica che il conducente dispone di un permesso FasTrak oltre all'adesivo Clean Air (CAV) rilasciato dall'DMV. https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml |
US_CO_EXPRESSTOLL |
CO, USA. |
US_CO_GO_PASS |
CO, USA. |
US_DE_EZPASSDE |
DE, USA. |
US_FL_BOB_SIKES_TOLL_BRIDGE_PASS |
FL, Stati Uniti d'America. |
US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD |
FL, Stati Uniti d'America. |
US_FL_EPASS |
FL, Stati Uniti d'America. |
US_FL_GIBA_TOLL_PASS |
FL, Stati Uniti d'America. |
US_FL_LEEWAY |
FL, Stati Uniti d'America. |
US_FL_SUNPASS |
FL, Stati Uniti d'America. |
US_FL_SUNPASS_PRO |
FL, Stati Uniti d'America. |
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_KY_RIVERLINK |
KY, USA. |
US_LA_GEAUXPASS |
LA, USA. |
US_LA_TOLL_TAG |
LA, USA. |
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, USA. |
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, USA. |
US_WA_BREEZEBY |
WA, USA. |
US_WA_GOOD_TO_GO |
WA, USA. |
US_WV_EZPASSWV |
WV, Stati Uniti. |
US_WV_MEMORIAL_BRIDGE_TICKETS |
WV, Stati Uniti. |
US_WV_NEWELL_TOLL_BRIDGE_TICKET |
WV, Stati Uniti. |
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. Vale solo per la modalità di spostamento 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 elettricità. |
HYBRID |
Veicolo con carburante ibrido (ad es. benzina + elettrico). |
VehicleInfo
Incapsula le informazioni del veicolo, come l'ultimo carattere della targa.
Campi | |
---|---|
emission_type |
Descrive il tipo di emissione del veicolo. Vale solo per la modalità di spostamento Drive. |
Waypoint
Incapsula una tappa. I waypoint contrassegnano sia l'inizio che la fine di un percorso e includono fermate intermedie lungo il percorso.
Campi | |
---|---|
via |
Contrassegna questa tappa come tappa anziché come punto di sosta. Per ogni tappa non via nella richiesta, la risposta aggiunge una voce all'array |
vehicle_stopover |
Indica che la tappa è destinata ai veicoli in cui devono fermarsi, con l'intenzione di salire o scendere dal mezzo. Se imposti questo valore, il percorso calcolato non includerà tappe non |
side_of_road |
Indica che la posizione di questa tappa deve avere una preferenza che il veicolo si fermi in 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 inclinato rispetto alla posizione rispetto al centro della strada. Questa opzione funziona solo per "Drive" e "TWO_WHEELER" modalità di viaggio e quando "location_type" sia impostato su "location". |
Campo unione location_type . Diversi modi per rappresentare un luogo. location_type può essere solo uno dei seguenti: |
|
location |
Un punto specificato utilizzando le coordinate geografiche, inclusa un'intestazione facoltativa. |
place_id |
L'ID luogo del PDI associato alla tappa. |