- Richiesta HTTP
- Corpo della richiesta
- Corpo della risposta
- PolylineQuality
- PolylineEncoding
- Unità
- ReferenceRoute
- ExtraComputation
- Itinerario
- RouteLabel
- RouteLeg
- Polilinea
- RouteLegStep
- NavigationInstruction
- Manovra
- RouteLegStepTravelAdvisory
- RouteLegStepLocalizedValues
- RouteLegStepTransitDetails
- TransitStopDetails
- TransitStop
- TransitDetailsLocalizedValues
- LocalizedTime
- TransitLine
- TransitAgency
- TransitVehicle
- TransitVehicleType
- RouteLegTravelAdvisory
- RouteLegLocalizedValues
- StepsOverview
- MultiModalSegment
- Area visibile
- RouteLocalizedValues
- GeocodingResults
- GeocodedWaypoint
Restituisce il percorso principale insieme a percorsi alternativi facoltativi, in base a una serie di tappe terminal e intermedi.
NOTA: questo metodo richiede l'indicazione di una maschera per il campo della risposta nell'input. Puoi fornire la maschera del campo di risposta utilizzando il parametro URL $fields
o fields
oppure un'intestazione HTTP/gRPC X-Goog-FieldMask
(consulta le intestazioni e i parametri URL disponibili). Il valore è un elenco di percorsi dei campi separati da virgole. Consulta la documentazione dettagliata su come creare i percorsi dei campi.
Ad esempio, in questo metodo:
- Maschera per tutti i campi disponibili (per l'ispezione manuale):
X-Goog-FieldMask: *
- Maschera per il campo di durata, distanza e polilinea a livello di route (una configurazione di produzione di esempio):
X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline
Google sconsiglia l'utilizzo della maschera per il campo di risposta con caratteri jolly (*
) oppure specifica la maschera del campo al livello superiore (routes
), perché:
- La selezione dei soli campi necessari consente al nostro server di salvare i cicli di calcolo, consentendoci di restituirti il risultato con una latenza inferiore.
- La selezione dei soli campi necessari nel job di produzione garantisce prestazioni di latenza stabili. In futuro potremmo aggiungere altri campi di risposta e questi nuovi campi potrebbero richiedere tempi di calcolo aggiuntivi. Se selezioni tutti i campi o tutti i campi al livello più alto, potresti riscontrare un peggioramento delle prestazioni perché qualsiasi nuovo campo che aggiungiamo verrà incluso automaticamente nella risposta.
- La selezione solo dei campi necessari comporta una riduzione delle dimensioni della risposta e, di conseguenza, una velocità effettiva di rete superiore.
Richiesta HTTP
POST https://routes.googleapis.com/directions/v2:computeRoutes
L'URL utilizza la sintassi di transcodifica gRPC.
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{ "origin": { object ( |
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. |
travelMode |
Campo facoltativo. Specifica la modalità di trasporto. |
routingPreference |
Campo facoltativo. Specifica come calcolare la route. Il server tenta di utilizzare la preferenza di routing selezionata per calcolare la route. Se la preferenza di routing genera un errore o una latenza molto lunga, viene restituito un errore. Puoi specificare questa opzione solo quando |
polylineQuality |
Campo facoltativo. Specifica la tua preferenza per la qualità della polilinea. |
polylineEncoding |
Campo facoltativo. Specifica la codifica preferita per la polilinea. |
departureTime |
Campo facoltativo. L'orario di partenza. Se non imposti questo valore, il valore predefinito sarà l'ora in cui hai effettuato la richiesta. NOTA: è possibile specificare un Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
arrivalTime |
Campo facoltativo. L'ora di arrivo. NOTA: può essere impostato solo quando il criterio Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
computeAlternativeRoutes |
Campo facoltativo. Specifica se calcolare percorsi alternativi in aggiunta al percorso. Non vengono restituite route alternative per le richieste con tappe intermedi. |
routeModifiers |
Campo facoltativo. Un insieme di condizioni da soddisfare che influiscono sul modo in cui vengono calcolati i percorsi. |
languageCode |
Campo facoltativo. Il codice lingua BCP-47, ad esempio "en-US" o "sr-Latn". Per ulteriori informazioni, consulta la sezione Identificatore impostazioni internazionali Unicode. 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. |
regionCode |
Campo facoltativo. Il codice regione specificato come valore di due caratteri ccTLD ("dominio di primo livello"). Per ulteriori informazioni, consulta l'articolo sui domini di primo livello nazionali. |
units |
Campo facoltativo. Specifica le unità di misura per i campi di visualizzazione. Questi campi includono il campo |
optimizeWaypointOrder |
Campo facoltativo. Se è impostato su true, il servizio tenta di ridurre al minimo il costo complessivo del percorso riordinando i tappe intermedi specificati. La richiesta non va a buon fine se uno dei punti intermedi intermedi è un Waypoint |
requestedReferenceRoutes[] |
Campo facoltativo. Specifica quali route di riferimento calcolare come parte della richiesta, oltre alla route predefinita. Un percorso di riferimento è un percorso con un obiettivo di calcolo del percorso diverso rispetto al percorso predefinito. Ad esempio, il calcolo di un percorso di riferimento di |
extraComputations[] |
Campo facoltativo. Un elenco di calcoli aggiuntivi che possono essere utilizzati per completare la richiesta. Nota: questi calcoli aggiuntivi potrebbero restituire campi aggiuntivi nella risposta. Questi campi aggiuntivi devono essere specificati anche nella maschera del campo affinché vengano restituiti nella risposta. |
trafficModel |
Campo facoltativo. Specifica le ipotesi da utilizzare per il calcolo del tempo nel traffico. Questa impostazione influisce sul valore restituito nel campo della durata nei campi |
transitPreferences |
Campo facoltativo. Specifica le preferenze che influiscono sul percorso restituito per |
Corpo della risposta
v2.computeRoutes il messaggio di risposta.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{ "routes": [ { object ( |
Campi | |
---|---|
routes[] |
Contiene un array di route calcolate (fino a tre) quando specifichi |
fallbackInfo |
In alcuni casi, quando il server non è in grado di calcolare i risultati delle route con tutte le preferenze di input, potrebbe utilizzare un metodo di calcolo diverso per farlo. Quando viene utilizzata la modalità di riserva, questo campo contiene informazioni dettagliate sulla risposta di riserva. In caso contrario, il campo non viene configurato. |
geocodingResults |
Contiene informazioni di risposta di geocodifica per tappe specificati come indirizzi. |
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 . |
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 |
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). |
ReferenceRoute
Una route di riferimento supportata su ComputeRoutesRequest.
Enum | |
---|---|
REFERENCE_ROUTE_UNSPECIFIED |
Non utilizzato. Le richieste contenenti questo valore non vanno a buon fine. |
FUEL_EFFICIENT |
Percorso a basso consumo di carburante. I percorsi etichettati con questo valore vengono determinati come ottimizzati per parametri come il consumo di carburante. |
ExtraComputation
Calcoli aggiuntivi da eseguire durante il completamento della richiesta.
Enum | |
---|---|
EXTRA_COMPUTATION_UNSPECIFIED |
Non utilizzato. Le richieste contenenti questo valore non andranno a buon fine. |
TOLLS |
Informazioni sui pedaggi per i percorsi. |
FUEL_CONSUMPTION |
Consumo stimato di carburante per i percorsi. |
TRAFFIC_ON_POLYLINE |
Polilinee sensibili al traffico per le route. |
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS |
NavigationInstructions presentato come stringa di testo HTML formattata. Questi contenuti devono essere letti così come sono. Questi contenuti sono solo per la visualizzazione. Non analizzarlo in modo programmatico. |
Route
Contiene un percorso, costituito da una serie di tratti di strada collegati che uniscono i punti di partenza, di arrivo e intermedi.
Rappresentazione JSON |
---|
{ "routeLabels": [ enum ( |
Campi | |
---|---|
routeLabels[] |
Etichette per |
legs[] |
Un insieme di tratti (segmenti di percorso tra i tappe) che compongono il percorso. Ogni tratto corrisponde alla corsa tra due |
distanceMeters |
La distanza da percorrere del percorso, in metri. |
duration |
Il tempo necessario per percorrere il percorso. Se imposti Una durata in secondi con un massimo di nove cifre frazionarie, che termina con " |
staticDuration |
La durata del percorso senza tenere conto delle condizioni del traffico. Una durata in secondi con un massimo di nove cifre frazionarie, che termina con " |
polyline |
La polilinea del percorso complessivo. Questa polilinea è 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. |
travelAdvisory |
Informazioni aggiuntive sul percorso. |
optimizedIntermediateWaypointIndex[] |
Se imposti |
localizedValues |
Rappresentazioni testuali delle proprietà dell'elemento |
routeToken |
Un token di route sicuro per il Web con codifica Base64 che può essere passato all'SDK di navigazione, che consente a quest'ultimo di ricostruire il percorso durante la navigazione e, in caso di rielaborazione del percorso, di rispettare l'intenzione originale di creare il percorso chiamando v2.computeRoutes. I clienti dovrebbero considerare questo token come un blob opaco. Non è destinata alla lettura o alla mutazione. NOTA: |
RouteLabel
Etichette per
che sono utili per identificare proprietà specifiche del percorso da confrontare con altre.Route
Enum | |
---|---|
ROUTE_LABEL_UNSPECIFIED |
Predefinito: non utilizzato. |
DEFAULT_ROUTE |
La route "migliore" predefinita restituita per il calcolo delle route. |
DEFAULT_ROUTE_ALTERNATE |
Un'alternativa al percorso "migliore" predefinito. Route come questa verranno restituite quando è specificato . |
FUEL_EFFICIENT |
Percorso a basso consumo di carburante. I percorsi etichettati con questo valore vengono ottimizzati in base ai parametri Eco come il consumo di carburante. |
RouteLeg
Contiene un segmento tra tappe non via
.
Rappresentazione JSON |
---|
{ "distanceMeters": integer, "duration": string, "staticDuration": string, "polyline": { object ( |
Campi | |
---|---|
distanceMeters |
La distanza da percorrere per la tratta del percorso, in metri. |
duration |
Il tempo necessario per navigare nella gamba. Se Una durata in secondi con un massimo di nove cifre frazionarie, che termina con " |
staticDuration |
La durata del tragitto, calcolata senza tenere conto delle condizioni del traffico. Una durata in secondi con un massimo di nove cifre frazionarie, che termina con " |
polyline |
La polilinea complessiva di questa gamba che include la polilinea di ogni |
startLocation |
La posizione di partenza di questa tappa. Questa località potrebbe essere diversa da quella di |
endLocation |
La posizione finale di questa tappa. Questa località potrebbe essere diversa da quella di |
steps[] |
Un array di passaggi che indicano i segmenti all'interno di questa gamba. Ogni passaggio rappresenta un'istruzione di navigazione. |
travelAdvisory |
Contiene le informazioni aggiuntive di cui è necessario informare l'utente, come eventuali limitazioni delle zone di traffico, in un tratto del percorso. |
localizedValues |
Rappresentazioni testuali delle proprietà dell'elemento |
stepsOverview |
Informazioni generali sui passaggi descritti in questo |
Polilinea
Incapsula una polilinea codificata.
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo di unione polyline_type . Incapsula il tipo di polilinea. Il valore predefinito è coded_polyline. polyline_type può essere solo uno dei seguenti: |
|
encodedPolyline |
La codifica stringa della polilinea utilizzando l'algoritmo di codifica delle polilinea. |
geoJsonLinestring |
Specifica una polilinea utilizzando il formato LineString GeoJSON. |
RouteLegStep
Contiene un segmento di
. Un passo corrisponde a una singola istruzione di navigazione. Le parti del percorso sono composte da gradini.RouteLeg
Rappresentazione JSON |
---|
{ "distanceMeters": integer, "staticDuration": string, "polyline": { object ( |
Campi | |
---|---|
distanceMeters |
La distanza da percorrere per questo passo, in metri. In alcuni casi, questo campo potrebbe non avere un valore. |
staticDuration |
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. Una durata in secondi con un massimo di nove cifre frazionarie, che termina con " |
polyline |
La polilinea associata a questo passaggio. |
startLocation |
La posizione iniziale di questo passaggio. |
endLocation |
La posizione finale di questo passaggio. |
navigationInstruction |
Istruzioni di navigazione. |
travelAdvisory |
Contiene le informazioni aggiuntive di cui l'utente deve essere informato, come eventuali limitazioni delle zone di traffico, in un passaggio della tratta. |
localizedValues |
Rappresentazioni testuali delle proprietà dell'elemento |
transitDetails |
Dettagli relativi a questo passaggio se la modalità di viaggio è |
travelMode |
La modalità di viaggio utilizzata per questo passaggio. |
Manovra
Un insieme di valori che specifica l'azione di navigazione da eseguire per il passaggio corrente (ad esempio, svolta a sinistra, unisci o dritto).
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. |
DEPART |
Manovra iniziale. |
NAME_CHANGE |
Utilizzato per indicare la modifica del nome della via. |
RouteLegStepTravelAdvisory
Contiene le informazioni aggiuntive di cui è necessario informare l'utente, come le possibili limitazioni delle zone di traffico in un passo della tratta.
Rappresentazione JSON |
---|
{
"speedReadingIntervals": [
{
object ( |
Campi | |
---|---|
speedReadingIntervals[] |
NOTA: questo campo attualmente non viene compilato. |
RouteLegStepLocalizedValues
Rappresentazioni testuali di determinate proprietà.
Rappresentazione JSON |
---|
{ "distance": { object ( |
Campi | |
---|---|
distance |
Distanza da percorrere rappresentata in formato di testo. |
staticDuration |
Durata senza prendere in considerazione le condizioni del traffico, espressa in formato testo. |
RouteLegStepTransitDetails
Informazioni aggiuntive per RouteLegStep
relative alle route TRANSIT
.
Rappresentazione JSON |
---|
{ "stopDetails": { object ( |
Campi | |
---|---|
stopDetails |
Informazioni sulle fermate di arrivo e partenza per il passaggio. |
localizedValues |
Rappresentazioni testuali delle proprietà dell'elemento |
headsign |
Specifica la direzione in cui viaggiare su questa linea, indicata sul veicolo o alla fermata di partenza. La direzione è spesso il capolinea. |
headway |
Specifica l'orario previsto come durata tra partenze dalla stessa fermata in questo momento. Ad esempio, con un valore di 600 secondi all'inizio, ti aspetti un'attesa di dieci minuti se perdi l'autobus. Una durata in secondi con un massimo di nove cifre frazionarie, che termina con " |
transitLine |
Informazioni sulla linea di trasporto pubblico utilizzata in questo passaggio. |
stopCount |
Il numero di fermate dalla partenza alla fermata di arrivo. Questo conteggio include la fermata di arrivo, ma è esclusa la fermata di partenza. Ad esempio, se il tuo percorso parte dalla fermata A, passa per le fermate B e C e arriva alla fermata D, stopCount restituirà 3. |
tripShortText |
Il testo visualizzato negli orari e sui cartelli per identificare una corsa di trasporto pubblico per i passeggeri. Il testo deve identificare in modo univoco una corsa entro un giorno di servizio. Ad esempio, "538" è la |
TransitStopDetails
Dettagli sulle fermate dei mezzi di trasporto pubblico RouteLegStep
.
Rappresentazione JSON |
---|
{ "arrivalStop": { object ( |
Campi | |
---|---|
arrivalStop |
Informazioni sulla fermata di arrivo per il passaggio. |
arrivalTime |
L'ora di arrivo prevista per il passaggio. Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
departureStop |
Informazioni sulla fermata di partenza per il passaggio. |
departureTime |
L'ora di partenza prevista per il passaggio. Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
TransitStop
Informazioni su una fermata del trasporto pubblico.
Rappresentazione JSON |
---|
{
"name": string,
"location": {
object ( |
Campi | |
---|---|
name |
Il nome della fermata del trasporto pubblico. |
location |
La posizione della fermata espressa in coordinate di latitudine/longitudine. |
TransitDetailsLocalizedValues
Descrizioni localizzate dei valori di RouteTransitDetails
.
Rappresentazione JSON |
---|
{ "arrivalTime": { object ( |
Campi | |
---|---|
arrivalTime |
Ora nella sua rappresentazione testuale formattata con il fuso orario corrispondente. |
departureTime |
Ora nella sua rappresentazione testuale formattata con il fuso orario corrispondente. |
LocalizedTime
Descrizione localizzata dell'ora.
Rappresentazione JSON |
---|
{
"time": {
object ( |
Campi | |
---|---|
time |
L'ora specificata come stringa in un determinato fuso orario. |
timeZone |
Contiene il fuso orario. Il valore è il nome del fuso orario definito nel database dei fusi orari IANA, ad esempio "America/New_York". |
TransitLine
Contiene informazioni sulla linea di trasporto pubblico utilizzata in questo passaggio.
Rappresentazione JSON |
---|
{ "agencies": [ { object ( |
Campi | |
---|---|
agencies[] |
L'azienda (o le aziende) che gestiscono questa linea di trasporto pubblico. |
name |
Il nome completo di questa linea di trasporto pubblico, ad esempio "8 Avenue Local". |
uri |
l'URI di questa linea di trasporto pubblico fornito dall'azienda di trasporto pubblico. |
color |
Il colore comunemente utilizzato nella segnaletica di questa linea. Rappresentato in esadecimale. |
iconUri |
L'URI dell'icona associato a questa riga. |
nameShort |
Il nome breve di questa linea di trasporto pubblico. Normalmente questo nome è un numero di riga, come "M7" o "355". |
textColor |
Il colore comunemente utilizzato nel testo sulla segnaletica di questa riga. Rappresentato in esadecimale. |
vehicle |
Il tipo di veicolo che opera su questa linea di trasporto pubblico. |
TransitAgency
Un'azienda di trasporto pubblico che gestisce una linea di trasporto pubblico.
Rappresentazione JSON |
---|
{ "name": string, "phoneNumber": string, "uri": string } |
Campi | |
---|---|
name |
Il nome dell'azienda di trasporto pubblico. |
phoneNumber |
Il numero di telefono nel formato specifico della lingua dell'azienda di trasporto pubblico. |
uri |
L'URI dell'azienda di trasporto pubblico. |
TransitVehicle
Informazioni su un veicolo utilizzato nei percorsi di trasporto pubblico.
Rappresentazione JSON |
---|
{ "name": { object ( |
Campi | |
---|---|
name |
Il nome del veicolo in maiuscolo. |
type |
Il tipo di veicolo utilizzato. |
iconUri |
L'URI di un'icona associata a questo tipo di veicolo. |
localIconUri |
L'URI dell'icona associato a questo tipo di veicolo, basato sulla segnaletica di trasporto locale. |
TransitVehicleType
Il tipo di veicoli per i percorsi di trasporto pubblico.
Enum | |
---|---|
TRANSIT_VEHICLE_TYPE_UNSPECIFIED |
Non utilizzato. |
BUS |
Autobus. |
CABLE_CAR |
Un veicolo collegato a un cavo, solitamente a terra. Le funivie aeree potrebbero essere del tipo GONDOLA_LIFT . |
COMMUTER_TRAIN |
Treno suburbano. |
FERRY |
Traghetto. |
FUNICULAR |
Un veicolo trainato da un cavo su una ripida pendenza. Una funicolare in genere è composta da due auto, ognuna delle quali funge da contrappeso. |
GONDOLA_LIFT |
Una funivia. |
HEAVY_RAIL |
Treno pesante. |
HIGH_SPEED_TRAIN |
Treno ad alta velocità. |
INTERCITY_BUS |
Autobus interurbano. |
LONG_DISTANCE_TRAIN |
Treno a lunga percorrenza. |
METRO_RAIL |
Metropolitana leggera. |
MONORAIL |
Monorotaia. |
OTHER |
Tutti gli altri veicoli. |
RAIL |
Treno. |
SHARE_TAXI |
Il taxi condiviso è un tipo di autobus in grado di far scendere e far salire e scendere i passeggeri in qualsiasi punto del percorso. |
SUBWAY |
Metropolitana leggera sotterranea. |
TRAM |
Metropolitana leggera sopra il suolo. |
TROLLEYBUS |
Filobus. |
RouteLegTravelAdvisory
Contiene le informazioni aggiuntive di cui l'utente deve essere informato in un passaggio della tratta, come possibili limitazioni delle zone di traffico.
Rappresentazione JSON |
---|
{ "tollInfo": { object ( |
Campi | |
---|---|
tollInfo |
Contiene informazioni sui pedaggi in |
speedReadingIntervals[] |
Intervalli di lettura della velocità che forniscono dettagli sulla densità del traffico. Applicabile in caso di preferenze di routing Esempio:
|
RouteLegLocalizedValues
Rappresentazioni testuali di determinate proprietà.
Rappresentazione JSON |
---|
{ "distance": { object ( |
Campi | |
---|---|
distance |
Distanza da percorrere rappresentata in formato di testo. |
duration |
Durata che tiene conto delle condizioni del traffico, rappresentata in formato testo. Nota: se non hai richiesto informazioni sul traffico, questo valore corrisponderà a quello di staticDuration. |
staticDuration |
Durata senza prendere in considerazione le condizioni del traffico, espressa in formato testo. |
StepsOverview
Fornisce informazioni generali su un elenco di RouteLegStep
.
Rappresentazione JSON |
---|
{
"multiModalSegments": [
{
object ( |
Campi | |
---|---|
multiModalSegments[] |
Informazioni riassunte sui diversi segmenti multimodali di |
MultiModalSegment
Fornisce informazioni riepilogative sui diversi segmenti multimodali di RouteLeg.steps
. Un segmento multimodale è definito come uno o più RouteLegStep
contigui che hanno lo stesso RouteTravelMode
. Questo campo non viene compilato se RouteLeg
non contiene segmenti multimodali nei passaggi.
Rappresentazione JSON |
---|
{ "navigationInstruction": { object ( |
Campi | |
---|---|
navigationInstruction |
NavigationIstruzioni per il segmento multimodale. |
travelMode |
La modalità di viaggio nel segmento multimodale. |
stepStartIndex |
L'indice |
stepEndIndex |
L'indice |
Area visibile
Un'area visibile di latitudine e longitudine, rappresentata da due punti diagonalmente opposti a low
e high
. Un'area visibile è considerata una regione chiusa, ovvero include il proprio confine. I limiti di latitudine devono essere compresi tra -90 e 90 gradi inclusi, mentre i limiti di longitudine devono essere compresi tra -180 e 180 gradi inclusi. Ecco alcuni casi:
Se
low
=high
, l'area visibile è composta da quel singolo punto.Se
low.longitude
>high.longitude
, l'intervallo di longitudine viene invertito (l'area visibile attraversa la linea di longitudine di 180 gradi).Se
low.longitude
= -180 gradi ehigh.longitude
= 180 gradi, l'area visibile include tutte le longitudini.Se
low.longitude
= 180 gradi ehigh.longitude
= -180 gradi, l'intervallo di longitudine è vuoto.Se
low.latitude
>high.latitude
, l'intervallo di latitudine è vuoto.
È necessario compilare entrambi i campi low
e high
e la casella rappresentata non può essere vuota (come specificato dalle definizioni precedenti). Un'area visibile vuota causerà un errore.
Ad esempio, questa area visibile include completamente New York:
{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }
Rappresentazione JSON |
---|
{ "low": { object ( |
Campi | |
---|---|
low |
Obbligatorio. Il punto basso dell'area visibile. |
high |
Obbligatorio. Il punto più alto dell'area visibile. |
RouteLocalizedValues
Rappresentazioni testuali di determinate proprietà.
Rappresentazione JSON |
---|
{ "distance": { object ( |
Campi | |
---|---|
distance |
Distanza da percorrere rappresentata in formato di testo. |
duration |
Durata che tiene conto delle condizioni del traffico, rappresentata in formato testo. Nota: se non hai richiesto informazioni sul traffico, questo valore corrisponderà a |
staticDuration |
Durata senza prendere in considerazione le condizioni del traffico, espressa in formato testo. |
transitFare |
Tariffa di trasporto pubblico rappresentata in formato testo. |
GeocodingResults
Contiene
per i punti di partenza, di arrivo e intermedi. Compilato solo per i Waypoint dell'indirizzo.GeocodedWaypoints
Rappresentazione JSON |
---|
{ "origin": { object ( |
Campi | |
---|---|
origin |
Waypoint geocodificato dell'origine. |
destination |
Waypoint geocodificato della destinazione. |
intermediates[] |
Un elenco di tappe intermedie geocodificati, ciascuno contenente un campo indice che corrisponde alla posizione in base zero del Waypoint nell'ordine in cui sono stati specificati nella richiesta. |
GeocodedWaypoint
Dettagli sulle posizioni utilizzate come tappe. Compilato solo per i Waypoint dell'indirizzo. Include dettagli sui risultati di geocodifica per stabilire in quale località è stato geocodificato l'indirizzo.
Rappresentazione JSON |
---|
{
"geocoderStatus": {
object ( |
Campi | |
---|---|
geocoderStatus |
Indica il codice di stato risultante dall'operazione di geocodifica. |
type[] |
Il tipo o i tipi del risultato, sotto forma di zero o più tag di tipo. Tipi supportati: tipi di indirizzo e tipi di componenti degli indirizzi. |
partialMatch |
Indica che il geocodificatore non ha restituito una corrispondenza esatta per la richiesta originale, anche se è riuscita a corrispondere a una parte dell'indirizzo richiesto. Ti consigliamo di esaminare la richiesta originale per verificare la presenza di errori ortografici e/o un indirizzo incompleto. |
placeId |
L'ID luogo per questo risultato. |
intermediateWaypointRequestIndex |
L'indice del Waypoint intermedio corrispondente nella richiesta. Viene compilata solo se il tappa corrispondente è un tappa intermedia. |