Method: computeRoutes

Restituisce il percorso principale insieme a itinerari alternativi facoltativi, dato un insieme di waypoint terminali e intermedi.

NOTA: questo metodo richiede di specificare una maschera di campo della risposta nell'input. Puoi fornire la maschera di campo della risposta utilizzando il parametro URL $fields o fields oppure 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 campo di tutti i campi disponibili (per l'ispezione manuale): X-Goog-FieldMask: *
  • Maschera di campo della durata, della distanza e della polilinea a livello di percorso (un esempio di configurazione di produzione): X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline

Google sconsiglia l'utilizzo della maschera del campo di risposta con carattere jolly (*) o la specifica della maschera del campo al livello più alto (routes), perché:

  • Selezionando solo i campi necessari, il nostro server risparmia cicli di calcolo, consentendoci di restituirti il risultato con una latenza inferiore.
  • Selezionando solo i campi necessari nel job di produzione, garantisci prestazioni di latenza stabili. In futuro potremmo aggiungere altri campi di risposta, che potrebbero richiedere un tempo di calcolo aggiuntivo. Se selezioni tutti i campi o tutti i campi di primo livello, potresti riscontrare un peggioramento delle prestazioni, perché ogni nuovo campo che aggiungiamo verrà incluso automaticamente nella risposta.
  • Selezionando solo i campi necessari, le dimensioni della risposta sono inferiori e, di conseguenza, il throughput di rete è maggiore.

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 origine.

destination

object (Waypoint)

Obbligatorio. Waypoint di destinazione.

intermediates[]

object (Waypoint)

Facoltativo. Un insieme di tappe lungo il percorso (esclusi i punti di arrivo), per fermarsi o passare. Sono supportate fino a 25 tappe intermedie.

travelMode

enum (RouteTravelMode)

Facoltativo. Specifica il mezzo di trasporto.

routingPreference

enum (RoutingPreference)

Facoltativo. Specifica come calcolare il percorso. Il server tenta di utilizzare la preferenza di calcolo del percorso selezionata per calcolare il percorso. Se la preferenza di routing genera un errore o una latenza molto lunga, viene restituito un errore. Puoi specificare questa opzione solo se travelMode è DRIVE o TWO_WHEELER, altrimenti la richiesta non va a buon fine.

polylineQuality

enum (PolylineQuality)

Facoltativo. Specifica la tua preferenza per la qualità della polilinea.

polylineEncoding

enum (PolylineEncoding)

Facoltativo. Specifica la codifica preferita per la polilinea.

departureTime

string (Timestamp format)

Facoltativo. L'ora di partenza. Se non imposti questo valore, il valore predefinito corrisponde all'ora in cui hai effettuato la richiesta. NOTA: puoi specificare un departureTime nel passato solo quando RouteTravelMode è impostato su TRANSIT. I percorsi con il trasporto pubblico sono disponibili per un massimo di 7 giorni nel passato o 100 giorni nel futuro.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

arrivalTime

string (Timestamp format)

Facoltativo. L'ora di arrivo. NOTA: questo campo viene ignorato quando le richieste specificano un RouteTravelMode diverso da TRANSIT. Puoi specificare departureTime o arrivalTime, ma non entrambi. I percorsi con il trasporto pubblico sono disponibili per un massimo di 7 giorni nel passato o 100 giorni nel futuro.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

computeAlternativeRoutes

boolean

Facoltativo. Specifica se calcolare itinerari alternativi oltre al percorso. Non vengono restituiti percorsi alternativi per le richieste con tappe intermedie.

routeModifiers

object (RouteModifiers)

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

languageCode

string

Facoltativo. Il codice lingua BCP-47, ad esempio "en-US" o "sr-Latn". Per saperne di più, consulta Identificatore di impostazioni internazionali Unicode. Consulta la sezione Supporto delle lingue per l'elenco delle lingue supportate. Se non fornisci questo valore, la lingua di visualizzazione viene dedotta dalla località della richiesta di percorso.

regionCode

string

Facoltativo. Il codice regione, specificato come valore di due caratteri ccTLD ("dominio di primo livello"). Per saperne di più, consulta Domini di primo livello nazionali.

units

