Route

Incapsula un percorso, composto da una serie di tratti di strada collegati che uniscono punti di partenza, arrivo e intermedi.

Rappresentazione JSON 
{
  "legs": [
    {
      object (RouteLeg)
    }
  ],
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "description": string,
  "warnings": [
    string
  ],
  "viewport": {
    object (Viewport)
  },
  "travelAdvisory": {
    object (RouteTravelAdvisory)
  },
  "optimizedIntermediateWaypointIndex": [
    integer
  ]
}
Campi
legs[]

object (RouteLeg)

Un insieme di tratti (segmenti di percorso tra tappe) che compongono il percorso. Ogni tratto corrisponde al percorso tra due Waypoint non via. Ad esempio, un percorso senza tappe intermedie ha un solo tratto. Un percorso che include una tappa intermedia non via ha due tratti. Un percorso che include un waypoint intermedio via ha una tappa. L'ordine delle tappe corrisponde all'ordine dei Waypoint da origin a intermediates a destination.
distanceMeters

integer

La distanza da percorrere in metri.
duration

string (Duration format)

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

Durata in secondi con un massimo di nove cifre frazionarie e termina con "s". Esempio: "3.5s".
staticDuration

string (Duration format)

La durata del viaggio senza tenere conto delle condizioni del traffico.

Durata in secondi con un massimo di nove cifre frazionarie e termina con "s". Esempio: "3.5s".
polyline

object (Polyline)

La polilinea complessiva del percorso. Questa polilinea sarà la polilinea combinata di tutti gli elementi legs.
description

string

Una descrizione del percorso.
warnings[]

string

Un array di avvisi da mostrare quando si visualizza il percorso.
viewport

object (Viewport)

Il riquadro di delimitazione dell'area visibile della polilinea.
travelAdvisory

object (RouteTravelAdvisory)

Ulteriori informazioni sul percorso.
optimizedIntermediateWaypointIndex[]

integer

Se ComputeRoutesRequest.optimize_waypoint_order è impostato su true, questo campo contiene l'ordine ottimizzato delle tappe intermedie. altrimenti il campo è vuoto. Ad esempio, supponiamo che l'input sia Origine: LA; Intermedi: Dallas, Bangor, Phoenix; Destinazione: New York; e l'ordine intermedio ottimizzato dei punti di riferimento è Phoenix, Dallas, Bangor. Questo campo contiene i valori [2, 0, 1]. L'indice inizia con 0 per la prima tappa intermedia.

RouteLeg

Incapsula 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)
  }
}
Campi
distanceMeters

integer

La distanza da percorrere della tratta del percorso, in metri.
duration

string (Duration format)

Il tempo necessario per muovere la gamba. Se route_preference è impostato su TRAFFIC_UNAWARE, questo valore corrisponde a staticDuration. Se route_preference è TRAFFIC_AWARE o TRAFFIC_AWARE_OPTIMAL, questo valore viene calcolato prendendo in considerazione le condizioni del traffico.

Durata in secondi con un massimo di nove cifre frazionarie e termina con "s". Esempio: "3.5s".
staticDuration

string (Duration format)

La durata del viaggio, calcolata senza tenere conto delle condizioni del traffico.

Durata in secondi con un massimo di nove cifre frazionarie e termina con "s". Esempio: "3.5s".
polyline

object (Polyline)

La polilinea complessiva di questa gamba. È inclusa la polilinea di ogni step.
startLocation

object (Location)

La posizione iniziale di questo tratto. Questo valore potrebbe essere diverso dal valore origin fornito. Ad esempio, se il valore origin fornito non è vicino a una strada, questo è un punto sulla strada.
endLocation

object (Location)

La posizione finale di questa gamba. Questo valore potrebbe essere diverso dal valore destination fornito. 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 questo tratto. Ogni passaggio rappresenta un'istruzione di navigazione.
travelAdvisory

object (RouteLegTravelAdvisory)

Raggruppano le informazioni aggiuntive di cui l'utente deve essere informato, ad esempio eventuali limitazioni in base al traffico e così via, su una tratta del percorso.

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 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 polilinee.
geoJsonLinestring

object (Struct format)

Specifica una polilinea utilizzando il formato LineString GeoJSON

RouteLegStep

Incapsula un segmento di un RouteLeg. Un passaggio corrisponde a una singola istruzione di navigazione. I tratti di percorso sono costituiti da gradini.

Rappresentazione JSON 
{
  "distanceMeters": integer,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "navigationInstruction": {
    object (NavigationInstruction)
  },
  "travelAdvisory": {
    object (RouteLegStepTravelAdvisory)
  }
}
Campi
distanceMeters

integer

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

string (Duration format)

La durata del viaggio attraverso questo passaggio senza prendere in considerazione le condizioni del traffico. In alcuni casi, questo campo potrebbe non avere un valore.

Durata in secondi con un massimo di nove cifre frazionarie e termina con "s". Esempio: "3.5s".
polyline

object (Polyline)

La polilinea associata a questo passaggio.
startLocation

object (Location)

Il punto di partenza di questo passaggio.
endLocation

object (Location)

La posizione finale di questo passaggio.
navigationInstruction

object (NavigationInstruction)

Istruzioni di navigazione.
travelAdvisory

object (RouteLegStepTravelAdvisory)

Incapsula le informazioni aggiuntive di cui l'utente deve essere informato, come la possibile limitazione di una zona di traffico in un passo.

RouteLegStepTravelAdvisory

Incapsula le informazioni aggiuntive di cui l'utente deve essere informato, come la possibile limitazione di una zona di traffico in un passo.

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

object (SpeedReadingInterval)

Intervalli di lettura della velocità che descrivono in dettaglio la densità del traffico. Applicabile in caso di preferenze di routing per TRAFFIC_AWARE e TRAFFIC_AWARE_OPTIMAL. Gli intervalli coprono l'intera polilinea di RouteLegStep 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).

RouteLegTravelAdvisory

Raggruppano le informazioni aggiuntive di cui l'utente deve essere informato, ad esempio eventuali limitazioni in base al traffico e così via, su una tratta del percorso.

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

object (TollInfo)

Include informazioni sui pedaggi della RouteLeg specifica. Questo campo viene compilato solo se prevediamo la presenza di pedaggi sulla RouteLeg. Se questo campo è impostato ma il sottocampo "stimatoPrice" non è compilato, prevediamo che la strada contenga pedaggi, ma non conosciamo il prezzo stimato. Se questo campo non esiste, non è previsto alcun pedaggio sulla RouteLeg.
speedReadingIntervals[]

object (SpeedReadingInterval)

Intervalli di lettura della velocità che descrivono in dettaglio la densità del traffico. Applicabile in caso di preferenze di routing per TRAFFIC_AWARE e TRAFFIC_AWARE_OPTIMAL. Gli intervalli coprono l'intera polilinea della RouteLg senza sovrapposizione. 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).