Method: computeRoutes

Restituisce il percorso principale insieme a percorsi alternativi facoltativi, in base a una serie di tappe terminal e intermedi.

NOTA: questo metodo richiede l'indicazione di una maschera per il campo della risposta nell'input. Puoi fornire la maschera del campo di risposta utilizzando il parametro URL $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 (Waypoint)
  },
  "destination": {
    object (Waypoint)
  },
  "intermediates": [
    {
      object (Waypoint)
    }
  ],
  "travelMode": enum (RouteTravelMode),
  "routingPreference": enum (RoutingPreference),
  "polylineQuality": enum (PolylineQuality),
  "polylineEncoding": enum (PolylineEncoding),
  "departureTime": string,
  "arrivalTime": string,
  "computeAlternativeRoutes": boolean,
  "routeModifiers": {
    object (RouteModifiers)
  },
  "languageCode": string,
  "regionCode": string,
  "units": enum (Units),
  "optimizeWaypointOrder": boolean,
  "requestedReferenceRoutes": [
    enum (ReferenceRoute)
  ],
  "extraComputations": [
    enum (ExtraComputation)
  ],
  "trafficModel": enum (TrafficModel),
  "transitPreferences": {
    object (TransitPreferences)
  }
}
Campi
origin

object (Waypoint)

Obbligatorio. Waypoint di partenza.

destination

object (Waypoint)

Obbligatorio. Waypoint di destinazione.

intermediates[]

object (Waypoint)

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

enum (RouteTravelMode)

Campo facoltativo. Specifica la modalità di trasporto.

routingPreference

enum (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 travelMode è DRIVE o TWO_WHEELER, altrimenti la richiesta non va a buon fine.

polylineQuality

enum (PolylineQuality)

Campo facoltativo. Specifica la tua preferenza per la qualità della polilinea.

polylineEncoding

enum (PolylineEncoding)

Campo facoltativo. Specifica la codifica preferita per la polilinea.

departureTime

string (Timestamp format)

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 departureTime solo in passato quando RouteTravelMode è impostato su TRANSIT. Le corse di trasporto pubblico sono disponibili per un massimo di 7 giorni nel passato o 100 giorni nel futuro.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

arrivalTime

string (Timestamp format)

Campo facoltativo. L'ora di arrivo. NOTA: può essere impostato solo quando il criterio RouteTravelMode è impostato su TRANSIT. Puoi specificare departureTime o arrivalTime, ma non entrambi. Le corse di trasporto pubblico sono disponibili per un massimo di 7 giorni nel passato o 100 giorni nel futuro.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

computeAlternativeRoutes

boolean

Campo facoltativo. Specifica se calcolare percorsi alternativi in aggiunta al percorso. Non vengono restituite route alternative per le richieste con tappe intermedi.

routeModifiers

object (RouteModifiers)

Campo facoltativo. Un insieme di condizioni da soddisfare che influiscono sul modo in cui vengono calcolati i percorsi.

languageCode

string

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

string

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

enum (Units)

Campo facoltativo. Specifica le unità di misura per i campi di visualizzazione. Questi campi includono il campo instruction in NavigationInstruction. Le unità di misura utilizzate per percorso, tratta, distanza dei passi e durata non sono interessate da questo valore. Se non specifichi questo valore, le unità di visualizzazione vengono dedotte dalla posizione della prima origine.

optimizeWaypointOrder

boolean

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 via. Usa ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index per trovare il nuovo ordine. Se ComputeRoutesResponseroutes.optimized_intermediate_waypoint_index non viene richiesto nell'intestazione X-Goog-FieldMask, la richiesta non va a buon fine. Se optimizeWaypointOrder è impostato su false, il campo ComputeRoutesResponse.optimized_intermediate_waypoint_index sarà vuoto.

requestedReferenceRoutes[]

enum (ReferenceRoute)

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 FUEL_EFFICIENT prende in considerazione vari parametri che genererebbero un percorso ottimale a basso consumo di carburante.

extraComputations[]

enum (ExtraComputation)

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

enum (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 Route e RouteLeg, che contiene il tempo previsto nel traffico in base alle medie storiche. TrafficModel è disponibile soltanto per le richieste che hanno impostato RoutingPreference su TRAFFIC_AWARE_OPTIMAL e RouteTravelMode su DRIVE. Il valore predefinito è BEST_GUESS se viene richiesto il traffico e TrafficModel non è specificato.

transitPreferences

object (TransitPreferences)

Campo facoltativo. Specifica le preferenze che influiscono sul percorso restituito per TRANSIT route. NOTA: puoi specificare un transitPreferences solo se RouteTravelMode è impostato su TRANSIT.

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 (Route)
    }
  ],
  "fallbackInfo": {
    object (FallbackInfo)
  },
  "geocodingResults": {
    object (GeocodingResults)
  }
}
Campi
routes[]