enum (Units)

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 la distanza e la durata del percorso, della tappa e del passaggio non sono interessate da questo valore. Se non fornisci questo valore, le unità di visualizzazione vengono dedotte dalla posizione della prima origine.

optimizeWaypointOrder

boolean

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

requestedReferenceRoutes[]

enum (ReferenceRoute)

Facoltativo. Specifica i percorsi di riferimento da calcolare nell'ambito della richiesta, oltre al percorso predefinito. Un percorso di riferimento è un percorso con un obiettivo di calcolo diverso rispetto al percorso predefinito. Ad esempio, il calcolo di un percorso di riferimento FUEL_EFFICIENT tiene conto di vari parametri che generano un percorso ottimale a basso consumo di carburante. Quando utilizzi questa funzionalità, cerca routeLabels nei percorsi risultanti.

extraComputations[]

enum (ExtraComputation)

Facoltativo. Un elenco di calcoli aggiuntivi che possono essere utilizzati per completare la richiesta. Nota: questi calcoli aggiuntivi potrebbero restituire campi aggiuntivi nella risposta. Anche questi campi aggiuntivi devono essere specificati nella maschera di campo per essere restituiti nella risposta.

trafficModel

enum (TrafficModel)

Facoltativo. Specifica le ipotesi da utilizzare per il calcolo del tempo nel traffico. Questa impostazione influisce sul valore restituito nel campo duration in Route e RouteLeg, che contiene il tempo previsto nel traffico in base alle medie storiche. TrafficModel è disponibile solo 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)

Facoltativo. Specifica le preferenze che influiscono sul percorso restituito per i percorsi TRANSIT. NOTA: puoi specificare un transitPreferences solo quando 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 percorsi calcolati (fino a tre) quando specifichi compute_alternatives_routes e contiene un solo percorso quando non lo specifichi. Quando questo array contiene più voci, la prima è il percorso più consigliato. Se l'array è vuoto, significa che non è stato possibile trovare alcun percorso.

fallbackInfo

object (FallbackInfo)

In alcuni casi, se il server non è in grado di calcolare i risultati del percorso con tutte le preferenze di input, potrebbe ricorrere a un metodo di calcolo diverso. Quando viene utilizzata la modalità di riserva, questo campo contiene informazioni dettagliate sulla risposta di riserva. In caso contrario, questo campo non è impostato.

geocodingResults

object (GeocodingResults)

Contiene informazioni sulla risposta di geocodifica per i waypoint 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, a scapito di una dimensione della risposta maggiore. Utilizza questo valore quando hai bisogno di maggiore precisione.
OVERVIEW Specifica una polilinea di panoramica, composta da un numero ridotto di punti. Utilizza questo valore quando mostri una panoramica del percorso. L'utilizzo di questa opzione comporta una latenza delle richieste inferiore rispetto all'utilizzo dell'opzione HIGH_QUALITY.

PolylineEncoding

Specifica il tipo preferito di polilinea da restituire.

Enum
POLYLINE_ENCODING_UNSPECIFIED Nessuna preferenza specificata per il tipo di polilinea. Il valore predefinito è ENCODED_POLYLINE.
ENCODED_POLYLINE Specifica una polilinea codificata utilizzando l'algoritmo di codifica delle polilinee.
GEO_JSON_LINESTRING Specifica una polilinea utilizzando il formato GeoJSON LineString

ReferenceRoute

Un percorso di riferimento supportato in 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.
SHORTER_DISTANCE

Percorso con distanza di viaggio più breve. Questa è una funzione sperimentale.

Per le richieste DRIVE, questa funzionalità dà la priorità alla distanza più breve rispetto al comfort di guida. Ad esempio, potrebbe preferire strade locali anziché autostrade, percorrere strade sterrate, attraversare parcheggi e così via. Questa funzionalità non restituisce manovre che Google Maps sa essere illegali.

Per le richieste BICYCLE e TWO_WHEELER, questa funzionalità restituisce percorsi simili a quelli restituiti quando non specifichi requestedReferenceRoutes.

Questa funzionalità non è compatibile con altre modalità di viaggio, tramite waypoint intermedi o optimizeWaypointOrder; queste richieste non andranno a buon fine. Tuttavia, puoi utilizzarlo con qualsiasi routingPreference.

