- Richiesta HTTP
- Corpo della richiesta
- Corpo della risposta
- PolylineQuality
- PolylineCode
- Unità
- Percorso di riferimento
- Computazione extra
- Percorso
- Etichetta route
- PercorsoLeg
- Polilinea
- PercorsoLegStep
- Istruzioni di navigazione
- Manovra
- RouteLegStepTravelAdvisory
- RouteLegStepLocalizedValues
- RouteLegStepTransitDetails
- TransitStopDetails
- TransitStop
- TransitDetailsLocalizedValues
- Ora localizzata
- TransitLine
- Agenzia di trasporto pubblico
- Trasporto pubblico
- Tipo di veicolo trasporto pubblico
- RouteLegTravelAdvisory
- RouteLegLocalizedValues
- Panoramica dei passaggi
- MultiModalSegment
- Viewport
- RouteLocalizedValues
- Risultati geocodificati
- Punto di accesso geocodificato
Restituisce il percorso principale insieme a percorsi alternativi facoltativi, considerati un insieme di terminali e tappe intermedie.
NOTA: questo metodo richiede di specificare una maschera da campo di risposta nell'input. Puoi fornire la maschera del campo di risposta utilizzando il parametro URL $fields
o fields
o un'intestazione HTTP/gRPC X-Goog-FieldMask
(consulta le intestazioni e i parametri URL disponibili). Il valore è un elenco di percorsi di campo separati da virgole. Consulta la documentazione dettagliata su come creare i percorsi dei campi.
Ad esempio, con questo metodo:
- Maschera di campo di tutti i campi disponibili (per l'ispezione manuale):
X-Goog-FieldMask: *
- Maschera di campo della durata a livello di percorso, della distanza e della polilinea (un esempio di configurazione della produzione):
X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline
Google sconsiglia l'utilizzo della maschera di campo con caratteri jolly (*
) o specifica la maschera di 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. Potremmo aggiungere altri campi di risposta in futuro e questi nuovi campi potrebbero richiedere più tempo di calcolo. Se selezioni tutti i campi o se selezioni tutti i campi al livello più alto, potresti riscontrare un peggioramento del rendimento perché qualsiasi nuovo campo aggiunto verrà automaticamente incluso nella risposta.
- Se selezioni solo i campi necessari, ottieni una dimensione di risposta inferiore e quindi una velocità effettiva di rete più elevata.
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 origine. |
destination |
Obbligatorio. Waypoint di destinazione. |
intermediates[] |
Campo facoltativo. Un insieme di tappe lungo il percorso (esclusi i punti di ritiro), per fermarsi o passare. Sono supportati fino a 25 tappe intermedie. |
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 particolarmente lunga, verrà 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 corrisponderà all'ora in cui hai effettuato la richiesta. NOTA: puoi specificare un Un timestamp nel formato "Zulu" UTC RFC3339, con una risoluzione di nanosecondi e fino a nove cifre frazionarie. Esempi: |
arrivalTime |
Campo facoltativo. L'ora di arrivo. NOTA: può essere impostato solo quando Un timestamp nel formato "Zulu" UTC RFC3339, con una risoluzione di nanosecondi e fino a nove cifre frazionarie. Esempi: |
computeAlternativeRoutes |
Campo facoltativo. Specifica se calcolare i percorsi alternativi oltre al percorso. Non vengono restituiti percorsi alternativi per le richieste con tappe intermedie. |
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, visita il sito http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Visita la pagina Assistenza per le lingue per l'elenco delle lingue supportate. Se non specifichi questo valore, la lingua di visualizzazione viene dedotta dal percorso della richiesta di percorso. |
regionCode |
Campo facoltativo. Il codice regione, specificato come valore di due caratteri ccTLD ("dominio di primo livello"). Per ulteriori informazioni, visita https://en.wikipedia.org/wiki/List_of_Internet_top-level_domains#Country_code_top-level_domains. |
units |
Campo facoltativo. Specifica le unità di misura per i campi di visualizzazione. Questi campi includono il campo |
optimizeWaypointOrder |
Campo facoltativo. Se è impostata su true, il servizio tenta di ridurre al minimo il costo complessivo del percorso riordinando i tappe intermedie intermedi. La richiesta non va a buon fine se uno qualsiasi dei tappe intermedie è di tipo |
requestedReferenceRoutes[] |
Campo facoltativo. Specifica le route di riferimento da calcolare come parte della richiesta oltre alla route predefinita. Una route di riferimento è una route con un obiettivo di calcolo del percorso diverso rispetto alla route predefinita. Ad esempio, un calcolo del percorso di riferimento |
extraComputations[] |
Campo facoltativo. Un elenco di calcoli aggiuntivi che potrebbero 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 da restituire nella risposta. |
trafficModel |
Campo facoltativo. Specifica le ipotesi da utilizzare per il calcolo del tempo di traffico. Questa impostazione influisce sul valore restituito nel campo Durata in |
transitPreferences |
Campo facoltativo. Specifica le preferenze che influenzano la route restituita per |
Corpo della risposta
v2.computeRoutes del 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 compute_alternatives_routes e contiene un solo percorso in caso contrario. Se questo array contiene più voci, la prima è la route più consigliata. Se la matrice è vuota, significa che non è stato trovato alcun percorso. |
fallbackInfo |
In alcuni casi, quando il server non è in grado di calcolare i risultati del percorso con tutte le preferenze di input, potrebbe utilizzare 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 è impostato. |
geocodingResults |
Contiene informazioni sulla risposta di geocodifica per tappe specificati come indirizzi. |
Qualità Polilinea
Un insieme di valori che specificano la qualità della polilinea.
Enum | |
---|---|
POLYLINE_QUALITY_UNSPECIFIED |
Nessuna preferenza di qualità polilinea specificata. Il valore predefinito è OVERVIEW . |
HIGH_QUALITY |
Specifica una polilinea di alta qualità, composta da più punti rispetto a OVERVIEW , a un costo della risposta maggiore. Utilizza questo valore quando hai bisogno di una maggiore precisione. |
OVERVIEW |
Specifica una polilinea panoramica, composta da un numero limitato di punti. Utilizza questo valore quando visualizzi una panoramica del percorso. Questa opzione ha una latenza delle richieste inferiore rispetto all'opzione HIGH_QUALITY . |
Codifica di Polyline
Specifica il tipo 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 polilinea. |
GEO_JSON_LINESTRING |
Specifica una polilinea utilizzando il formato LineString GeoJSON |
Unità
Un insieme di valori che specifica l'unità di misura utilizzata nel display.
Enum | |
---|---|
UNITS_UNSPECIFIED |
Unità di misura non specificate. Il valore predefinito è l'unità di misura dedotta dalla richiesta. |
METRIC |
Unità di misura metriche. |
IMPERIAL |
Unità di misura imperiali (inglese). |
Percorso di riferimento
Una route di riferimento supportata in ComputeRoutesRequest.
Enum | |
---|---|
REFERENCE_ROUTE_UNSPECIFIED |
Non utilizzato. Richieste contenenti questo valore non riuscite. |
FUEL_EFFICIENT |
Percorso a basso consumo di carburante. I percorsi etichettati con questo valore sono determinati per l'ottimizzazione in base a parametri quali il consumo di carburante. |
Extracomputazione
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 sul pedaggio per i percorsi. |
FUEL_CONSUMPTION |
Consumo stimato di carburante per i percorsi. |
TRAFFIC_ON_POLYLINE |
Polilinee attente al traffico per i percorsi. |
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS |
Istruzioni di navigazione presentate come stringa di testo HTML formattata. Questi contenuti sono da leggere così come sono. Questi contenuti sono solo a scopo di visualizzazione. Non analizzarlo in modo programmatico. |
Itinerario
Contiene un percorso, costituito da una serie di tratti di strada collegati che uniscono i punti di inizio, di fine e intermedi.
Rappresentazione JSON |
---|
{ "routeLabels": [ enum ( |
Campi | |
---|---|
routeLabels[] |
Etichette di |
legs[] |
Un insieme di gambe (segmenti di percorso tra punti intermedi) che compongono il percorso. Ogni gamba corrisponde alla corsa tra due |
distanceMeters |
La distanza di percorrenza del percorso, in metri. |
duration |
Il tempo necessario per seguire il percorso. Se imposti Una durata in secondi con un massimo di nove cifre frazionarie, che termina con " |
staticDuration |
La durata del viaggio attraverso il percorso senza prendere in considerazione le 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 si mostra il percorso. |
viewport |
Il riquadro di delimitazione dell'area visibile della polilinea. |
travelAdvisory |
Ulteriori informazioni sul percorso. |
optimizedIntermediateWaypointIndex[] |
Se imposti |
localizedValues |
Rappresentazioni di testo delle proprietà di |
routeToken |
Un token di percorso sicuro per il web e con codifica base64 che può essere trasmesso all'SDK di navigazione, che consente alla piattaforma di ricostruire la route durante la navigazione e, in caso di cambio di percorso, di rispettare l'intenzione originale quando hai creato la route chiamando v2.computeRoutes. I clienti devono considerare questo token come un blob opaco. Non è destinata alla lettura o alla mutazione. NOTA: |
Etichetta route
Etichette di Route
utili per identificare le proprietà specifiche del percorso da confrontare con altri.
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 computeAlternativeRoutes è specificato. |
FUEL_EFFICIENT |
Percorso a basso consumo di carburante. I percorsi etichettati con questo valore sono determinati per l'ottimizzazione in base ai parametri Eco, come il consumo di carburante. |
Gamba del percorso
Contiene un segmento tra i tappe non via
.
Rappresentazione JSON |
---|
{ "distanceMeters": integer, "duration": string, "staticDuration": string, "polyline": { object ( |
Campi | |
---|---|
distanceMeters |
La distanza di percorrenza del percorso, in metri. |
duration |
Il tempo necessario per percorrere la gamba. Se il Una durata in secondi con un massimo di nove cifre frazionarie, che termina con " |
staticDuration |
La durata del viaggio attraverso la tratta, 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 comprende la polilinea di ogni |
startLocation |
La posizione iniziale di questa gamba. Questa località potrebbe essere diversa da quella specificata in |
endLocation |
La posizione finale di questa gamba. Questa località potrebbe essere diversa da quella specificata in |
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 su cui deve essere informato l'utente, ad esempio possibili limitazioni di zona di traffico, su un percorso. |
localizedValues |
Rappresentazioni di testo delle proprietà di |
stepsOverview |
Panoramica dei passaggi della |
Polilinea
Incapsula una polilinea codificata.
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo unione polyline_type . Incapsula il tipo di polilinea. Il valore predefinito è encoded_polyline. polyline_type può essere solo uno dei seguenti: |
|
encodedPolyline |
La codifica delle stringhe della polilinea utilizzando l'algoritmo di codifica della polilinea. |
geoJsonLinestring |
Specifica una polilinea utilizzando il formato LineString GeoJSON |
RouteLegStep
Contiene un segmento di RouteLeg
. Un passaggio corrisponde a una singola istruzione di navigazione. Le gambe del percorso sono composte da gradini.
Rappresentazione JSON |
---|
{ "distanceMeters": integer, "staticDuration": string, "polyline": { object ( |
Campi | |
---|---|
distanceMeters |
La distanza di percorrenza di questo passaggio, in metri. In alcune circostanze, questo campo potrebbe non contenere un valore. |
staticDuration |
La durata del viaggio attraverso questo passaggio senza prendere in considerazione le condizioni del traffico. In alcune circostanze, questo campo potrebbe non contenere 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 su cui l'utente deve essere informato, ad esempio possibili limitazioni di zona di traffico, su un passaggio di gamba. |
localizedValues |
Rappresentazioni di testo delle proprietà di |
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 es. svolta a sinistra, unione, dritto e così via).
Enum | |
---|---|
MANEUVER_UNSPECIFIED |
Non utilizzato. |
TURN_SLIGHT_LEFT |
Svolta leggermente a sinistra. |
TURN_SHARP_LEFT |
Svolta tutto a sinistra. |
UTURN_LEFT |
Fai una svolta a sinistra. |
TURN_LEFT |
Svolta a sinistra. |
TURN_SLIGHT_RIGHT |
Ruota leggermente a destra. |
TURN_SHARP_RIGHT |
Svolta tutto a destra. |
UTURN_RIGHT |
Fai una svolta a U corretta. |
TURN_RIGHT |
Svolta a destra. |
STRAIGHT |
Vai dritto. |
RAMP_LEFT |
Prendi la rampa a sinistra. |
RAMP_RIGHT |
Prendi la rampa giusta. |
MERGE |
Unisci nel traffico. |
FORK_LEFT |
Prendi la forcella a sinistra. |
FORK_RIGHT |
Prendi la forcella giusta. |
FERRY |
Prendi il traghetto. |
FERRY_TRAIN |
Prendi il treno che porta al traghetto. |
ROUNDABOUT_LEFT |
Svolta a sinistra alla rotonda. |
ROUNDABOUT_RIGHT |
Svolta a destra alla rotatoria. |
DEPART |
Manovra iniziale. |
NAME_CHANGE |
Utilizzato per indicare un cambiamento del nome della via. |
Avvertenza - RouteLegStepTravel
Contiene le informazioni aggiuntive su cui deve essere informato l'utente, ad esempio possibili limitazioni del traffico in un passaggio della gamba.
Rappresentazione JSON |
---|
{
"speedReadingIntervals": [
{
object ( |
Campi | |
---|---|
speedReadingIntervals[] |
NOTA: questo campo non è attualmente compilato. |
ValoriLocalizzatiP non
Rappresentazioni di testo di determinate proprietà.
Rappresentazione JSON |
---|
{ "distance": { object ( |
Campi | |
---|---|
distance |
Distanza percorsa in forma di testo. |
staticDuration |
La durata senza tenere conto delle condizioni del traffico, rappresentata sotto forma di testo. |
Dettaglio RouteLegStepTransit
Informazioni aggiuntive per RouteLegStep
relative a TRANSIT
percorsi.
Rappresentazione JSON |
---|
{ "stopDetails": { object ( |
Campi | |
---|---|
stopDetails |
Informazioni sulle fermate di arrivo e partenza per il passaggio. |
localizedValues |
Rappresentazioni di testo delle proprietà di |
headsign |
Specifica la direzione in cui percorrere su questa linea come indicato sul veicolo o alla fermata di partenza. La direzione è spesso la stazione del capolinea. |
headway |
Specifica l'orario previsto come durata tra le partenze dalla stessa fermata in questo momento. Ad esempio, con un valore di 600 secondi per la differenza, ti aspetteresti un'attesa di dieci minuti se dovessi perdere 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 dell'arrivo. Questo conteggio include la fermata di arrivo, ma esclude la fermata di partenza. Ad esempio, se il percorso parte dalla fermata A, attraversa le fermate B e C e arriva alla fermata D, stopCount restituisce 3. |
tripShortText |
Il testo visualizzato negli orari e sui cartelli per identificare un viaggio con il trasporto pubblico ai passeggeri. Il testo deve identificare in modo univoco una corsa entro un giorno di servizio. Ad esempio "538" è il |
Dettagli fermata trasporto pubblico
Dettagli sulle fermate del trasporto pubblico per RouteLegStep
Rappresentazione JSON |
---|
{ "arrivalStop": { object ( |
Campi | |
---|---|
arrivalStop |
Informazioni sulla fermata di arrivo del passaggio. |
arrivalTime |
L'orario di arrivo previsto del passaggio. Un timestamp nel formato "Zulu" UTC RFC3339, con una risoluzione di nanosecondi e fino a nove cifre frazionarie. Esempi: |
departureStop |
Informazioni sulla fermata del passaggio. |
departureTime |
L'orario di partenza stimato per il passaggio. Un timestamp nel formato "Zulu" UTC RFC3339, con una risoluzione di nanosecondi e fino a nove cifre frazionarie. Esempi: |
Fermata trasporto pubblico
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 nelle coordinate di latitudine/longitudine. |
Valori TransitLocalLocalizedValues
Descrizioni localizzate dei valori per RouteTransitDetails.
Rappresentazione JSON |
---|
{ "arrivalTime": { object ( |
Campi | |
---|---|
arrivalTime |
L'ora nella rappresentazione testuale formattata con il fuso orario corrispondente. |
departureTime |
L'ora nella rappresentazione testuale formattata con il fuso orario corrispondente. |
Ora localizzata
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". |
Linea di trasporto pubblico
Contiene informazioni sulla linea di trasporto pubblico utilizzata in questo passaggio.
Rappresentazione JSON |
---|
{ "agencies": [ { object ( |
Campi | |
---|---|
agencies[] |
L'azienda di trasporto che gestisce questa linea di trasporto pubblico. |
name |
Il nome completo di questa linea di trasporto pubblico, ad esempio "Via Verdi Corso Italia". |
uri |
L'URI di questa linea di trasporto pubblico indicato dall'azienda di trasporto pubblico. |
color |
Il colore di uso comune nella segnaletica per questa linea. Rappresentato in esadecimale. |
iconUri |
L'URI dell'icona associata a questa riga. |
nameShort |
Il nome breve di questa linea di trasporto pubblico. In genere questo nome è un numero di riga, ad esempio "M7" o "355". |
textColor |
Il colore comunemente utilizzato nel testo sull'insegna per questa linea. Rappresentato in esadecimale. |
vehicle |
Il tipo di veicolo che opera su questa linea di trasporto pubblico. |
Azienda trasporto pubblico
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 formattato dell'azienda di trasporto pubblico. |
uri |
URI dell'azienda di trasporto pubblico. |
Trasporto pubblico
Informazioni su un veicolo utilizzato nei percorsi di trasporto pubblico.
Rappresentazione JSON |
---|
{ "name": { object ( |
Campi | |
---|---|
name |
Il nome di questo 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 associata a questo tipo di veicolo, in base alla segnaletica locale per il trasporto pubblico. |
Tipo di veicolo trasporto pubblico
Il tipo di veicoli per i percorsi del trasporto pubblico.
Enum | |
---|---|
TRANSIT_VEHICLE_TYPE_UNSPECIFIED |
Non utilizzato. |
BUS |
Autobus. |
CABLE_CAR |
Un veicolo che funziona su un cavo, solitamente a terra. Le funivie aeree possono essere del tipo GONDOLA_LIFT . |
COMMUTER_TRAIN |
Ferrovia suburbana. |
FERRY |
Traghetto. |
FUNICULAR |
Un veicolo che sale su una pendenza. Una funicolare di solito è costituita da due carrozze, ciascuna delle quali funge da contrappeso per l'altra. |
GONDOLA_LIFT |
Una funivia. |
HEAVY_RAIL |
Ferrovia 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 |
Ferrovia. |
SHARE_TAXI |
Il taxi condiviso è un tipo di autobus con la possibilità di scendere e prendere passeggeri ovunque sul suo percorso. |
SUBWAY |
Metropolitana leggera sotterranea. |
TRAM |
Metropolitana leggera fuori terra. |
TROLLEYBUS |
Tram. |
Avvertenza RouteLegTravel
Contiene le informazioni aggiuntive su cui l'utente deve essere informato durante un passaggio, come le possibili limitazioni di traffico.
Rappresentazione JSON |
---|
{ "tollInfo": { object ( |
Campi | |
---|---|
tollInfo |
Contiene informazioni sui pedaggi per l' |
speedReadingIntervals[] |
Intervalli di lettura della velocità che descrivono nel dettaglio la densità del traffico. Applicabile in caso di preferenze di routing di Esempio:
|
ValoriLegLocalizzati
Rappresentazioni di testo di determinate proprietà.
Rappresentazione JSON |
---|
{ "distance": { object ( |
Campi | |
---|---|
distance |
Distanza percorsa in forma di testo. |
duration |
Durata che tiene conto delle condizioni del traffico, sotto forma di testo. Nota: se non hai richiesto informazioni sul traffico, questo valore sarà lo stesso di staticDuration. |
staticDuration |
La durata senza tenere conto delle condizioni del traffico, rappresentata sotto forma di testo. |
Panoramica dei passaggi
Fornisce una panoramica delle informazioni relative a un elenco di RouteLegStep
.
Rappresentazione JSON |
---|
{
"multiModalSegments": [
{
object ( |
Campi | |
---|---|
multiModalSegments[] |
Riepiloga le informazioni sui diversi segmenti multimodali di |
Segmento multimodale
Fornisce un riepilogo delle informazioni sui diversi segmenti multimodali di RouteLeg.steps
. Un segmento multimodale è definito come uno o più RouteLegStep
contigui con lo stesso RouteTravelMode
. Questo campo non viene compilato se RouteLeg
non contiene segmenti multimodali nei passaggi.
Rappresentazione JSON |
---|
{ "navigationInstruction": { object ( |
Campi | |
---|---|
navigationInstruction |
Istruzioni di navigazione per il segmento multimodale. |
travelMode |
La modalità di viaggio del segmento multimodale. |
stepStartIndex |
L'indice |
stepEndIndex |
L'indice |
Area visibile
Un'area visibile di latitudine e longitudine rappresentata da due diagonali di fronte a low
e high
punti. Un'area visibile è considerata una regione chiusa, ovvero include il suo confine. I limiti di latitudine devono essere compresi tra -90 e 90 gradi inclusi e i limiti di longitudine devono essere compresi tra -180 e 180 gradi inclusi. Vari casi includono:
Se
low
=high
, l'area visibile è composta dal singolo punto.Se
low.longitude
>high.longitude
, l'intervallo di longitudine è invertito (l'area visibile attraversa la linea di longitudine a 180°).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 sia low
sia high
e la casella rappresentata non può essere vuota (come specificato dalle definizioni riportate sopra). Se viene visualizzata un'area visibile vuota, verrà restituito un errore.
Ad esempio, questa area visibile comprende interamente New York:
{ "low": { "longitudine": 40.477398, "longitudine": -74.259087 }, "alto": { "longitudine": 40.91618, "longitudine": -73.70018 } }
Rappresentazione JSON |
---|
{ "low": { object ( |
Campi | |
---|---|
low |
Obbligatorio. Il punto basso dell'area visibile. |
high |
Obbligatorio. Il punto più alto dell'area visibile. |
Valori RouteLocalized
Rappresentazioni di testo di determinate proprietà.
Rappresentazione JSON |
---|
{ "distance": { object ( |
Campi | |
---|---|
distance |
Distanza percorsa in forma di testo. |
duration |
Durata che tiene conto delle condizioni del traffico, sotto forma di testo. Nota: se non hai richiesto informazioni sul traffico, questo valore sarà lo stesso di staticDuration. |
staticDuration |
La durata senza tenere conto delle condizioni del traffico, rappresentata sotto forma di testo. |
transitFare |
Tariffa per il trasporto pubblico rappresentata sotto forma di testo. |
Risultati di geocodifica
Contiene GeocodedWaypoints
per i punti di arrivo, di destinazione e intermedi. Completato solo per i Waypoint degli indirizzi.
Rappresentazione JSON |
---|
{ "origin": { object ( |
Campi | |
---|---|
origin |
Waypoint geocodificato dell'origine. |
destination |
Waypoint geocodificato di destinazione. |
intermediates[] |
Un elenco di tappe intermedie geocodificate contenenti un campo indice che corrisponde alla posizione zero-point del punto di arrivo nell'ordine in cui sono stati specificati nella richiesta. |
Punto di accesso geocodificato
Dettagli sui luoghi utilizzati come tappe. Completato solo per i Waypoint degli indirizzi. Include i dettagli sui risultati della geocodifica allo scopo di determinare a cosa è 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 di risultati, sotto forma di zero o più tag di tipo. Tipi supportati: https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types |
partialMatch |
Indica che il geocodificatore non ha restituito una corrispondenza esatta per la richiesta originale, anche se è riuscita a trovare una corrispondenza con 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 del luogo per questo risultato. |
intermediateWaypointRequestIndex |
L'indice del waypoint intermedio corrispondente nella richiesta. Compilato solo se il Waypoint corrispondente è un Waypoint intermedio. |