object (Route)

Contiene un array di route calcolate (fino a tre) quando specifichi compute_alternatives_routes e contiene solo una route quando non lo specifichi. Quando questo array contiene più voci, la prima è il percorso più consigliato. Se l'array è vuoto, significa che non è stato trovato alcun percorso.

fallbackInfo

object (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

object (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 (RouteLabel)
  ],
  "legs": [
    {
      object (RouteLeg)
    }
  ],
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "description": string,
  "warnings": [
    string
  ],
  "viewport": {
    object (Viewport)
  },
  "travelAdvisory": {
    object (RouteTravelAdvisory)
  },
  "optimizedIntermediateWaypointIndex": [
    integer
  ],
  "localizedValues": {
    object (RouteLocalizedValues)
  },
  "routeToken": string
}
Campi
routeLabels[]

enum (RouteLabel)

Etichette per Route che sono utili per identificare proprietà specifiche del percorso da confrontare con altre.

legs[]

object (RouteLeg)

Un insieme di tratti (segmenti di percorso tra i tappe) che compongono il percorso. Ogni tratto corrisponde alla corsa tra due Waypoints non via. Ad esempio, un percorso senza tappe intermedie ha una sola tratta. Un percorso che include un tappa intermedia non via ha due tappe. Un percorso che include un tappa intermedia via ha una tratta. L'ordine delle tappe corrisponde all'ordine dei tappe da origin a intermediates a destination.

distanceMeters

integer

La distanza da percorrere del percorso, in metri.

duration

string (Duration format)

Il tempo necessario per percorrere il percorso. Se imposti routingPreference su TRAFFIC_UNAWARE, questo valore equivale a staticDuration. Se imposti routingPreference su TRAFFIC_AWARE o TRAFFIC_AWARE_OPTIMAL, questo valore viene calcolato tenendo conto delle condizioni del traffico.

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".

staticDuration

string (Duration format)

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 "s". Esempio: "3.5s".

polyline

object (Polyline)

La polilinea del percorso complessivo. Questa polilinea è la polilinea combinata di tutti i legs.

description

string

Una descrizione del percorso.

warnings[]

string

Un array di avvisi da mostrare quando viene visualizzato il percorso.

viewport

object (Viewport)

Il riquadro di delimitazione dell'area visibile della polilinea.

travelAdvisory

object (RouteTravelAdvisory)

Informazioni aggiuntive sul percorso.

optimizedIntermediateWaypointIndex[]

integer

Se imposti optimizeWaypointOrder su true, questo campo contiene l'ordine ottimizzato dei tappe intermedi. In caso contrario, il campo rimane vuoto. Ad esempio, se fornisci i valori Origine: LA; Tappa intermedia: Dallas, Bangor, Phoenix; Destinazione: New York; e l'ordine dei passaggi intermedi ottimizzato è Phoenix, Dallas, Bangor, questo campo contiene i valori [2, 0, 1]. L'indice inizia con 0 per il primo Waypoint intermedio fornito nell'input.

localizedValues

object (RouteLocalizedValues)

Rappresentazioni testuali delle proprietà dell'elemento Route.

routeToken

string

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: Route.route_token è disponibile solo per le richieste che hanno impostato ComputeRoutesRequest.routing_preference su TRAFFIC_AWARE o TRAFFIC_AWARE_OPTIMAL. Route.route_token non è supportato per le richieste che contengono tappe Via.

RouteLabel

Etichette per Route che sono utili per identificare proprietà specifiche del percorso da confrontare con altre.

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 computeAlternativeRoutes.
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 (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "steps": [
    {
      object (RouteLegStep)
    }
  ],
  "travelAdvisory": {
    object (RouteLegTravelAdvisory)
  },
  "localizedValues": {
    object (RouteLegLocalizedValues)
  },
  "stepsOverview": {
    object (StepsOverview)
  }
}
Campi
distanceMeters

integer

La distanza da percorrere per la tratta del percorso, in metri.

duration

string (Duration format)