ExtraComputation

Calcoli aggiuntivi da eseguire durante il completamento della richiesta. In futuro potrebbero essere aggiunti altri valori.

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 di carburante stimato per i percorsi.
TRAFFIC_ON_POLYLINE Polilinee sensibili al traffico per i percorsi.
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS NavigationInstruction presentato come stringa di testo HTML formattata. Questi contenuti devono essere letti così come sono e sono solo a scopo di visualizzazione. Non analizzarlo in modo programmatico.
FLYOVER_INFO_ON_POLYLINE Informazioni sul cavalcavia per i percorsi. Per restituire queste informazioni, è necessario specificare la maschera di campo routes.polyline_details.flyover_info. Al momento, questi dati verranno compilati solo per alcune aree metropolitane in India. Questa funzionalità è sperimentale e lo SKU/l'addebito sono soggetti a modifiche.
NARROW_ROAD_INFO_ON_POLYLINE Informazioni sulla strada stretta per i percorsi. Per restituire queste informazioni, è necessario specificare la maschera di campo routes.polyline_details.narrow_road_info. Al momento, questi dati verranno compilati solo per alcune aree metropolitane in India. Questa funzionalità è sperimentale e lo SKU/l'addebito sono soggetti a modifiche.
TUNNEL_INFO_ON_POLYLINE Informazioni sulle gallerie per i percorsi. Per restituire queste informazioni, è necessario specificare la maschera di campo routes.polyline_details.tunnel_info.
BRIDGE_INFO_ON_POLYLINE Informazioni sui ponti per i percorsi. Per restituire queste informazioni, è necessario specificare la maschera di campo routes.polyline_details.bridge_info.
SKYWAY_INFO_ON_POLYLINE Informazioni sui percorsi sopraelevati. Per restituire queste informazioni, è necessario specificare la maschera di campo routes.polyline_details.skyway_info.

Inoltra

Contiene un percorso, che consiste in una serie di segmenti stradali collegati che uniscono i waypoint 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,
  "polylineDetails": {
    object (PolylineDetails)
  }
}
Campi
routeLabels[]

enum (RouteLabel)

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

legs[]

object (RouteLeg)

Una raccolta di tappe (segmenti di percorso tra i waypoint) che compongono il percorso. Ogni tratta corrisponde al viaggio tra due Waypoints non via. Ad esempio, un percorso senza tappe intermedie ha una sola tratta. Un percorso che include un waypoint intermedio non via ha due tappe. Un percorso che include un waypoint intermedio via ha una sola tappa. L'ordine delle tappe corrisponde all'ordine dei waypoint da origin a intermediates e a destination.

distanceMeters

integer

La distanza di percorrenza del percorso, in metri.

duration

string (Duration format)

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

Quando routingPreference è impostato su TRAFFIC_AWARE_OPTIMAL, la durata viene calcolata utilizzando le velocità dei veicoli passeggeri o dei camion (durate più lunghe). Le velocità dei camion vengono utilizzate se si verifica una delle seguenti condizioni:

In tutti gli altri casi, vengono utilizzate le velocità dei veicoli passeggeri, anche se in vehicleInfo sono specificate altre dimensioni o pesi dei veicoli.

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 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 "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 durante la visualizzazione del 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 waypoint intermedi. In caso contrario, questo campo è vuoto. Ad esempio, se fornisci un input di Origine: LA; tappe intermedie: Dallas, Bangor, Phoenix; Destinazione: New York; e l'ordine delle tappe intermedie 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à di Route.

routeToken

string

Un token opaco che può essere passato all'SDK di navigazione per ricostruire il percorso durante la navigazione e, in caso di cambio percorso, rispettare l'intenzione originale al momento della creazione del percorso. Tratta questo token come un blob opaco. Non confrontare il suo valore tra le richieste, poiché potrebbe cambiare anche se il servizio restituisce lo stesso percorso.

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 con waypoint di passaggio.

polylineDetails

object (PolylineDetails)

Contiene informazioni sui dettagli lungo la polilinea.

RouteLabel

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

