- Richiesta HTTP
- Corpo della richiesta
- Corpo della risposta
- PolylineQuality
- PolylineEncoding
- ReferenceRoute
- ExtraComputation
- Route
- 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, definiti con una serie di tappe finali e intermedi.
NOTA:questo metodo richiede di specificare una maschera del campo di risposta nell'input. Puoi fornire la maschera del campo della risposta utilizzando il parametro URL $fields
o fields
oppure utilizzando un'intestazione HTTP/gRPC X-Goog-FieldMask
(consulta i parametri URL e le intestazioni 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 di tutti i campi disponibili (per l'ispezione manuale):
X-Goog-FieldMask: *
- Maschera per il campo di durata, distanza e polilinea a livello di percorso (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 (*
) o di specificare la maschera per il campo al livello più alto (routes
) per i seguenti motivi:
- La selezione solo dei campi necessari aiuta il nostro server a salvare i cicli di calcolo, consentendoci di restituirti il risultato con una latenza inferiore.
- La selezione solo dei campi che ti servono nel tuo job di produzione garantisce prestazioni di latenza stabili. In futuro potremmo aggiungere altri campi di risposta e questi nuovi campi potrebbero richiedere più tempo di calcolo. Se selezioni tutti i campi o tutti i campi al livello superiore, potresti riscontrare un peggioramento delle prestazioni perché qualsiasi nuovo campo che aggiungiamo verrà incluso automaticamente nella risposta.
- La selezione dei soli 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 |
Obbligatoria. Waypoint di partenza. |
destination |
Obbligatoria. Waypoint di destinazione. |
intermediates[] |
Campo facoltativo. Un insieme di tappe lungo il percorso (esclusi i punti terminali) per fermarsi o passare. Sono supportati fino a 25 waypoint 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 extra 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'ora di partenza. Se non imposti questo valore, per impostazione predefinita viene utilizzato il momento in cui hai effettuato la richiesta. NOTA: puoi specificare un Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
arrivalTime |
Campo facoltativo. L'ora di arrivo. NOTA: può essere impostato solo quando Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
computeAlternativeRoutes |
Campo facoltativo. Specifica se calcolare i percorsi alternativi in aggiunta al percorso. Non vengono restituite route alternative per le richieste con waypoint intermedi. |
routeModifiers |
Campo facoltativo. Un insieme di condizioni da soddisfare che influiscono sul modo in cui vengono calcolate le route. |
languageCode |
Campo facoltativo. Il codice lingua BCP-47, ad esempio "en-US" o "sr-Latn". Per ulteriori informazioni, consulta la sezione Identificatore internazionale Unicode. Consulta l'elenco delle lingue supportate nella pagina Supporto delle lingue. 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 a due caratteri ccTLD ("dominio di primo livello"). Per ulteriori informazioni, vedi 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 il criterio viene impostato su true, il servizio tenta di ridurre al minimo il costo complessivo del percorso riordinando i waypoint intermedi specificati. La richiesta non va a buon fine se uno dei waypoint 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 uno scopo di calcolo diverso rispetto al percorso predefinito. Ad esempio, il calcolo di un percorso di riferimento |
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 per poter essere 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 Durata in |
transitPreferences |
Campo facoltativo. Specifica le preferenze che influenzano il percorso restituito per le route |
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 della route 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, il campo non viene configurato. |
geocodingResults |
Contiene informazioni di risposta di geocodifica per i waypoint specificati come indirizzi. |
PolylineQuality
Un insieme di valori che specifica 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 utilizzando più punti di OVERVIEW , al costo di un aumento della dimensione della risposta. Utilizza questo valore quando 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 di richiesta inferiore rispetto all'uso dell'opzione HIGH_QUALITY . |
PolylineEncoding
Specifica il tipo preferito di polilinea da restituire.
Enum | |
---|---|
POLYLINE_ENCODING_UNSPECIFIED |
Nessuna preferenza del 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 |
ReferenceRoute
Una route di riferimento supportata in ComputeRoutesRequest.
Enum | |
---|---|
REFERENCE_ROUTE_UNSPECIFIED |
Non utilizzato. Le richieste contenenti questo valore non riescono. |
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 a scopo di visualizzazione. Non analizzarlo in modo programmatico. |
Route
Contiene un percorso, costituito da una serie di tratti di strada collegati che congiungono i punti di partenza, di arrivo e intermedi.
Rappresentazione JSON |
---|
{ "routeLabels": [ enum ( |
Campi | |
---|---|
routeLabels[] |
Etichette per |
legs[] |
Un insieme di tappe (segmenti di percorso tra tappe) che compongono il percorso. Ogni tratto corrisponde alla corsa tra due |
distanceMeters |
La distanza percorsa lungo il 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 viaggio lungo il 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 complessiva del percorso. Questa polilinea è la polilinea combinata di |
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à di |
routeToken |
Un token di route sicuro per il web e con codifica Base64 che può essere trasmesso all'SDK di navigazione, che consente a quest'ultimo di ricostruire il percorso durante la navigazione e, in caso di ricalcolo, rispetta l'intenzione originale quando l'hai creata chiamando v2.computeRoutes. I clienti dovrebbero considerare questo token come un blob opaco. Non è destinata alla lettura o a mutazioni. NOTA: |
RouteLabel
Etichette per
che sono utili per identificare le proprietà specifiche del percorso da confrontare con altre.Route
Enum | |
---|---|
ROUTE_LABEL_UNSPECIFIED |
Valore predefinito: non utilizzato. |
DEFAULT_ROUTE |
La route "migliore" predefinita restituita per il calcolo delle route. |
DEFAULT_ROUTE_ALTERNATE |
Un'alternativa al percorso predefinito "migliore". Route come questa verranno restituite quando viene specificato . |
FUEL_EFFICIENT |
Percorso a basso consumo di carburante. I percorsi etichettati con questo valore vengono determinati in modo da essere ottimizzati in base a parametri Eco come il consumo di carburante. |
RouteLeg
Contiene un segmento compreso tra waypoint diversi da via
.
Rappresentazione JSON |
---|
{ "distanceMeters": integer, "duration": string, "staticDuration": string, "polyline": { object ( |
Campi | |
---|---|
distanceMeters |
La distanza percorsa del tratto del percorso, in metri. |
duration |
Il tempo necessario per navigare la gamba. Se Una durata in secondi con un massimo di nove cifre frazionarie, che termina con " |
staticDuration |
La durata del percorso per il tratto, 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 dal |
endLocation |
La posizione finale di questa gamba. Questa località potrebbe essere diversa dal |
steps[] |
Un array di passaggi che indicano i segmenti all'interno di questo tratto. Ogni passaggio rappresenta un'istruzione di navigazione. |
travelAdvisory |
Contiene le informazioni aggiuntive di cui l'utente deve essere informato, come possibili limitazioni per le zone di traffico in un tratto di percorso. |
localizedValues |
Rappresentazioni testuali delle proprietà di |
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 GeoJSON LineString. |
RouteLegStep
Contiene un segmento di
. Un passaggio corrisponde a una singola istruzione di navigazione. Le tappe 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 conto delle 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à 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 esempio svolta a sinistra, unire 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 inversione a U a sinistra. |
TURN_LEFT |
Gira a sinistra. |
TURN_SLIGHT_RIGHT |
Gira leggermente verso destra. |
TURN_SHARP_RIGHT |
Gira tutto a destra. |
UTURN_RIGHT |
Fai una inversione a U a destra. |
TURN_RIGHT |
Gira a destra. |
STRAIGHT |
Vai dritto. |
RAMP_LEFT |
Prendi la rampa a sinistra. |
RAMP_RIGHT |
Prendi la rampa a destra. |
MERGE |
Confluisci nel traffico. |
FORK_LEFT |
Prendi il bivio a sinistra. |
FORK_RIGHT |
Prendi il bivio a destra. |
FERRY |
Prendi il traghetto. |
FERRY_TRAIN |
Prendi il treno che conduce 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 di una via. |
RouteLegStepTravelAdvisory
Contiene le informazioni aggiuntive di cui è necessario informare l'utente, come possibili limitazioni delle zone di traffico in un passaggio di un tratto.
Rappresentazione JSON |
---|
{
"speedReadingIntervals": [
{
object ( |
Campi | |
---|---|
speedReadingIntervals[] |
NOTA: questo campo al momento non viene compilato. |
RouteLegStepLocalizedValues
Rappresentazioni testuali di determinate proprietà.
Rappresentazione JSON |
---|
{ "distance": { object ( |
Campi | |
---|---|
distance |
Distanza di viaggio rappresentata in formato di testo. |
staticDuration |
Durata senza considerare le condizioni del traffico, rappresentata 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à di |
headsign |
Specifica la direzione in cui viaggiare su questa linea, indicata sul veicolo o alla fermata di partenza. Spesso la direzione corrisponde al 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 il rilevamento, ti aspetteresti 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 fermata di partenza alla fermata di arrivo. Questo conteggio include la fermata di arrivo, ma esclude 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 indicare una corsa in 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 del passaggio. Un timestamp in formato "Zulu" RFC3339 UTC, 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 stimata per il passaggio. Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
TransitStop
Informazioni su una fermata di trasporto pubblico.
Rappresentazione JSON |
---|
{
"name": string,
"location": {
object ( |
Campi | |
---|---|
name |
Il nome della fermata di trasporto pubblico. |
location |
La posizione della fermata espressa in coordinate di latitudine/longitudine. |
TransitDetailsLocalizedValues
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. |
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) di trasporto pubblico che gestisce questa linea di trasporto pubblico. |
name |
Il nome completo della 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 per 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 si tratta di 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 |
Numero di telefono formattato specifico per le impostazioni internazionali dell'azienda di trasporto pubblico. |
uri |
L'URI dell'azienda di trasporto pubblico. |
TransitVehicle
Informazioni su un veicolo utilizzato per i 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 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, di solito a terra. Le funivie aeree possono essere del tipo GONDOLA_LIFT . |
COMMUTER_TRAIN |
Treno per pendolari. |
FERRY |
Traghetto. |
FUNICULAR |
Un veicolo trainato da un cavo su una ripida pendenza. In genere una funicolare è composta da due auto, ciascuna delle quali agisce come 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 |
Treno. |
SHARE_TAXI |
Il taxi condiviso è un tipo di autobus che consente di scendere e far salire i passeggeri ovunque lungo il 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 su un passaggio della tratta, come possibili limitazioni delle zone di traffico.
Rappresentazione JSON |
---|
{ "tollInfo": { object ( |
Campi | |
---|---|
tollInfo |
Contiene informazioni sui pedaggi relativi a |
speedReadingIntervals[] |
Intervalli di lettura della velocità con 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 di viaggio 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 considerare le condizioni del traffico, rappresentata in formato testo. |
StepsOverview
Fornisce una panoramica 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 |
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 con latitudine e longitudine, rappresentata da due punti diagonali opposti di low
e high
. Un'area visibile è considerata una regione chiusa, ovvero include i confini. 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 si sovrappone alla 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 racchiude completamente New York City:
{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }
Rappresentazione JSON |
---|
{ "low": { object ( |
Campi | |
---|---|
low |
Obbligatoria. Il punto basso dell'area visibile. |
high |
Obbligatoria. Il punto più alto dell'area visibile. |
RouteLocalizedValues
Rappresentazioni testuali di determinate proprietà.
Rappresentazione JSON |
---|
{ "distance": { object ( |
Campi | |
---|---|
distance |
Distanza di viaggio 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 considerare le condizioni del traffico, rappresentata in formato testo. |
transitFare |
Tariffa del trasporto pubblico rappresentata in formato testo. |
GeocodingResults
Contiene
per i punti di partenza, di destinazione e intermedi. Compilato solo per i waypoint dell'indirizzo.GeocodedWaypoints
Rappresentazione JSON |
---|
{ "origin": { object ( |
Campi | |
---|---|
origin |
Waypoint geocodificato di origine. |
destination |
Waypoint geocodificato di destinazione. |
intermediates[] |
Un elenco di waypoint intermedi 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 sui luoghi utilizzati come waypoint. Compilato solo per i waypoint dell'indirizzo. Include dettagli sui risultati di geocodifica al fine 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[] |
I tipi del risultato sotto forma di zero o più tag di tipo. Tipi supportati: tipi di indirizzi e tipi di componenti degli indirizzi. |
partialMatch |
Indica che il geocodificatore non ha restituito una corrispondenza esatta per la richiesta originale, nonostante sia riuscita a far corrispondere 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. Compilato solo se il waypoint corrispondente è un waypoint intermedio. |