Il tempo necessario per navigare nella gamba. Se route_preference è impostato su TRAFFIC_UNAWARE, questo valore equivale a staticDuration. Se route_preference è TRAFFIC_AWARE o TRAFFIC_AWARE_OPTIMAL, questo valore viene calcolato tenendo conto delle condizioni del traffico.

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".

staticDuration

string (Duration format)

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 "s". Esempio: "3.5s".

polyline

object (Polyline)

La polilinea complessiva di questa gamba che include la polilinea di ogni step.

startLocation

object (Location)

La posizione di partenza di questa tappa. Questa località potrebbe essere diversa da quella di origin fornita. Ad esempio, quando l'elemento origin fornito non è vicino a una strada, significa che è un punto della strada.

endLocation

object (Location)

La posizione finale di questa tappa. Questa località potrebbe essere diversa da quella di destination fornita. Ad esempio, quando l'elemento destination fornito non è vicino a una strada, significa che è un punto della strada.

steps[]

object (RouteLegStep)

Un array di passaggi che indicano i segmenti all'interno di questa gamba. Ogni passaggio rappresenta un'istruzione di navigazione.

travelAdvisory

object (RouteLegTravelAdvisory)

Contiene le informazioni aggiuntive di cui è necessario informare l'utente, come eventuali limitazioni delle zone di traffico, in un tratto del percorso.

localizedValues

object (RouteLegLocalizedValues)

Rappresentazioni testuali delle proprietà dell'elemento RouteLeg.

stepsOverview

object (StepsOverview)

Informazioni generali sui passaggi descritti in questo RouteLeg. Questo campo viene compilato solo per le route TRANSIT.

Polilinea

Incapsula una polilinea codificata.

Rappresentazione JSON
{

  // Union field polyline_type can be only one of the following:
  "encodedPolyline": string,
  "geoJsonLinestring": {
    object
  }
  // End of list of possible types for union field polyline_type.
}
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

string

La codifica stringa della polilinea utilizzando l'algoritmo di codifica delle polilinea.

geoJsonLinestring

object (Struct format)

Specifica una polilinea utilizzando il formato LineString GeoJSON.

RouteLegStep

Contiene un segmento di RouteLeg. Un passo corrisponde a una singola istruzione di navigazione. Le parti del percorso sono composte da gradini.

Rappresentazione JSON
{
  "distanceMeters": integer,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "navigationInstruction": {
    object (NavigationInstruction)
  },
  "travelAdvisory": {
    object (RouteLegStepTravelAdvisory)
  },
  "localizedValues": {
    object (RouteLegStepLocalizedValues)
  },
  "transitDetails": {
    object (RouteLegStepTransitDetails)
  },
  "travelMode": enum (RouteTravelMode)
}
Campi
distanceMeters

integer

La distanza da percorrere per questo passo, in metri. In alcuni casi, questo campo potrebbe non avere un valore.

staticDuration

string (Duration format)

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 "s". Esempio: "3.5s".

polyline

object (Polyline)

La polilinea associata a questo passaggio.

startLocation

object (Location)

La posizione iniziale di questo passaggio.

endLocation

object (Location)

La posizione finale di questo passaggio.

navigationInstruction

object (NavigationInstruction)

Istruzioni di navigazione.

travelAdvisory

object (RouteLegStepTravelAdvisory)

Contiene le informazioni aggiuntive di cui l'utente deve essere informato, come eventuali limitazioni delle zone di traffico, in un passaggio della tratta.

localizedValues

object (RouteLegStepLocalizedValues)

Rappresentazioni testuali delle proprietà dell'elemento RouteLegStep.

transitDetails

object (RouteLegStepTransitDetails)

Dettagli relativi a questo passaggio se la modalità di viaggio è TRANSIT.

travelMode

enum (RouteTravelMode)

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 (SpeedReadingInterval)
    }
  ]
}
Campi
speedReadingIntervals[]

object (SpeedReadingInterval)

NOTA: questo campo attualmente non viene compilato.

RouteLegStepLocalizedValues

Rappresentazioni testuali di determinate proprietà.

Rappresentazione JSON
{
  "distance": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  }
}
Campi
distance

object (LocalizedText)

Distanza da percorrere rappresentata in formato di testo.

staticDuration

object (LocalizedText)

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 (TransitStopDetails)
  },
  "localizedValues": {
    object (TransitDetailsLocalizedValues)
  },
  "headsign": string,
  "headway": string,
  "transitLine": {
    object (TransitLine)
  },
  "stopCount": integer,
  "tripShortText": string
}
Campi
stopDetails