Enum
ROUTE_LABEL_UNSPECIFIED Predefinito: non utilizzato.
DEFAULT_ROUTE Il percorso "migliore" predefinito restituito per il calcolo del percorso.
DEFAULT_ROUTE_ALTERNATE Un'alternativa al percorso "migliore" predefinito. I percorsi come questo verranno restituiti quando viene specificato computeAlternativeRoutes.
FUEL_EFFICIENT Percorso a basso consumo di carburante. I percorsi etichettati con questo valore sono considerati ottimizzati per i parametri ecologici, come il consumo di carburante.
SHORTER_DISTANCE Percorso con distanza di viaggio più breve. Questa è una funzione sperimentale.

RouteLeg

Contiene un segmento tra waypoint 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 di percorrenza della tappa del percorso, in metri.

duration

string (Duration format)

Il tempo necessario per percorrere la tappa. Se routingPreference è impostato su TRAFFIC_UNAWARE, questo valore corrisponde a staticDuration. Se routingPreference è TRAFFIC_AWARE o TRAFFIC_AWARE_OPTIMAL, questo valore viene calcolato tenendo conto delle condizioni del traffico.

Quando routingPreference è impostato su TRAFFIC_AWARE_OPTIMAL, la durata viene calcolata utilizzando le velocità dei veicoli passeggeri o dei camion (durate più lunghe). Le velocità dei camion vengono utilizzate se si verifica una delle seguenti condizioni:

In tutti gli altri casi, vengono utilizzate le velocità dei veicoli passeggeri, anche se in vehicleInfo sono specificate altre dimensioni o pesi dei veicoli.

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 viaggio lungo la tappa, 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 tratta, che include la polilinea di ogni step.

startLocation

object (Location)

La località di partenza di questa tappa. Questa località potrebbe essere diversa da quella fornita (origin). Ad esempio, se il valore origin fornito non è vicino a una strada, questo è un punto sulla strada.

endLocation

object (Location)

La località di arrivo di questa tappa. Questa località potrebbe essere diversa da quella fornita (destination). Ad esempio, se il valore destination fornito non è vicino a una strada, questo è un punto sulla strada.

steps[]

object (RouteLegStep)

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

travelAdvisory

object (RouteLegTravelAdvisory)

Contiene le informazioni aggiuntive di cui l'utente deve essere informato, ad esempio possibili limitazioni della zona di traffico, su un tratto del percorso.

localizedValues

object (RouteLegLocalizedValues)

Rappresentazioni testuali delle proprietà di RouteLeg.

stepsOverview

object (StepsOverview)

Informazioni generali sui passaggi di questo RouteLeg. Questo campo viene compilato solo per i percorsi con routing transitivo.

Polilinea

Incapsula una polilinea codificata.

Rappresentazione JSON
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "encodedPolyline": string,
  "geoJsonLinestring": {
    object
  }
  // End of mutually exclusive fields.
}
Campi
Incapsula il tipo di polilinea. Il valore predefinito è encoded_polyline. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
encodedPolyline

string

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

geoJsonLinestring

object (Struct format)

Specifica una polilinea utilizzando il formato GeoJSON LineString.

Fine dei campi che si escludono a vicenda.

RouteLegStep

Contiene un segmento di un RouteLeg. Un passaggio corrisponde a una singola istruzione di navigazione. Le tappe del percorso sono costituite da passaggi.

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 di percorrenza di questo passaggio, in metri. In alcune circostanze, questo campo potrebbe non avere un valore.

staticDuration

string (Duration format)

La durata del viaggio attraverso questo passaggio senza tenere conto delle condizioni del traffico. In alcune circostanze, 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 di partenza di questo passaggio.

endLocation

object (Location)

La località di arrivo di questo passaggio.

navigationInstruction

object (NavigationInstruction)

Istruzioni di navigazione.

travelAdvisory

object (RouteLegStepTravelAdvisory)

Contiene le informazioni aggiuntive di cui l'utente deve essere informato, ad esempio possibili limitazioni della zona di traffico, in un passaggio della tappa.

localizedValues

object (RouteLegStepLocalizedValues)

Rappresentazioni testuali delle proprietà di 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 specificano l'azione di navigazione da intraprendere per il passaggio corrente (ad esempio, svolta a sinistra, unione o dritto).

