Route

Encapsula una ruta, que consiste en una serie de tramos de ruta conectados que unen puntos de referencia intermedios, de inicio y de finalización.

Representación 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
  ]
}
Campos
legs[]

object (RouteLeg)

Conjunto de tramos (segmentos de ruta entre puntos de referencia) que conforman la ruta. Cada etapa corresponde al viaje entre dos puntos de referencia que no son de via. Por ejemplo, una ruta sin puntos de referencia intermedios solo tiene un segmento. Una ruta que incluye un punto de referencia intermedio no via tiene dos segmentos. Una ruta que incluye un punto de referencia intermedio via tiene un segmento. El orden de los segmentos coincide con el orden de los puntos de referencia de origin a intermediates y destination.

distanceMeters

integer

La distancia de viaje de la ruta en metros.

duration

string (Duration format)

El tiempo necesario para navegar por la ruta. Si configuras routingPreference como TRAFFIC_UNAWARE, este valor es el mismo que staticDuration. Si estableces routingPreference como TRAFFIC_AWARE o TRAFFIC_AWARE_OPTIMAL, este valor se calcula teniendo en cuenta las condiciones de tráfico.

Es una duración en segundos con hasta nueve dígitos decimales que termina en "s". Ejemplo: "3.5s".

staticDuration

string (Duration format)

Indica la duración del viaje por la ruta sin considerar las condiciones del tráfico.

Es una duración en segundos con hasta nueve dígitos decimales que termina en "s". Ejemplo: "3.5s".

polyline

object (Polyline)

Polilínea general de la ruta Esta polilínea será la polilínea combinada de todos los elementos legs.

description

string

Una descripción de la ruta.

warnings[]

string

Un array de advertencias para mostrar cuando se muestre la ruta.

viewport

object (Viewport)

Es el cuadro de límite del viewport de la polilínea.

travelAdvisory

object (RouteTravelAdvisory)

Información adicional sobre la ruta.

optimizedIntermediateWaypointIndex[]

integer

Si ComputeRoutesRequest.optimize_waypoint_order se establece como verdadero, este campo contiene el orden optimizado de los puntos de referencia intermedios. De lo contrario, este campo estará vacío. Por ejemplo, supongamos que la entrada es Origen: Los Ángeles; Intermedios: Dallas, Bangor, Phoenix; Destino: Nueva York; y el orden optimizado del punto de referencia intermedio es: Phoenix, Dallas, Bangor. Entonces, este campo contiene los valores [2, 0, 1]. El índice comienza con 0 para el primer punto de referencia intermedio.

RouteLeg

Encapsula un segmento entre puntos de referencia que no son de via.

Representación JSON
{
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "steps": [
    {
      object (RouteLegStep)
    }
  ],
  "travelAdvisory": {
    object (RouteLegTravelAdvisory)
  }
}
Campos
distanceMeters

integer

La distancia de viaje del tramo de la ruta, en metros.

duration

string (Duration format)

Es el tiempo necesario para navegar por la pierna. Si route_preference se configura como TRAFFIC_UNAWARE, este valor es el mismo que staticDuration. Si route_preference es TRAFFIC_AWARE o TRAFFIC_AWARE_OPTIMAL, este valor se calcula teniendo en cuenta las condiciones de tráfico.

Es una duración en segundos con hasta nueve dígitos decimales que termina en "s". Ejemplo: "3.5s".

staticDuration

string (Duration format)

Indica la duración del viaje a través de la etapa, calculada sin considerar las condiciones de tráfico.

Es una duración en segundos con hasta nueve dígitos decimales que termina en "s". Ejemplo: "3.5s".

polyline

object (Polyline)

La polilínea general de este segmento Esto incluye la polilínea de cada step.

startLocation

object (Location)

La ubicación inicial de este tramo. Puede ser diferente del origin proporcionado. Por ejemplo, cuando el elemento origin proporcionado no está cerca de una ruta, es un punto de la ruta.

endLocation

object (Location)