object (TransitStopDetails)

Informazioni sulle fermate di arrivo e partenza per il passaggio.

localizedValues

object (TransitDetailsLocalizedValues)

Rappresentazioni testuali delle proprietà dell'elemento RouteLegStepTransitDetails.

headsign

string

Specifica la direzione in cui viaggiare su questa linea, indicata sul veicolo o alla fermata di partenza. La direzione è spesso il capolinea.

headway

string (Duration format)

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 "s". Esempio: "3.5s".

transitLine

object (TransitLine)

Informazioni sulla linea di trasporto pubblico utilizzata in questo passaggio.

stopCount

integer

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

string

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 tripShortText del treno Amtrak che parte da San Jose, CA alle 15:10 nei giorni feriali per Sacramento, CA.

TransitStopDetails

Dettagli sulle fermate dei mezzi di trasporto pubblico RouteLegStep.

Rappresentazione JSON
{
  "arrivalStop": {
    object (TransitStop)
  },
  "arrivalTime": string,
  "departureStop": {
    object (TransitStop)
  },
  "departureTime": string
}
Campi
arrivalStop

object (TransitStop)

Informazioni sulla fermata di arrivo per il passaggio.

arrivalTime

string (Timestamp format)

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: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

departureStop

object (TransitStop)

Informazioni sulla fermata di partenza per il passaggio.

departureTime

string (Timestamp format)

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: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

TransitStop

Informazioni su una fermata del trasporto pubblico.

Rappresentazione JSON
{
  "name": string,
  "location": {
    object (Location)
  }
}
Campi
name

string

Il nome della fermata del trasporto pubblico.

location

object (Location)

La posizione della fermata espressa in coordinate di latitudine/longitudine.

TransitDetailsLocalizedValues

Descrizioni localizzate dei valori di RouteTransitDetails.

Rappresentazione JSON
{
  "arrivalTime": {
    object (LocalizedTime)
  },
  "departureTime": {
    object (LocalizedTime)
  }
}
Campi
arrivalTime

object (LocalizedTime)

Ora nella sua rappresentazione testuale formattata con il fuso orario corrispondente.

departureTime

object (LocalizedTime)

Ora nella sua rappresentazione testuale formattata con il fuso orario corrispondente.

LocalizedTime

Descrizione localizzata dell'ora.

Rappresentazione JSON
{
  "time": {
    object (LocalizedText)
  },
  "timeZone": string
}
Campi
time

object (LocalizedText)

L'ora specificata come stringa in un determinato fuso orario.

timeZone

string

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 (TransitAgency)
    }
  ],
  "name": string,
  "uri": string,
  "color": string,
  "iconUri": string,
  "nameShort": string,
  "textColor": string,
  "vehicle": {
    object (TransitVehicle)
  }
}
Campi
agencies[]

object (TransitAgency)

L'azienda (o le aziende) che gestiscono questa linea di trasporto pubblico.

name

string

Il nome completo di questa linea di trasporto pubblico, ad esempio "8 Avenue Local".

uri

string

l'URI di questa linea di trasporto pubblico fornito dall'azienda di trasporto pubblico.

color

string

Il colore comunemente utilizzato nella segnaletica di questa linea. Rappresentato in esadecimale.

iconUri

string

L'URI dell'icona associato a questa riga.

nameShort

string

Il nome breve di questa linea di trasporto pubblico. Normalmente questo nome è un numero di riga, come "M7" o "355".

textColor

string

Il colore comunemente utilizzato nel testo sulla segnaletica di questa riga. Rappresentato in esadecimale.

vehicle

object (TransitVehicle)

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

string

Il nome dell'azienda di trasporto pubblico.

phoneNumber

string

Il numero di telefono nel formato specifico della lingua dell'azienda di trasporto pubblico.

uri

string

L'URI dell'azienda di trasporto pubblico.

TransitVehicle

Informazioni su un veicolo utilizzato nei percorsi di trasporto pubblico.

Rappresentazione JSON
{
  "name": {
    object (LocalizedText)
  },
  "type": enum (TransitVehicleType),
  "iconUri": string,
  "localIconUri": string
}
Campi
name

object (LocalizedText)

Il nome del veicolo in maiuscolo.

type

enum (TransitVehicleType)

Il tipo di veicolo utilizzato.

iconUri

string

L'URI di un'icona associata a questo tipo di veicolo.

localIconUri

string

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 (TollInfo)
  },
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}
Campi
tollInfo

