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 waypoint di destinazione e intermedi e uno scopo del percorso, calcola il percorso migliore per lo scopo 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 l'utilizzo della maschera del campo di risposta con caratteri jolly (
|
ComputeRouteMatrix |
---|
Riceve un elenco di origini e destinazioni e restituisce uno stream contenente informazioni sui percorsi per ogni combinazione di origine 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 waypoint intermedi e finali. NOTA: questo metodo richiede di specificare una maschera di campo di risposta nell'input. Puoi fornire la maschera del campo di risposta utilizzando il parametro URL 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. Punto di passaggio di destinazione. |
intermediates[] |
(Facoltativo) Un insieme di waypoint lungo il percorso (esclusi i punti di terminazione), da fermare o da passare. Sono supportate fino a 25 tappe intermedie. |
travel_ |
(Facoltativo) Specifica la modalità di trasporto. Sono supportati solo i criteri |
routing_ |
(Facoltativo) Specifica come calcolare il percorso. 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. Puoi specificare questa opzione solo quando |
polyline_ |
(Facoltativo) Specifica la tua preferenza per la qualità della polilinea. |
polyline_ |
(Facoltativo) Specifica la codifica preferita per la polilinea. |
departure_ |
(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_ |
(Facoltativo) Un insieme di condizioni da soddisfare che influiscono sul modo in cui vengono calcolati i percorsi. |
route_ |
Obbligatorio. Un obiettivo del percorso in base al quale eseguire l'ottimizzazione. |
language_ |
(Facoltativo) Il codice lingua BCP-47, ad esempio "en-US" o "sr-Latn". Per saperne di più, consulta la sezione Identificatore di impostazioni internazionali Unicode. 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 di ComputeCustomRoutes.
Campi | |
---|---|
routes[] |
I percorsi "migliori" per lo scopo del percorso inserito. |
fastest_ |
Il percorso di riferimento più veloce. |
shortest_ |
Il percorso di riferimento più breve. |
fallback_ |
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 valore
routing_preference
richiesto dal cliente, verrà utilizzata un'altra modalità di routing. In questo caso,fallback_routing_mode
erouting_mode_fallback_reason
vengono utilizzati per comunicare la modalità di assegnazione di riserva utilizzata, nonché il motivo della riserva.Se non riesce a calcolare un percorso "migliore" per lo scopo del percorso specificato dal cliente, potrebbe utilizzare un altro obiettivo di riserva.
fallback_route_objective
viene utilizzato per comunicare lo scopo del percorso di riserva.
Campi | |
---|---|
routing_ |
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_ |
Il motivo per cui è stata utilizzata la risposta di riserva anziché la risposta originale. Questo campo viene compilato solo quando viene attivata la modalità di riserva e viene restituita la risposta di riserva. |
route_ |
L'obiettivo della route utilizzato per la risposta. Se è stato attivato il fallback, lo scopo potrebbe essere diverso dallo scopo del percorso fornito nella richiesta del client originale. |
FallbackRouteObjective
ObiettivoRoute 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 RateCard e imposta include_tolls su true e Google non dispone di dati sui prezzi dei pedaggi per l'itinerario, l'API utilizza il valore RateCard senza considerare il prezzo del pedaggio. |
ComputeRouteMatrixRequest
Messaggio di richiesta ComputeRouteMatrix
Campi | |
---|---|
origins[] |
Obbligatorio. Array di origini, che determina le righe della matrice di risposta. Alla cardinalità di origini e destinazioni si applicano diversi limiti di dimensioni:
|
destinations[] |
Obbligatorio. Array di destinazioni, che determina le colonne della matrice di risposta. |
travel_ |
(Facoltativo) Specifica la modalità di trasporto. |
routing_ |
(Facoltativo) Specifica come calcolare il percorso. 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. Puoi specificare questa opzione solo quando |
departure_ |
(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 di ComputeRoutes
.
Campi | |
---|---|
origin |
Obbligatorio. Tappa di partenza. |
destination |
Obbligatorio. Punto di passaggio di destinazione. |
intermediates[] |
(Facoltativo) Un insieme di waypoint lungo il percorso (esclusi i punti di terminazione), da fermare o da passare. Sono supportate fino a 25 tappe intermedie. |
travel_ |
(Facoltativo) Specifica la modalità di trasporto. |
routing_ |
(Facoltativo) Specifica come calcolare il percorso. 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. Puoi specificare questa opzione solo quando |
polyline_ |
(Facoltativo) Specifica la tua preferenza per la qualità della polilinea. |
polyline_ |
(Facoltativo) Specifica la codifica preferita per la polilinea. |
departure_ |
(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_ |
(Facoltativo) Specifica se calcolare percorsi alternativi in aggiunta al percorso. Non vengono restituiti percorsi alternativi per le richieste con waypoint intermedi. |
route_ |
(Facoltativo) Un insieme di condizioni da soddisfare che influiscono sul modo in cui vengono calcolati i percorsi. |
language_ |
(Facoltativo) Il codice lingua BCP-47, ad esempio "en-US" o "sr-Latn". Per ulteriori informazioni, consulta Identificatore della locale Unicode. 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_ |
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 uno dei waypoint intermedi è un waypoint intermedio, la richiesta non va a buon fine. Usa |
ComputeRoutesResponse
ComputeRoutes il messaggio di risposta.
Campi | |
---|---|
routes[] |
Contiene un array di percorsi calcolati (fino a tre) se specifichi |
fallback_ |
In alcuni casi, quando il server non è in grado di calcolare i risultati del percorso con tutte le preferenze di input, potrebbe 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 una route e un token route, che possono essere passati a NavSDK per ricostruire la route personalizzata per la navigazione passo passo.
Campi | |
---|---|
route |
Il percorso considerato "migliore" per l'obiettivo del percorso di input. |
token |
Token percorso codificato con Base64 sicuro per il web che può essere passato a NavSDK, il che consente a NavSDK di ricostruire il percorso durante la navigazione e, in caso di deviazione, di rispettare l'intenzione originale quando viene chiamato |
FallbackInfo
Informazioni su come e perché è stato utilizzato un risultato di riserva. Se questo campo è impostato, significa che il server ha utilizzato una modalità di routing diversa dalla modalità preferita come alternativa.
Campi | |
---|---|
routing_ |
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 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 modalità di calcolo del percorso che preferisci, ma siamo riusciti a restituire un risultato calcolato con 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 instradamento effettiva utilizzata per la risposta di riserva restituita.
Enum | |
---|---|
FALLBACK_ROUTING_MODE_UNSPECIFIED |
Non utilizzato. |
FALLBACK_TRAFFIC_UNAWARE |
Indica che per calcolare la risposta è stata utilizzata la modalità di routing TRAFFIC_UNAWARE . |
FALLBACK_TRAFFIC_AWARE |
Indica che è stata utilizzata la modalità di routing TRAFFIC_AWARE per calcolare la risposta. |
Località
Incapsula una località (un punto geografico e un'intestazione facoltativa).
Campi | |
---|---|
lat_ |
Le coordinate geografiche del waypoint. |
heading |
L'intestazione della bussola associata alla direzione del flusso del traffico. Questo valore specifica il lato della strada da utilizzare per il ritiro e la partenza. I valori di intestazione possono essere compresi tra 0 e 360, dove 0 indica una direzione verso nord, 90 indica una 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 eseguire per il passaggio corrente (ad esempio, svolta a sinistra, svolta a destra o dritto).
Enum | |
---|---|
MANEUVER_UNSPECIFIED |
Non utilizzato. |
TURN_SLIGHT_LEFT |
Gira leggermente a sinistra. |
TURN_SHARP_LEFT |
Svolta bruscamente 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 bruscamente 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 strada 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. |
DEPART |
Manovra iniziale. |
NAME_CHANGE |
Utilizzato per indicare un cambio di nome di una via. |
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_ |
La codifica della stringa del polilinea utilizzando l'algoritmo di codifica del polilinea. |
geo_ |
Specifica un polilinea utilizzando il formato LineString GeoJSON. |
PolylineEncoding
Specifica il tipo preferito di polilinea da restituire.
Enum | |
---|---|
POLYLINE_ENCODING_UNSPECIFIED |
Nessuna preferenza per il tipo di polilinea specificata. Il valore predefinito è ENCODED_POLYLINE . |
ENCODED_POLYLINE |
Specifica una polilinea codificata utilizzando l'algoritmo di codifica delle polilinee. |
GEO_JSON_LINESTRING |
Specifica un polilinea utilizzando il formato LineString GeoJSON. |
PolylineQuality
Un insieme di valori che specificano la qualità del polilinea.
Enum | |
---|---|
POLYLINE_QUALITY_UNSPECIFIED |
Nessuna preferenza per la qualità dei polilinee 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 di panoramica, composta utilizzando 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 le tappe di inizio, fine e intermedie.
Campi | |
---|---|
legs[] |
Un insieme di tratti (segmenti del percorso tra i waypoint) che compongono il percorso. Ogni tratta corrisponde al viaggio tra due waypoint non |
distance_ |
La distanza da percorrere in metri. |
duration |
Il tempo necessario per percorrere il percorso. Se imposti |
static_ |
La durata del viaggio lungo il percorso senza tenere conto delle condizioni del traffico. |
polyline |
La polilinea complessiva del percorso. Questo polilinea è il polilinea combinato di tutti i |
description |
Una descrizione del percorso. |
warnings[] |
Un array di avvisi da mostrare durante la visualizzazione del percorso. |
viewport |
Il riquadro di delimitazione dell'area visibile della polilinea. |
travel_ |
Ulteriori informazioni sul percorso. |
optimized_ |
Se |
RouteLeg
Incapsula un segmento tra waypoint non via
.
Campi | |
---|---|
distance_ |
La distanza da percorrere della tratta del percorso, in metri. |
duration |
La durata del tratto. Se |
static_ |
La durata del viaggio nel tratto, calcolata senza tenere conto delle condizioni del traffico. |
polyline |
Il polilinea complessivo per questo tratto. Sono incluse le polilinee di ogni |
start_ |
La posizione di partenza di questo tratto. Potrebbe essere diverso dal valore |
end_ |
La posizione finale di questa gamba. 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_ |
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_ |
La distanza percorsa in questo passaggio, in metri. In alcuni casi, questo campo potrebbe non avere un valore. |
static_ |
La durata del viaggio in questo passaggio senza tenere conto delle condizioni del traffico. In alcuni casi, questo campo potrebbe non avere un valore. |
polyline |
La polilinea associata a questo passaggio. |
start_ |
Il punto di partenza di questo passaggio. |
end_ |
La posizione di destinazione di questo passaggio. |
navigation_ |
Istruzioni di navigazione. |
travel_ |
Incapsula le informazioni aggiuntive di cui l'utente deve essere informato, ad esempio una possibile limitazione di zona a traffico limitato in un passaggio della tratta. |
RouteLegStepTravelAdvisory
Incapsula le informazioni aggiuntive di cui l'utente deve essere informato, ad esempio una possibile limitazione di zona a traffico limitato in un passaggio del tratto.
Campi | |
---|---|
speed_ |
NOTA: questo campo non è attualmente compilato. |
RouteLegTravelAdvisory
Incapsula le informazioni aggiuntive di cui l'utente deve essere informato, ad esempio possibili limitazioni per zone a traffico limitato e così via in un tratto del percorso.
Campi | |
---|---|
toll_ |
Incapsula le informazioni sui pedaggi per la |
speed_ |
Intervalli di lettura della velocità che descrivono in dettaglio la densità del traffico. Applicabile in caso di preferenze di routing Esempio:
|
RouteMatrixDestination
Una destinazione unica per ComputeRouteMatrixRequest
Campi | |
---|---|
waypoint |
Obbligatorio. Punto di passaggio di destinazione |
RouteMatrixElement
Incapsula le informazioni sui percorsi calcolati per una coppia di origine/destinazione nell'API ComputeRouteMatrix. Questo protocollo può essere trasmesso in streaming al client.
Campi | |
---|---|
origin_ |
Indice a partire da zero dell'origine nella richiesta. |
destination_ |
Indice a partire da zero della destinazione nella richiesta. |
status |
Codice di stato di errore per questo elemento. |
condition |
Indica se il percorso è stato trovato o meno. Indipendentemente dallo stato. |
distance_ |
La distanza da percorrere in metri. |
duration |
Il tempo necessario per percorrere il percorso. Se imposti |
static_ |
La durata del viaggio lungo il percorso senza tenere conto delle condizioni del traffico. |
travel_ |
Informazioni aggiuntive sul percorso. Ad esempio: informazioni sulle restrizioni e sui pedaggi. |
fallback_ |
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 del percorso restituito.
Enum | |
---|---|
ROUTE_MATRIX_ELEMENT_CONDITION_UNSPECIFIED |
Viene utilizzato solo quando il valore 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
Un'unica origine per ComputeRouteMatrixRequest
Campi | |
---|---|
waypoint |
Obbligatorio. Punto di riferimento di origine |
route_ |
(Facoltativo) Modificatori per ogni percorso che prende questa stazione come origine |
RouteModifiers
Incapsula un insieme di condizioni facoltative da soddisfare durante il calcolo dei percorsi.
Campi | |
---|---|
avoid_ |
Se impostato su true, evita le strade a pedaggio, se possibile, dando la preferenza ai percorsi che non le contengono. Si applica solo alle modalità di viaggio |
avoid_ |
Se impostato su true, evita le autostrade quando ragionevole, privilegiando i percorsi che non contengono autostrade. Si applica solo alle modalità di viaggio |
avoid_ |
Se questo criterio viene impostato su true, i traghetti vengono evitati ove ragionevole, privilegiando i percorsi che non contengono traghetti. Si applica solo alle modalità di viaggio |
avoid_ |
Se impostato su true, evita la navigazione al chiuso dove ragionevole, privilegiando i percorsi che non contengono la navigazione al chiuso. Si applica solo alla modalità di viaggio |
vehicle_ |
Specifica le informazioni sul veicolo. |
toll_ |
Contiene informazioni sui pedaggi. Se vengono forniti permessi di pedaggio, l'API tenta di restituire il prezzo del permesso. 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 |
RouteObjective
Incapsula un obiettivo per l'ottimizzazione in base a ComputeCustomRoutes
.
Campi | |
---|---|
Campo unione objective . L'obiettivo del percorso. objective può essere solo uno dei seguenti: |
|
rate_ |
Scopo Tariffario. |
Tariffario
Incapsula uno scopo del percorso RateCard
.
Campi | |
---|---|
cost_ |
(Facoltativo) Costo al minuto. |
cost_ |
(Facoltativo) Costo per chilometro. |
include_ |
(Facoltativo) Indica se includere il costo del pedaggio nel costo complessivo. |
MonetaryCost
Incapsula il costo utilizzato nella tariffa.
Campi | |
---|---|
value |
Obbligatorio. Il valore di costo in valuta locale dedotto dalla richiesta. |
RouteTravelAdvisory
Incapsula le informazioni aggiuntive di cui l'utente deve essere informato, ad esempio possibili limitazioni nelle zone a traffico limitato e così via.
Campi | |
---|---|
toll_ |
Incapsula le 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 secondario |
speed_ |
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 |
Viaggiare 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 propulsione 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 i percorsi senza tenere conto delle condizioni del traffico in tempo reale. Adatto quando le condizioni del traffico non sono importanti o non sono applicabili. L'uso di questo valore produce la latenza più bassa. Nota: per RouteTravelMode Drive e TWO_WHEELER, il percorso e la durata scelti si basano sulla rete stradale e sulle condizioni medie del traffico dipendenti dal tempo, non sulle condizioni stradali attuali. Di conseguenza, i percorsi potrebbero includere strade temporaneamente chiuse. I risultati di una determinata richiesta possono variare nel tempo a causa di cambiamenti nella rete stradale, dell'aggiornamento delle condizioni medie del traffico e della natura distribuita del servizio. I risultati possono variare anche in percorsi quasi equivalenti in qualsiasi momento o con frequenza. |
TRAFFIC_AWARE |
Calcola i percorsi tenendo conto delle condizioni del traffico. A differenza di TRAFFIC_AWARE_OPTIMAL , alcune ottimizzazioni vengono applicate per ridurre notevolmente la latenza. |
TRAFFIC_AWARE_OPTIMAL |
Calcola i percorsi tenendo conto delle 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 traffico utilizzando le categorie seguenti.
Campi | |
---|---|
start_ |
L'indice iniziale di questo intervallo nella polilinea. In JSON, quando l'indice è 0, il campo sembra non essere compilato. |
end_ |
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à del polilinea in base ai dati sul traffico.
Enum | |
---|---|
SPEED_UNSPECIFIED |
Valore predefinito. Questo valore non è utilizzato. |
NORMAL |
Velocità normale, nessun rallentamento rilevato. |
SLOW |
Rallentamento rilevato, ma non si è formato ingorgo. |
TRAFFIC_JAM |
È stato rilevato un ingorgo. |
TollInfo
Include le informazioni sui pedaggi su un Route
o su un RouteLeg
.
Campi | |
---|---|
estimated_ |
L'importo monetario dei pedaggi per il corrispondente |
TollPass
Elenco delle tessere per pedaggi supportate in tutto il mondo.
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 tessere per pedaggi di Sydney. https://www.myetoll.com.au |
AU_EWAY_TAG |
Uno dei tanti fornitori di tessere per pedaggi di Sydney. https://www.tollpay.com.au/ |
AU_LINKT |
Pedaggio per tutta l'Australia. Scopri di più all'indirizzo https://www.linkt.com.au/. |
AR_TELEPASE |
Telepass per l'Argentina. Scopri ulteriori dettagli all'indirizzo https://telepase.com.ar |
BR_AUTO_EXPRESO |
Telepass per il Brasile. Scopri di più all'indirizzo https://www.autoexpreso.com |
BR_CONECTCAR |
Telepass per il Brasile. Per ulteriori dettagli, visita la pagina https://conectcar.com. |
BR_MOVE_MAIS |
Telepass per il Brasile. Per ulteriori dettagli, visita la pagina https://movemais.com. |
BR_PASSA_RAPIDO |
Telepass per il Brasile. Per ulteriori dettagli, visita la pagina https://pasorapido.gob.do/ |
BR_SEM_PARAR |
Telepass per il Brasile. Scopri di più all'indirizzo https://www.semparar.com.br. |
BR_TAGGY |
pedaggio brasiliano. Per ulteriori dettagli, visita la pagina 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 |
Ontario, Canada, al confine con 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. |
JP_ETC |
Giappone ETC. Sistema elettronico wireless per la riscossione dei pedaggi. https://www.go-etc.jp/ |
JP_ETC2 |
ETC 2.0. Nuova versione dell'ETC con ulteriore sconto e comunicazione bidirezionale tra i dispositivi sui veicoli e le antenne sulla strada. https://www.go-etc.jp/etc2/index.html |
MX_IAVE |
Messico https://iave.capufe.gob.mx/#/ |
MX_PASE |
Messico https://www.pase.com.mx |
MX_QUICKPASS |
Messico https://operadoravial.com/quick-pass/ |
MX_SISTEMA_TELEPEAJE_CHIHUAHUA |
Messico http://appsh.chihuahua.gob.mx/transparencia/?doc=/ingresos/TelepeajeFormato4.pdf |
MX_TAG_IAVE |
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_TELEVIA |
Società di pedaggi in Messico. Uno dei tanti che operano a Città del Messico. https://www.televia.com.mx |
MX_VIAPASS |
Pedaggio per il Messico. Per ulteriori dettagli, visita la pagina https://www.viapass.com.mx/viapass/web_home.aspx. |
US_AL_FREEDOM_PASS |
AL, USA. |
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS |
AK, USA. |
US_CA_FASTRAK |
CA, USA. |
US_CA_FASTRAK_CAV_STICKER |
Indica che il conducente ha una tessera FasTrak oltre all'adesivo Clean Air Vehicle (CAV) emesso dal 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. |
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 d'America. |
US_IL_EZPASSIL |
IL, Stati Uniti. |
US_IL_IPASS |
IL, Stati Uniti. |
US_IN_EZPASSIN |
IN, Stati Uniti. |
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 |
Los Angeles, Stati Uniti. |
US_MA_EZPASSMA |
MA, USA. |
US_MD_EZPASSMD |
MD, Stati Uniti. |
US_ME_EZPASSME |
ME, USA. |
US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD |
MI, USA. |
US_MI_BCPASS |
MI, USA. |
US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG |
MI, USA. |
US_MI_IQ_PROX_CARD |
MI, USA. Deprecato perché questo tipo di tessera non esiste più. |
US_MI_IQ_TAG |
MI, USA. |
US_MI_MACKINAC_BRIDGE_MAC_PASS |
MI, USA. |
US_MI_NEXPRESS_TOLL |
MI, USA. |
US_MN_EZPASSMN |
MN, 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 |
New York, Stati Uniti. |
US_NY_EZPASSNY |
NY, USA. |
US_OH_EZPASSOH |
OH, USA. |
US_PA_EZPASSPA |
Pennsylvania, Stati Uniti. |
US_RI_EZPASSRI |
RI, USA. |
US_SC_PALPASS |
SC, Stati Uniti. |
US_TX_AVI_TAG |
TX, Stati Uniti. |
US_TX_BANCPASS |
TX, Stati Uniti. |
US_TX_DEL_RIO_PASS |
TX, Stati Uniti. |
US_TX_EFAST_PASS |
TX, Stati Uniti. |
US_TX_EAGLE_PASS_EXPRESS_CARD |
TX, Stati Uniti. |
US_TX_EPTOLL |
TX, Stati Uniti. |
US_TX_EZ_CROSS |
TX, Stati Uniti. |
US_TX_EZTAG |
TX, Stati Uniti. |
US_TX_FUEGO_TAG |
TX, Stati Uniti. |
US_TX_LAREDO_TRADE_TAG |
TX, Stati Uniti. |
US_TX_PLUSPASS |
TX, Stati Uniti. |
US_TX_TOLLTAG |
TX, Stati Uniti. |
US_TX_TXTAG |
TX, Stati Uniti. |
US_TX_XPRESS_CARD |
TX, Stati Uniti. |
US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD |
UT, USA. |
US_VA_EZPASSVA |
Virginia, Stati Uniti. |
US_WA_BREEZEBY |
WA, Stati Uniti. |
US_WA_GOOD_TO_GO |
WA, USA. |
US_WV_EZPASSWV |
WV, Stati Uniti. |
US_WV_MEMORIAL_BRIDGE_TICKETS |
WV, Stati Uniti. |
US_WV_MOV_PASS |
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. Si applica solo alla modalità di viaggio AUTO.
Enum | |
---|---|
VEHICLE_EMISSION_TYPE_UNSPECIFIED |
Nessun tipo di emissione specificato. Il valore predefinito è GASOLINE. |
GASOLINE |
Veicolo a benzina/a benzina. |
ELECTRIC |
Veicolo elettrico. |
HYBRID |
Veicolo con alimentazione ibrida (ad esempio benzina + elettrico). |
VehicleInfo
Incapsula le informazioni del veicolo, ad esempio il tipo di emissioni del veicolo.
Campi | |
---|---|
emission_ |
Descrive il tipo di emissione del veicolo. Si applica solo al |
Waypoint
Incapsula un waypoint. I waypoint segnano l'inizio e la fine di un percorso e includono le 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_ |
Indica che il waypoint è destinato alla fermata dei veicoli, dove l'intenzione è il ritiro o il reso. Quando imposti questo valore, il percorso calcolato non includerà i waypoint non |
side_ |
Indica che la posizione di questo waypoint è destinata a avere una preferenza per la fermata del veicolo su un determinato lato della strada. Quando imposti questo valore, il percorso attraversa la posizione in modo che il veicolo possa fermarsi sul lato della strada inclinato rispetto al centro della strada. Questa opzione funziona solo per le modalità di viaggio "DRIVE" e "TWO_WHEELER". |
Campo 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, inclusa un'intestazione facoltativa. |
place_ |
L'ID luogo del PDI associato alla tappa. |