Enum
MANEUVER_UNSPECIFIED Non utilizzato.
TURN_SLIGHT_LEFT Girati leggermente verso sinistra.
TURN_SHARP_LEFT Svolta bruscamente a sinistra.
UTURN_LEFT Fai un'inversione a U a sinistra.
TURN_LEFT Gira a sinistra.
TURN_SLIGHT_RIGHT Girati leggermente verso destra.
TURN_SHARP_RIGHT Svolta tutto a destra.
UTURN_RIGHT Fai un'inversione a U a destra.
TURN_RIGHT Gira a destra.
STRAIGHT Vai dritto.
RAMP_LEFT Prendi lo svincolo a sinistra.
RAMP_RIGHT Prendi lo svincolo a destra.
MERGE Immettiti 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 porta al traghetto.
ROUNDABOUT_LEFT Alla rotatoria, gira a sinistra.
ROUNDABOUT_RIGHT Alla rotatoria, gira a destra.
DEPART Manovra iniziale.
NAME_CHANGE Utilizzato per indicare un cambio di nome della via.
DESTINATION Utilizzato per indicare l'arrivo a una destinazione.

RouteLegStepTravelAdvisory

Contiene le informazioni aggiuntive di cui l'utente deve essere informato, ad esempio possibili limitazioni della zona di traffico in un passaggio della tappa.

Rappresentazione JSON
{
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}
Campi
speedReadingIntervals[]

object (SpeedReadingInterval)

NOTA: questo campo non è attualmente compilato.

RouteLegStepLocalizedValues

Rappresentazioni testuali di determinate proprietà.

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

object (LocalizedText)

Distanza di viaggio rappresentata in formato di testo.

staticDuration

object (LocalizedText)

Durata senza tenere conto delle condizioni del traffico, rappresentata in formato di 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à di RouteLegStepTransitDetails.

headsign

string

Specifica la direzione di viaggio su questa linea, come indicato sul veicolo o alla fermata di partenza. La direzione è spesso la stazione capolinea.

headway

string (Duration format)

Specifica l'orario previsto come durata tra le partenze dalla stessa fermata in questo momento. Ad esempio, con un valore di headway_seconds pari a 600, se perdi l'autobus dovrai aspettare dieci minuti.

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 fermata di partenza a quella di arrivo. Questo conteggio include la fermata di arrivo, ma esclude quella 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 restituisce 3.

tripShortText

string

Il testo che appare negli orari e sui cartelli per identificare una corsa di trasporto pubblico per i passeggeri. Il testo deve identificare in modo univoco una corsa all'interno di un giorno di servizio. Ad esempio, "538" è il tripShortText del treno Amtrak che parte da San Jose, CA alle 15:10 nei giorni feriali per Sacramento, CA.

TransitStopDetails

Dettagli sulle fermate dei trasporti pubblici per RouteLegStep.

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

object (TransitStop)

Informazioni sulla fermata di arrivo del passaggio.

arrivalTime

string (Timestamp format)

L'orario di arrivo stimato per il passaggio.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

departureStop

object (TransitStop)

Informazioni sulla fermata di partenza del passaggio.

departureTime

string (Timestamp format)

L'orario di partenza stimato per il passaggio.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

TransitStop

Informazioni su una fermata dei mezzi pubblici.

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

string

Il nome della fermata di trasporto pubblico.

location

object (Location)

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

TransitDetailsLocalizedValues

Descrizioni localizzate dei valori per RouteTransitDetails.

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

object (LocalizedTime)

Ora nella rappresentazione testuale formattata con un fuso orario corrispondente.

departureTime

object (LocalizedTime)

Ora nella rappresentazione testuale formattata con un 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 di trasporto pubblico (o le aziende) che gestisce 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, come fornito dall'azienda di trasporto pubblico.

color

string

Il colore di uso comune nella segnaletica per questa linea. Rappresentato in formato esadecimale.

iconUri

string

L'URI dell'icona associata a questa linea.

nameShort

string

Il nome breve di questa linea di trasporto pubblico. In genere, questo nome è un numero di linea, ad esempio "M7" o "355".

textColor

string