object (TollInfo)

Contiene informazioni sui pedaggi in RouteLeg specifico. Questo campo viene compilato solo se è previsto il pedaggio sulla RouteLeg. Se questo campo è impostato ma il campo secondario EstimatedPrice non è compilato, prevediamo che la strada contenga pedaggi, ma non sappiamo un prezzo stimato. Se questo campo non esiste, non è previsto alcun pedaggio sulla RouteLeg.

speedReadingIntervals[]

object (SpeedReadingInterval)

Intervalli di lettura della velocità che forniscono dettagli sulla densità del traffico. Applicabile in caso di preferenze di routing TRAFFIC_AWARE e TRAFFIC_AWARE_OPTIMAL. Gli intervalli coprono l'intera polilinea di RouteLeg senza sovrapposizioni. Il punto iniziale di un intervallo specificato corrisponde al punto finale dell'intervallo precedente.

Esempio:

polyline: A ---- B ---- C ---- D ---- E ---- F ---- G
speedReadingIntervals: [A,C), [C,D), [D,G).

RouteLegLocalizedValues

Rappresentazioni testuali di determinate proprietà.

Rappresentazione JSON
{
  "distance": {
    object (LocalizedText)
  },
  "duration": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  }
}
Campi
distance

object (LocalizedText)

Distanza da percorrere rappresentata in formato di testo.

duration

object (LocalizedText)

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

object (LocalizedText)

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 (MultiModalSegment)
    }
  ]
}
Campi
multiModalSegments[]

object (MultiModalSegment)

Informazioni riassunte sui diversi segmenti multimodali di RouteLeg.steps. Questo campo non viene compilato se RouteLeg non contiene segmenti multimodali nei passaggi.

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 (NavigationInstruction)
  },
  "travelMode": enum (RouteTravelMode),
  "stepStartIndex": integer,
  "stepEndIndex": integer
}
Campi
navigationInstruction

object (NavigationInstruction)

NavigationIstruzioni per il segmento multimodale.

travelMode

enum (RouteTravelMode)

La modalità di viaggio nel segmento multimodale.

stepStartIndex

integer

L'indice RouteLegStep corrispondente che rappresenta l'inizio di un segmento multimodale.

stepEndIndex

integer

L'indice RouteLegStep corrispondente che corrisponde alla fine di un segmento multimodale.

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 e high.longitude = 180 gradi, l'area visibile include tutte le longitudini.

  • Se low.longitude = 180 gradi e high.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 (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
Campi
low

object (LatLng)

Obbligatorio. Il punto basso dell'area visibile.

high

object (LatLng)

Obbligatorio. Il punto più alto dell'area visibile.

RouteLocalizedValues

Rappresentazioni testuali di determinate proprietà.

Rappresentazione JSON
{
  "distance": {
    object (LocalizedText)
  },
  "duration": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  },
  "transitFare": {
    object (LocalizedText)
  }
}
Campi
distance

object (LocalizedText)

Distanza da percorrere rappresentata in formato di testo.

duration

object (LocalizedText)

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.

staticDuration

object (LocalizedText)

Durata senza prendere in considerazione le condizioni del traffico, espressa in formato testo.

transitFare

object (LocalizedText)

Tariffa di trasporto pubblico rappresentata in formato testo.

GeocodingResults

Contiene GeocodedWaypoints per i punti di partenza, di arrivo e intermedi. Compilato solo per i Waypoint dell'indirizzo.

Rappresentazione JSON
{
  "origin": {
    object (GeocodedWaypoint)
  },
  "destination": {
    object (GeocodedWaypoint)
  },
  "intermediates": [
    {
      object (GeocodedWaypoint)
    }
  ]
}
Campi
origin

object (GeocodedWaypoint)

Waypoint geocodificato dell'origine.

destination

object (GeocodedWaypoint)

Waypoint geocodificato della destinazione.

intermediates[]

object (GeocodedWaypoint)

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 (Status)
  },
  "type": [
    string
  ],
  "partialMatch": boolean,
  "placeId": string,
  "intermediateWaypointRequestIndex": integer
}
Campi
geocoderStatus

object (Status)

Indica il codice di stato risultante dall'operazione di geocodifica.

type[]

string

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

boolean

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

string

L'ID luogo per questo risultato.

intermediateWaypointRequestIndex

integer

L'indice del Waypoint intermedio corrispondente nella richiesta. Viene compilata solo se il tappa corrispondente è un tappa intermedia.