La ubicación final de este tramo. Puede ser diferente del destination proporcionado. Por ejemplo, cuando el elemento destination proporcionado no está cerca de una ruta, es un punto de la ruta.

steps[]

object (RouteLegStep)

Es un array de pasos que denota segmentos dentro de este segmento. Cada paso representa una instrucción de navegación.

travelAdvisory

object (RouteLegTravelAdvisory)

Encapsula la información adicional que se debe informar al usuario, como una posible restricción de la zona de tráfico, etc., en un tramo de la ruta.

Polilínea

Encapsula una polilínea codificada.

Representación 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.
}
Campos
Campo de unión polyline_type. Encapsula el tipo de polilínea. La configuración predeterminada es coding_polyline. Las direcciones (polyline_type) solo pueden ser una de las siguientes opciones:
encodedPolyline

string

Codificación de strings de la polilínea mediante el algoritmo de codificación de polilínea

geoJsonLinestring

object (Struct format)

Especifica una polilínea con el formato LineString de GeoJSON

RouteLegStep

Encapsula un segmento de un RouteLeg. Un paso corresponde a una sola instrucción de navegación. Los tramos de la ruta se componen de escalones.

Representación JSON
{
  "distanceMeters": integer,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "navigationInstruction": {
    object (NavigationInstruction)
  },
  "travelAdvisory": {
    object (RouteLegStepTravelAdvisory)
  }
}
Campos
distanceMeters

integer

La distancia de viaje de este paso, en metros. En algunas circunstancias, es posible que este campo no tenga un valor.

staticDuration

string (Duration format)

Indica la duración del viaje por este paso sin considerar las condiciones de tráfico. En algunas circunstancias, es posible que este campo no tenga un valor.

Es una duración en segundos con hasta nueve dígitos decimales que termina en "s". Ejemplo: "3.5s".

polyline

object (Polyline)

La polilínea asociada con este paso.

startLocation

object (Location)

La ubicación inicial de este paso.

endLocation

object (Location)

Es la ubicación final de este paso.

navigationInstruction

object (NavigationInstruction)

Instrucciones de navegación

travelAdvisory

object (RouteLegStepTravelAdvisory)

Encapsula la información adicional sobre la que se debe informar al usuario, como una posible restricción de la zona de tráfico en un paso de la etapa.

RouteLegStepTravelAdvisory

Encapsula la información adicional sobre la que se debe informar al usuario, como una posible restricción de la zona de tráfico en un paso de la etapa.

Representación JSON
{
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}
Campos
speedReadingIntervals[]

object (SpeedReadingInterval)

Intervalos de lectura rápida que detallan la densidad del tráfico Se aplica en el caso de las preferencias de enrutamiento de TRAFFIC_AWARE y TRAFFIC_AWARE_OPTIMAL. Los intervalos cubren toda la polilínea de RouteLegStep sin superposición. El punto de inicio de un intervalo especificado es el mismo que el punto de finalización del intervalo anterior.

Ejemplo:

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

RouteLegTravelAdvisory

Encapsula la información adicional que se debe informar al usuario, como una posible restricción de la zona de tráfico, etc., en un tramo de la ruta.

Representación JSON
{
  "tollInfo": {
    object (TollInfo)
  },
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}
Campos
tollInfo

object (TollInfo)

Encapsula la información sobre peajes en el RouteLeg específico. Este campo solo se completa si esperamos que haya peajes en el RouteLeg. Si se establece este campo, pero no se propaga el subcampoEstimatedPrice, se prevé que la ruta contenga peajes, pero no sabemos un precio estimado. Si este campo no existe, no hay peaje en RouteLeg.

speedReadingIntervals[]

object (SpeedReadingInterval)

Intervalos de lectura rápida que detallan la densidad del tráfico Se aplica en el caso de las preferencias de enrutamiento de TRAFFIC_AWARE y TRAFFIC_AWARE_OPTIMAL. Los intervalos cubren toda la polilínea de RouteLg sin superposición. El punto de inicio de un intervalo especificado es el mismo que el punto de finalización del intervalo anterior.

Ejemplo:

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