Il colore di uso comune nel testo della segnaletica per questa linea. Rappresentato in formato 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 di questa azienda di trasporto pubblico.

phoneNumber

string

Il numero di telefono dell'azienda di trasporto pubblico in formato internazionale.

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 di questo veicolo, con l'iniziale maiuscola.

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 associata a questo tipo di veicolo, in base alla segnaletica dei trasporti locali.

TransitVehicleType

Il tipo di veicoli per i percorsi con il trasporto pubblico.

Enum
TRANSIT_VEHICLE_TYPE_UNSPECIFIED Non utilizzato.
BUS Bus.
CABLE_CAR Un veicolo che funziona su un cavo, di solito a terra. Le funivie possono essere del tipo GONDOLA_LIFT.
COMMUTER_TRAIN Treno pendolare.
FERRY Traghetto.
FUNICULAR Un veicolo che viene trainato su un pendio ripido da un cavo. Una funicolare è in genere costituita da due carrozze, ognuna 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 Treno.
SHARE_TAXI Il taxi condiviso è un tipo di autobus con la possibilità di far scendere e salire i passeggeri in qualsiasi punto del percorso.
SUBWAY Metropolitana leggera sotterranea.
TRAM Metropolitana leggera in superficie.
TROLLEYBUS Filobus.

RouteLegTravelAdvisory

Contiene le informazioni aggiuntive di cui l'utente deve essere informato in un passaggio della tappa, ad esempio possibili limitazioni della zona di traffico.

Rappresentazione JSON
{
  "tollInfo": {
    object (TollInfo)
  },
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}
Campi
tollInfo

object (TollInfo)

Contiene informazioni sui pedaggi per il RouteLeg specifico. Questo campo viene compilato solo se prevediamo che siano presenti pedaggi su RouteLeg e TOLLS è incluso in ComputeRoutesRequest.extra_computations della richiesta. Se questo campo è impostato, ma il sottocampo estimatedPrice non è compilato, ci aspettiamo che la strada contenga pedaggi, ma non conosciamo un prezzo stimato. Se tollInfo non esiste, non è previsto alcun pedaggio per RouteLeg.

speedReadingIntervals[]

object (SpeedReadingInterval)

Intervalli di lettura della velocità che indicano la densità del traffico. Questo campo viene compilato solo per le richieste quando la richiesta ha un valore TRAFFIC_AWARE o TRAFFIC_AWARE_OPTIMAL ComputeRoutesRequest.routing_preference e TRAFFIC_ON_POLYLINE è incluso in ComputeRoutesRequest.extra_computations. Gli intervalli coprono l'intera polilinea di RouteLeg senza sovrapposizioni. Il punto di partenza di un intervallo specificato è lo stesso del punto di arrivo 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 di viaggio rappresentata in formato di testo.

duration

object (LocalizedText)

Durata, rappresentata in formato di testo e localizzata in base alla regione della query. Tiene conto delle condizioni del traffico. Nota: se non hai richiesto informazioni sul traffico, questo valore corrisponde a staticDuration.

staticDuration

object (LocalizedText)

Durata senza tenere conto delle condizioni del traffico, rappresentata in formato di testo.

StepsOverview

Fornisce informazioni generali su un elenco di RouteLegStep.

Rappresentazione JSON
{
  "multiModalSegments": [
    {
      object (MultiModalSegment)
    }
  ]
}
Campi
multiModalSegments[]

object (MultiModalSegment)

Informazioni riepilogative 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)

NavigationInstruction per il segmento multimodale.

travelMode

enum (RouteTravelMode)

La modalità di viaggio del segmento multimodale.

stepStartIndex

integer

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

stepEndIndex

integer

L'indice RouteLegStep corrispondente che rappresenta la fine di un segmento multimodale.

Area visibile

Un'area visibile di latitudine e longitudine, rappresentata da due punti low e high diagonalmente opposti. 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, mentre i limiti di longitudine devono essere compresi tra -180 e 180 gradi inclusi. Ecco alcuni esempi:

  • Se low = high, l'area visibile è costituita da quel singolo punto.

  • Se low.longitude > high.longitude, l'intervallo di longitudine è 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.

