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 |
---|
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 Ad esempio, in questo metodo:
Google sconsiglia l'utilizzo della maschera per il campo di risposta con caratteri jolly (
|
ComputeRouteMatrix |
---|
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 Ad esempio, in questo metodo:
È fondamentale includere
|
ComputeRoutes |
---|
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 Ad esempio, in questo metodo:
Google sconsiglia l'utilizzo della maschera per il campo di risposta con caratteri jolly (
|
ComputeCustomRoutesRequest
Messaggio di richiesta ComputeCustomRoutes.
Campi | |
---|---|
origin |
Obbligatorio. Waypoint di partenza. |
destination |
Obbligatorio. Waypoint di destinazione. |
intermediates[] |
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 |
Campo facoltativo. Specifica la modalità di trasporto. Al momento è supportato solo Drive. |
routing_preference |
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 |
polyline_quality |
Campo facoltativo. Specifica la tua preferenza per la qualità della polilinea. |
polyline_encoding |
Campo facoltativo. Specifica la codifica preferita per la polilinea. |
departure_time |
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 |
Campo facoltativo. Un insieme di condizioni da soddisfare che influiscono sul modo in cui vengono calcolati i percorsi. |
route_objective |
Obbligatorio. Un obiettivo di percorso per cui ottimizzare. |
language_code |
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 |
Campo facoltativo. Specifica le unità di misura per i campi di visualizzazione. Questo include 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 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.
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 |
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 |
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 |
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[] |
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 |
Campo facoltativo. Specifica la modalità di trasporto. |
routing_preference |
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 |
departure_time |
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 |
Obbligatorio. Waypoint di partenza. |
destination |
Obbligatorio. Waypoint di destinazione. |
intermediates[] |
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 |
Campo facoltativo. Specifica la modalità di trasporto. |
routing_preference |
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 |
polyline_quality |
Campo facoltativo. Specifica la tua preferenza per la qualità della polilinea. |
polyline_encoding |
Campo facoltativo. Specifica la codifica preferita per la polilinea. |
departure_time |
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 |
Specifica se calcolare percorsi alternativi in aggiunta al percorso. |
route_modifiers |
Campo facoltativo. Un insieme di condizioni da soddisfare che influiscono sul modo in cui vengono calcolati i percorsi. |
language_code |
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 |
Campo facoltativo. Specifica le unità di misura per i campi di visualizzazione. Questo include il campo |
optimize_waypoint_order |
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 |
ComputeRoutesResponse
ComputeRoutes il messaggio di risposta.
Campi | |
---|---|
routes[] |
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 |
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 |
Il percorso considerato "migliore" per l'obiettivo del percorso inserito. |
token |
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 |
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 |
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 |
Le coordinate geografiche del 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 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 |
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. |
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 |
La codifica stringa della polilinea utilizzando l'algoritmo di codifica delle polilinea. |
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 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[] |
Un insieme di tratti (segmenti di percorso tra i tappe) che compongono il percorso. Ogni tratto corrisponde alla corsa tra due Waypoint non |
distance_meters |
La distanza da percorrere del percorso, in metri. |
duration |
Il tempo necessario per percorrere il percorso. Se imposti |
static_duration |
La durata del percorso senza tenere conto delle condizioni del traffico. |
polyline |
La polilinea del percorso complessivo. Questa polilinea sarà la polilinea combinata di tutti i |
description |
Una descrizione del percorso. |
warnings[] |
Un array di avvisi da mostrare quando viene visualizzato il percorso. |
viewport |
Il riquadro di delimitazione dell'area visibile della polilinea. |
travel_advisory |
Informazioni aggiuntive sul percorso. |
optimized_intermediate_waypoint_index[] |
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 |
La distanza da percorrere per la tratta del percorso, in metri. |
duration |
Il tempo necessario per navigare nella gamba. Se |
static_duration |
La durata del viaggio, calcolata senza tenere conto delle condizioni del traffico. |
polyline |
La polilinea complessiva per questa gamba. Ciò include la polilinea di ogni |
start_location |
La posizione di partenza di questa tappa. Potrebbe essere diverso dal valore |
end_location |
La posizione finale di questa tappa. Potrebbe essere diverso dal valore |
steps[] |
Un array di passaggi che indicano i segmenti all'interno di questa gamba. Ogni passaggio rappresenta un'istruzione di navigazione. |
travel_advisory |
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 |
La distanza da percorrere per questo passo, in metri. In alcuni casi, questo campo potrebbe non avere un valore. |
static_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 |
La polilinea associata a questo passaggio. |
start_location |
La posizione iniziale di questo passaggio. |
end_location |
La posizione finale di questo passaggio. |
navigation_instruction |
Istruzioni di navigazione. |
travel_advisory |
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[] |
Intervalli di lettura della velocità che forniscono dettagli sulla densità del traffico. Applicabile in caso di preferenze di routing Esempio:
|
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 |
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[] |
Intervalli di lettura della velocità che forniscono dettagli sulla densità del traffico. Applicabile in caso di preferenze di routing Esempio:
|
RouteMatrixDestination
Una singola destinazione per ComputeRouteMatrixRequest
Campi | |
---|---|
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 |
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 del percorso, in metri. |
duration |
Il tempo necessario per percorrere il percorso. Se imposti |
static_duration |
La durata del percorso senza tenere conto delle condizioni del traffico. |
travel_advisory |
Informazioni aggiuntive sul percorso. Ad esempio: informazioni sulle limitazioni e sui pedaggi |
fallback_info |
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 |
Obbligatorio. Waypoint di partenza |
route_modifiers |
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 |
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 |
avoid_highways |
Specifica se evitare le autostrade, ove ragionevole. La preferenza verrà data ai percorsi che non contengono autostrade. Si applica solo alle modalità di viaggio |
avoid_ferries |
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 |
avoid_indoor |
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 |
vehicle_info |
Specifica le informazioni del veicolo. |
toll_passes[] |
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 |
L'obiettivo del tariffario. |
RateCard
Incapsula l'obiettivo di percorso di un tariffario.
Campi | |
---|---|
cost_per_minute |
Campo facoltativo. Costo al minuto. |
cost_per_km |
Campo facoltativo. Costo per chilometro. |
include_tolls |
Campo facoltativo. Indica se includere il costo del pedaggio nel costo complessivo. |
MonetaryCost
Include il costo utilizzato nel tariffario.
Campi | |
---|---|
value |
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 |
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[] |
Intervalli di lettura della velocità che forniscono dettagli sulla densità del traffico. Applicabile in caso di preferenze di routing Esempio:
|
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 |
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 |
L'indice finale di questo intervallo nella polilinea. In JSON, quando l'indice è pari a 0, il campo sembra non essere compilato. |
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[] |
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_KY_RIVERLINK |
KY, 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 |
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 |
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 |
vehicle_stopover |
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 |
side_of_road |
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 |
Un punto specificato utilizzando le coordinate geografiche, compresa un'intestazione facoltativa. |
place_id |
L'ID del luogo del PDI associato al tappa. |