Sia low che high devono essere compilati e la casella rappresentata non può essere vuota (come specificato dalle definizioni riportate sopra). Un'area visibile vuota genera 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 (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
Campi
low

object (LatLng)

Obbligatorio. Il punto più 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 di viaggio rappresentata in formato di testo.

duration

object (LocalizedText)

Durata, rappresentata in formato di testo e localizzata in base alla regione della query. Tiene conto delle condizioni del traffico. Nota: se non hai richiesto informazioni sul traffico, questo valore corrisponde a staticDuration.

staticDuration

object (LocalizedText)

Durata senza tenere conto delle condizioni del traffico, rappresentata in formato di testo.

transitFare

object (LocalizedText)

Tariffa del trasporto pubblico rappresentata in formato di testo.

PolylineDetails

Dettagli corrispondenti a un determinato indice o segmento contiguo di una polilinea. Data una polilinea con i punti P_0, P_1, … , P_N (indice in base zero), PolylineDetails definisce un intervallo e i metadati associati.

Rappresentazione JSON
{
  "tunnelInfo": [
    {
      object (TunnelInfo)
    }
  ],
  "restrictionInfo": [
    {
      object (RestrictionInfo)
    }
  ],
  "flyoverInfo": [
    {
      object (FlyoverInfo)
    }
  ],
  "narrowRoadInfo": [
    {
      object (NarrowRoadInfo)
    }
  ],
  "bridgeInfo": [
    {
      object (BridgeInfo)
    }
  ],
  "skywayInfo": [
    {
      object (SkywayInfo)
    }
  ]
}
Campi
tunnelInfo[]

object (TunnelInfo)

Dettagli del tunnel lungo la polilinea. Questo campo viene compilato se la richiesta specifica il modificatore di percorso avoidTunnels e il percorso risultante non riesce a evitarli OPPURE se TUNNEL_INFO_ON_POLYLINE è specificato in extraComputations e il percorso contiene tunnel.

restrictionInfo[]

object (RestrictionInfo)

Dettagli delle limitazioni lungo la polilinea. Questo campo viene compilato solo se una richiesta specifica il modificatore di percorso vehicleInfo e il percorso risultante contiene una limitazione applicabile. In caso contrario, questo campo non viene utilizzato.

flyoverInfo[]

object (FlyoverInfo)

Dettagli del sorvolo lungo la polilinea.

narrowRoadInfo[]

object (NarrowRoadInfo)

Dettagli della strada stretta lungo la polilinea.

bridgeInfo[]

object (BridgeInfo)

Dettagli del ponte lungo la polilinea.

skywayInfo[]

object (SkywayInfo)

Dettagli dello skyway lungo la polilinea.

TunnelInfo

Contiene informazioni sui tunnel lungo la polilinea.

Rappresentazione JSON
{
  "tunnelPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
Campi
tunnelPresence

enum (RoadFeatureState)

Indica se esiste un tunnel per un determinato tratto della polilinea.

polylinePointIndex

object (PolylinePointIndex)

La posizione delle informazioni relative al tunnel lungo la polilinea.

RoadFeatureState

Incapsula gli stati degli elementi stradali lungo un tratto di polilinea.

Enum
ROAD_FEATURE_STATE_UNSPECIFIED Lo stato dell'elemento stradale non è stato calcolato (valore predefinito).
EXISTS La caratteristica stradale esiste.
DOES_NOT_EXIST La caratteristica della strada non esiste.

PolylinePointIndex

Incapsula gli indici di inizio e fine per un dettaglio della polilinea. Per i casi in cui i dati corrispondono a un singolo punto, startIndex e endIndex saranno uguali.

Rappresentazione JSON
{
  "startIndex": integer,
  "endIndex": integer
}
Campi
startIndex

integer

L'indice iniziale di questo dettaglio nella polilinea.

endIndex

integer

L'indice finale di questo dettaglio nella polilinea.

RestrictionInfo

Contiene informazioni su varie limitazioni lungo la polilinea.

Rappresentazione JSON
{
  "restrictionPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "restrictedHeightMm": string,
  "restrictedWeightKg": string,
  "hazardousGoods": boolean,
  "trucksProhibited": boolean
  // End of mutually exclusive fields.
}
Campi
restrictionPresence

enum (RoadFeatureState)

Solo output. Indica se esiste una limitazione per un determinato tratto della polilinea.

polylinePointIndex

object (PolylinePointIndex)

La posizione delle informazioni relative alle limitazioni lungo la polilinea.

Incapsula i tipi di limitazioni che possono essere applicate a un determinato tratto della polilinea. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
restrictedHeightMm

string (int64 format)

Il limite di altezza, in millimetri. Questo campo viene compilato quando l'altezza limitata impedisce il passaggio o comporta un'altezza libera dal suolo ridotta per il veicolo specificato.

restrictedWeightKg

string (int64 format)

Il limite di peso, in chilogrammi. Questo campo viene compilato quando la limitazione di peso impedisce il passaggio o è vicina al peso del veicolo specificato.

hazardousGoods

boolean

Questo campo è impostato su true quando il trasporto di merci pericolose è limitato.

trucksProhibited

boolean

Questo campo è impostato su true quando i camion sono vietati.

Fine dei campi che si escludono a vicenda.

FlyoverInfo

Incapsula le informazioni sui cavalcavia lungo la polilinea.

Rappresentazione JSON
{
  "flyoverPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
Campi
flyoverPresence

enum (RoadFeatureState)

Solo output. Indica se esiste un cavalcavia per un determinato tratto della polilinea.

polylinePointIndex

object (PolylinePointIndex)

La posizione delle informazioni relative al cavalcavia lungo la polilinea.

NarrowRoadInfo

Contiene informazioni sulle strade strette lungo la polilinea.

Rappresentazione JSON
{
  "narrowRoadPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
Campi
narrowRoadPresence

enum (RoadFeatureState)

Solo output. Indica se esiste una strada stretta per un determinato tratto della polilinea.

polylinePointIndex

object (PolylinePointIndex)

La posizione delle informazioni relative alla strada stretta lungo la polilinea.

BridgeInfo

Contiene informazioni sui ponti lungo la polilinea.

Rappresentazione JSON
{
  "bridgePresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
Campi
bridgePresence

enum (RoadFeatureState)

Indica se esiste un ponte per un determinato tratto della polilinea.

polylinePointIndex

object (PolylinePointIndex)

La posizione delle informazioni relative al ponte lungo la polilinea.

SkywayInfo

Contiene informazioni sui passaggi sopraelevati lungo la polilinea.

Rappresentazione JSON
{
  "skywayPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
Campi
skywayPresence

enum (RoadFeatureState)

Indica se esiste un passaggio sopraelevato per un determinato tratto della polilinea.

polylinePointIndex

object (PolylinePointIndex)

La posizione delle informazioni relative alla passerella lungo la polilinea.

GeocodingResults

Contiene GeocodedWaypoints per i waypoint di origine, destinazione e intermedi. Compilato solo per i waypoint degli indirizzi.

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

object (GeocodedWaypoint)

Waypoint di partenza geocodificato.

destination

object (GeocodedWaypoint)

Waypoint con geocodifica della destinazione.

intermediates[]

object (GeocodedWaypoint)

Un elenco di tappe intermedie geocodificate, ciascuna contenente un campo indice che corrisponde alla posizione in base zero della tappa nell'ordine in cui sono state specificate nella richiesta.

GeocodedWaypoint

Dettagli sulle località utilizzate come tappe. Compilato solo per i waypoint degli indirizzi. Include i dettagli sui risultati della geocodifica per determinare l'indirizzo geocodificato.

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

I tipi di risultato, sotto forma di zero o più tag di tipo. Tipi supportati: Tipi di indirizzi e tipi di componenti di indirizzo.

partialMatch

boolean

Indica che il geocodificatore non ha restituito una corrispondenza esatta per la richiesta originale, anche se è stato in grado di trovare una corrispondenza per parte dell'indirizzo richiesto. Ti consigliamo di esaminare la richiesta originale per verificare la presenza di errori ortografici e/o di un indirizzo incompleto.

placeId

string

L'ID luogo per questo risultato.

intermediateWaypointRequestIndex

integer

L'indice del waypoint intermedio corrispondente nella richiesta. Compilato solo se il waypoint corrispondente è un waypoint intermedio.