Method: computeRoutes

Muestra la ruta principal junto con las rutas alternativas opcionales, de acuerdo con un conjunto de puntos de referencia intermedios y de terminal.

NOTA: Este método requiere que especifiques una máscara de campo de respuesta en la entrada. Puedes proporcionar la máscara del campo de respuesta con el parámetro de URL $fields o fields, o con un encabezado HTTP/gRPC X-Goog-FieldMask (consulta los encabezados y parámetros de URL disponibles). El valor es una lista separada por comas de las rutas de los campos. Consulte la documentación detallada sobre cómo construir las rutas de campo.

Por ejemplo, en este método:

  • Máscara de campo de todos los campos disponibles (para la inspección manual): X-Goog-FieldMask: *
  • Máscara de campo de duración, distancia y polilínea a nivel de ruta (una configuración de producción de ejemplo): X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline

Google desaconseja el uso de la máscara de campo de respuesta de comodín (*) o la especificación de la máscara de campo del nivel superior (routes), por los siguientes motivos:

  • Seleccionar solo los campos que necesitas ayuda a nuestro servidor a guardar ciclos de procesamiento, lo que nos permite mostrarte el resultado con una latencia más baja.
  • Seleccionar solo los campos que necesitas en tu trabajo de producción garantiza un rendimiento estable de latencia. Es posible que agreguemos más campos de respuesta en el futuro, y que esos nuevos campos puedan requerir tiempo de procesamiento adicional. Si seleccionas todos los campos, o si seleccionas todos los campos del nivel superior, es posible que experimentes una degradación del rendimiento porque cualquier campo nuevo que agreguemos se incluirá automáticamente en la respuesta.
  • Si seleccionas solo los campos que necesitas, el tamaño de la respuesta será menor y, por lo tanto, tendrás una capacidad de procesamiento de red más alta.

Solicitud HTTP

POST https://routes.googleapis.com/directions/v2:computeRoutes

La URL usa la sintaxis de la transcodificación gRPC.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación 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)
  }
}
Campos
origin

object (Waypoint)

Obligatorio. Punto de referencia de origen.

destination

object (Waypoint)

Obligatorio. Punto de referencia de destino.

intermediates[]

object (Waypoint)

Opcional. Es un conjunto de puntos de referencia a lo largo de la ruta (sin incluir los puntos de terminal) que se pueden detener o pasar por este lugar. Se admiten hasta 25 puntos de referencia intermedios.

travelMode

enum (RouteTravelMode)

Opcional. Especifica el medio de transporte.

routingPreference

enum (RoutingPreference)

Opcional. Especifica cómo calcular la ruta. El servidor intenta usar la preferencia de enrutamiento seleccionada para calcular la ruta. Si la preferencia de enrutamiento genera un error o una latencia extra larga, se muestra un error. Puedes especificar esta opción solo cuando travelMode sea DRIVE o TWO_WHEELER; de lo contrario, la solicitud fallará.

polylineQuality

enum (PolylineQuality)

Opcional. Especifica tu preferencia por la calidad de la polilínea.

polylineEncoding

enum (PolylineEncoding)

Opcional. Especifica la codificación preferida para la polilínea.

departureTime

string (Timestamp format)

Opcional. La hora de salida. Si no estableces este valor, el valor se establecerá de forma predeterminada en el momento en que hayas realizado la solicitud. NOTA: Solo puedes especificar un departureTime en el pasado cuando RouteTravelMode se establece en TRANSIT.

Es una marca de tiempo en formato RFC3339 UTC “Zulú”, con resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

arrivalTime

string (Timestamp format)

Opcional. La hora de llegada. NOTA: Solo se puede establecer cuando RouteTravelMode se configura como TRANSIT. Puedes especificar departureTime o arrivalTime, pero no ambos.

Es una marca de tiempo en formato RFC3339 UTC “Zulú”, con resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

computeAlternativeRoutes

boolean

Opcional. Especifica si se deben calcular rutas alternativas además de la ruta. No se muestran rutas alternativas para las solicitudes que tienen puntos de referencia intermedios.

routeModifiers

object (RouteModifiers)

Opcional. Un conjunto de condiciones que se deben satisfacer y que afectan la forma en que se calculan las rutas.

languageCode

string

Opcional. El código de idioma BCP-47, como "en-US" o "sr-Latn". Para obtener más información, consulta http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Consulta Idiomas admitidos para consultar la lista de idiomas admitidos. Cuando no proporcionas este valor, el idioma de visualización se infiere de la ubicación de la solicitud de ruta.

regionCode

string

Opcional. El código de región, especificado como un valor ccTLD ("dominio de nivel superior") de dos caracteres. Para obtener más información, consulte https://en.wikipedia.org/wiki/List_of_Internet_top-level_domains#Country_code_top-level_domains

units

enum (Units)

Opcional. Especifica las unidades de medida para los campos de visualización. Estos campos incluyen el campo instruction en NavigationInstruction. Las unidades de medida que se usan para la ruta, el tramo, la distancia del paso y la duración no se ven afectadas por este valor. Si no proporcionas este valor, las unidades de visualización se infieren de la ubicación del primer origen.

optimizeWaypointOrder

boolean

Opcional. Si se configura como verdadera, el servicio intenta minimizar el costo general de la ruta reordenando los puntos de referencia intermedios especificados. La solicitud falla si alguno de los puntos de referencia intermedios es un punto de referencia via. Usa ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index para encontrar el nuevo orden. Si no se solicita ComputeRoutesResponseroutes.optimized_intermediate_waypoint_index en el encabezado X-Goog-FieldMask, la solicitud falla. Si optimizeWaypointOrder se configura como falso, ComputeRoutesResponse.optimized_intermediate_waypoint_index estará vacío.

requestedReferenceRoutes[]

enum (ReferenceRoute)

Opcional. Especifica qué rutas de referencia calcular como parte de la solicitud, además de la ruta predeterminada. Una ruta de referencia es una ruta con un objetivo de cálculo de ruta diferente al de la ruta predeterminada. Por ejemplo, un cálculo de la ruta de referencia de FUEL_EFFICIENT toma en cuenta varios parámetros que generarían una ruta óptima con mayor ahorro de combustible.

extraComputations[]

enum (ExtraComputation)

Opcional. Una lista de cálculos adicionales que se pueden usar para completar la solicitud. Nota: Estos cálculos adicionales pueden mostrar campos adicionales en la respuesta. Estos campos adicionales también se deben especificar en la máscara de campo que se mostrará en la respuesta.

trafficModel

enum (TrafficModel)

Opcional. Especifica las suposiciones que deben usarse al calcular el tiempo con tráfico. Esta configuración afecta el valor que se muestra en el campo de duración en Route y RouteLeg, que contiene el tiempo previsto en el tráfico según los promedios históricos. TrafficModel solo está disponible para solicitudes que establecieron RoutingPreference como TRAFFIC_AWARE_OPTIMAL y RouteTravelMode como DRIVE. La configuración predeterminada es BEST_GUESS si se solicita tráfico y no se especifica TrafficModel.

transitPreferences

object (TransitPreferences)

Opcional. Especifica las preferencias que influyen en la ruta que se muestra para las rutas TRANSIT. NOTA: Solo puedes especificar un transitPreferences cuando RouteTravelMode se establece en TRANSIT.

Cuerpo de la respuesta

v2.computeRoutes el mensaje de respuesta.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON
{
  "routes": [
    {
      object (Route)
    }
  ],
  "fallbackInfo": {
    object (FallbackInfo)
  },
  "geocodingResults": {
    object (GeocodingResults)
  }
}
Campos
routes[]

object (Route)

Contiene un array de rutas calculadas (hasta tres) cuando especificas el campo compute_alternatives_routes y contiene solo una ruta cuando no la necesitas. Cuando este array contiene varias entradas, la primera es la ruta más recomendada. Si el array está vacío, no se encontró ninguna ruta.

fallbackInfo

object (FallbackInfo)

En algunos casos, cuando el servidor no puede calcular los resultados de la ruta con todas las preferencias de entrada, puede recurrir a una forma de procesamiento diferente. Cuando se usa el modo de resguardo, este campo contiene información detallada sobre la respuesta de resguardo. De lo contrario, este campo no se establece.

geocodingResults

object (GeocodingResults)

Contiene información de respuesta de geocodificación para puntos de referencia especificados como direcciones.

Calidad de la polilínea

Un conjunto de valores que especifican la calidad de la polilínea.

Enumeradores
POLYLINE_QUALITY_UNSPECIFIED No se especificó ninguna preferencia de calidad para polilíneas. La configuración predeterminada es OVERVIEW.
HIGH_QUALITY Especifica una polilínea de alta calidad, que se compone de más puntos que OVERVIEW, a costa de un tamaño de respuesta aumentado. Usa este valor cuando necesites más precisión.
OVERVIEW Especifica una polilínea de descripción general, que se compone de una pequeña cantidad de puntos. Usa este valor cuando muestres una descripción general de la ruta. El uso de esta opción tiene una latencia de solicitud más baja en comparación con el uso de la opción HIGH_QUALITY.

Codificación de polilínea

Especifica el tipo preferido de polilínea que se debe mostrar.

Enumeradores
POLYLINE_ENCODING_UNSPECIFIED No se especificó ninguna preferencia de tipo de polilínea. La configuración predeterminada es ENCODED_POLYLINE.
ENCODED_POLYLINE Especifica una polilínea codificada con el algoritmo de codificación de polilínea.
GEO_JSON_LINESTRING Especifica una polilínea con el formato LineString de GeoJSON

Unidades

Es un conjunto de valores que especifica la unidad de medida utilizada en la pantalla.

Enumeradores
UNITS_UNSPECIFIED No se especifican las unidades de medida. El valor predeterminado es la unidad de medida inferida de la solicitud.
METRIC Unidades métricas de medición.
IMPERIAL Unidades de medida imperiales (inglés).

Ruta de referencia

Una ruta de referencia compatible en ComputeRoutesRequest.

Enumeradores
REFERENCE_ROUTE_UNSPECIFIED No se usa. Las solicitudes que contienen este valor fallan.
FUEL_EFFICIENT Ruta que consume combustible Las rutas etiquetadas con este valor están optimizadas para parámetros como el consumo de combustible.

Procesamiento adicional

Cálculos adicionales para realizar mientras se completa la solicitud.

Enumeradores
EXTRA_COMPUTATION_UNSPECIFIED No se usa. Las solicitudes que contengan este valor fallarán.
TOLLS Información de peaje para las rutas.
FUEL_CONSUMPTION Consumo de combustible estimado de las rutas.
TRAFFIC_ON_POLYLINE Polilíneas con información sobre el tráfico para las rutas
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS Las instrucciones de navegación se presentan como una string de texto HTML con formato. Este contenido se debe leer tal como está. Este contenido es solo para visualización. No lo analices de manera programática.

Route

Contiene una ruta, que consiste en una serie de tramos de ruta conectados que unen puntos de referencia iniciales, finales y intermedios.

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

enum (RouteLabel)

Etiquetas de Route que son útiles para identificar propiedades específicas de la ruta para compararlas con otras.

legs[]

object (RouteLeg)

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

distanceMeters

integer

Indica la distancia de viaje de la ruta, en metros.

duration

string (Duration format)

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

Una duración en segundos con un máximo de 9 dígitos decimales, que termina en 's'. Ejemplo: "3.5s".

staticDuration

string (Duration format)

La duración del viaje a través de la ruta sin tener en cuenta las condiciones del tráfico.

Una duración en segundos con un máximo de 9 dígitos decimales, que termina en 's'. Ejemplo: "3.5s".

polyline

object (Polyline)

La polilínea general de la ruta Esta polilínea es la polilínea combinada de todo legs.

description

string

Es una descripción de la ruta.

warnings[]

string

Es un array de advertencias que se muestran cuando se muestra la ruta.

viewport

object (Viewport)

Cuadro de límite del viewport de la polilínea

travelAdvisory

object (RouteTravelAdvisory)

Información adicional sobre la ruta.

optimizedIntermediateWaypointIndex[]

integer

Si configuras optimizeWaypointOrder como verdadero, este campo contendrá el orden optimizado de los puntos de referencia intermedios. De lo contrario, este campo estará vacío. Por ejemplo, si proporcionas una entrada de Origen: Los Ángeles; puntos de referencia intermedios: Dallas, Bangor, Phoenix; Destino: Nueva York; y el orden optimizado de 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 proporcionado en la entrada.

localizedValues

object (RouteLocalizedValues)

Representaciones en el texto de las propiedades de Route

routeToken

string

Un token de ruta codificado en Base64 seguro para la Web que se puede pasar al SDK de Navigation, que permite que el SDK de Navigation reconstruya la ruta durante la navegación y, en caso de un redireccionamiento, cumpla con la intención original cuando la crees llamando a v2.computeRoutes. Los clientes deben tratar este token como un BLOB opaco. No está destinado a leer ni mutar. NOTA: Route.route_token solo está disponible para solicitudes que establecieron ComputeRoutesRequest.routing_preference como TRAFFIC_AWARE o TRAFFIC_AWARE_OPTIMAL. Route.route_token no es compatible con las solicitudes que tienen puntos de referencia de Via.

Etiqueta de ruta

Etiquetas de Route que son útiles para identificar propiedades específicas de la ruta para compararlas con otras.

Enumeradores
ROUTE_LABEL_UNSPECIFIED Predeterminado: no se usa.
DEFAULT_ROUTE La ruta "mejor" predeterminada que se muestra para el cálculo de la ruta.
DEFAULT_ROUTE_ALTERNATE Es una alternativa a la ruta "mejor" predeterminada. Las rutas como esta se mostrarán cuando se especifique computeAlternativeRoutes.
FUEL_EFFICIENT Ruta que consume combustible Las rutas etiquetadas con este valor están optimizadas para parámetros Eco, como el consumo de combustible.

Segmento de ruta

Contiene un segmento entre puntos de referencia que no son 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)
  },
  "localizedValues": {
    object (RouteLegLocalizedValues)
  },
  "stepsOverview": {
    object (StepsOverview)
  }
}
Campos
distanceMeters

integer

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

duration

string (Duration format)

El tiempo necesario para navegar por el tramo. Si route_preference está configurado como TRAFFIC_UNAWARE, este valor es el mismo que staticDuration. Si el route_preference es TRAFFIC_AWARE o TRAFFIC_AWARE_OPTIMAL, este valor se calcula teniendo en cuenta las condiciones del tráfico.

Una duración en segundos con un máximo de 9 dígitos decimales, que termina en 's'. Ejemplo: "3.5s".

staticDuration

string (Duration format)

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

Una duración en segundos con un máximo de 9 dígitos decimales, que termina en 's'. Ejemplo: "3.5s".

polyline

object (Polyline)

La polilínea general de esta etapa que incluye la polilínea de cada step.

startLocation

object (Location)

Es la ubicación de inicio de este segmento. Es posible que esta ubicación sea diferente de la origin proporcionada. Por ejemplo, cuando el origin proporcionado no está cerca de una ruta, este es un punto en la ruta.

endLocation

object (Location)

Es la ubicación final de este segmento. Es posible que esta ubicación sea diferente de la destination proporcionada. Por ejemplo, cuando el destination proporcionado no está cerca de una ruta, este es un punto en la ruta.

steps[]

object (RouteLegStep)

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

travelAdvisory

object (RouteLegTravelAdvisory)

Contiene la información adicional sobre la que se debe informar al usuario, como las posibles restricciones de zona de tráfico, en un segmento de ruta.

localizedValues

object (RouteLegLocalizedValues)

Representaciones en el texto de las propiedades de RouteLeg

stepsOverview

object (StepsOverview)

Obtén una descripción general de los pasos de este RouteLeg. Este campo solo se propaga en las rutas de TRANSICIÓN.

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 la polilínea encoded. Las direcciones (polyline_type) solo pueden ser una de las siguientes opciones:
encodedPolyline

string

La codificación de string 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

Paso de la ruta

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

Representación 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)
}
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 a través de este paso sin tener en cuenta las condiciones del tráfico. En algunas circunstancias, es posible que este campo no tenga un valor.

Una duración en segundos con un máximo de 9 dígitos decimales, que termina en 's'. Ejemplo: "3.5s".

polyline

object (Polyline)

La polilínea asociada con este paso.

startLocation

object (Location)

Es la ubicación de inicio de este paso.

endLocation

object (Location)

Es la ubicación final de este paso.

navigationInstruction

object (NavigationInstruction)

Instrucciones de navegación.

travelAdvisory

object (RouteLegStepTravelAdvisory)

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

localizedValues

object (RouteLegStepLocalizedValues)

Representaciones en el texto de las propiedades de RouteLegStep

transitDetails

object (RouteLegStepTransitDetails)

Los detalles correspondientes a este paso si el medio de transporte es TRANSIT

travelMode

enum (RouteTravelMode)

El medio de transporte usado en este paso.

Maneuver

Es un conjunto de valores que especifican la acción de navegación que se llevará a cabo para el paso actual (p.ej., girar a la izquierda, combinar, recta, etc.).

Enumeradores
MANEUVER_UNSPECIFIED No se usa.
TURN_SLIGHT_LEFT Gira levemente a la izquierda.
TURN_SHARP_LEFT Gira totalmente a la izquierda.
UTURN_LEFT Haz un giro en U a la izquierda.
TURN_LEFT Gira a la izquierda.
TURN_SLIGHT_RIGHT Gira levemente a la derecha.
TURN_SHARP_RIGHT Gira totalmente a la derecha.
UTURN_RIGHT Haz un giro en U correcto.
TURN_RIGHT Gira a la derecha.
STRAIGHT Recto.
RAMP_LEFT Toma la rampa izquierda.
RAMP_RIGHT Toma la rampa correcta.
MERGE Combina el tráfico.
FORK_LEFT Tome el tenedor izquierdo.
FORK_RIGHT Tome el tenedor correcto.
FERRY Toma el transbordador.
FERRY_TRAIN Toma el tren que va hacia el transbordador.
ROUNDABOUT_LEFT Gire a la izquierda en la rotonda.
ROUNDABOUT_RIGHT Gira a la derecha en la rotonda.
DEPART Maniobra inicial.
NAME_CHANGE Se usa para indicar un cambio de nombre de una calle.

Asesoramiento para Viajes de la ruta de la pierna

Contiene la información adicional sobre la que se debe informar al usuario, como las posibles restricciones de zona de tráfico en un paso del tramo.

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

object (SpeedReadingInterval)

NOTA: Actualmente, este campo no se propaga.

Valores localizados de la ruta

Representaciones de texto de determinadas propiedades.

Representación JSON
{
  "distance": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  }
}
Campos
distance

object (LocalizedText)

Se representa la distancia de viaje en forma de texto.

staticDuration

object (LocalizedText)

Es la duración sin considerar las condiciones del tráfico, representada en forma de texto.

Detalles de la ruta en transporte público

Información adicional para el RouteLegStep relacionado con rutas de TRANSIT.

Representación JSON
{
  "stopDetails": {
    object (TransitStopDetails)
  },
  "localizedValues": {
    object (TransitDetailsLocalizedValues)
  },
  "headsign": string,
  "headway": string,
  "transitLine": {
    object (TransitLine)
  },
  "stopCount": integer,
  "tripShortText": string
}
Campos
stopDetails

object (TransitStopDetails)

Información sobre las paradas de llegada y salida del paso.

localizedValues

object (TransitDetailsLocalizedValues)

Representaciones en el texto de las propiedades de RouteLegStepTransitDetails

headsign

string

Especifica la dirección en la que se debe viajar en esta línea como marcada en el vehículo o en la parada de salida. La dirección suele ser la estación terminal.

headway

string (Duration format)

Especifica el tiempo esperado como un período entre las salidas desde la misma parada a la hora. Por ejemplo, con un valor de segundos de intervalo de 600, se debe prever una espera de diez minutos en caso de perder un autobús.

Una duración en segundos con un máximo de 9 dígitos decimales, que termina en 's'. Ejemplo: "3.5s".

transitLine

object (TransitLine)

Información sobre la línea de transporte público que se usa en este paso.

stopCount

integer

Indica la cantidad de paradas desde la salida hasta la parada de llegada. Este recuento incluye la parada de llegada, pero excluye la parada de salida. Por ejemplo, si tu ruta sale de la parada A, pasa por las paradas B y C, y llega a la parada D, stopCount mostrará 3.

tripShortText

string

Es el texto que aparece en los horarios y carteles para que los pasajeros identifiquen un viaje en transporte público. El texto debe identificar de forma exclusiva un viaje durante un día de servicio. Por ejemplo, "538" es la línea tripShortText del tren Amtrak que sale de San José (CA) a las 15:10 los días de semana a Sacramento, CA.

Detalles de la parada de transporte público

Detalles sobre las paradas del transporte público para el RouteLegStep

Representación JSON
{
  "arrivalStop": {
    object (TransitStop)
  },
  "arrivalTime": string,
  "departureStop": {
    object (TransitStop)
  },
  "departureTime": string
}
Campos
arrivalStop

object (TransitStop)

Información sobre la parada de llegada del paso.

arrivalTime

string (Timestamp format)

Indica la hora estimada de llegada para el paso.

Es una marca de tiempo en formato RFC3339 UTC “Zulú”, con resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

departureStop

object (TransitStop)

Información sobre la parada de salida del paso.

departureTime

string (Timestamp format)

Indica la hora estimada de salida del paso.

Es una marca de tiempo en formato RFC3339 UTC “Zulú”, con resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

Parada de transporte público

Información sobre una parada de transporte público.

Representación JSON
{
  "name": string,
  "location": {
    object (Location)
  }
}
Campos
name

string

El nombre de la parada de transporte público.

location

object (Location)

La ubicación de la parada expresada en coordenadas de latitud y longitud.

ValoresLocalizadosDeTránsito

Descripciones localizadas de valores para RouteTransitDetails.

Representación JSON
{
  "arrivalTime": {
    object (LocalizedTime)
  },
  "departureTime": {
    object (LocalizedTime)
  }
}
Campos
arrivalTime

object (LocalizedTime)

La hora en la representación de texto con formato con la zona horaria correspondiente

departureTime

object (LocalizedTime)

La hora en la representación de texto con formato con la zona horaria correspondiente

Hora localizada

Descripción localizada del tiempo.

Representación JSON
{
  "time": {
    object (LocalizedText)
  },
  "timeZone": string
}
Campos
time

object (LocalizedText)

La hora especificada como una string en una zona horaria determinada.

timeZone

string

Contiene la zona horaria. El valor es el nombre de la zona horaria tal como se define en la base de datos de zonas horarias de IANA, p.ej., "America/New_York".

Línea de transporte público

Contiene información sobre la línea de transporte público que se usa en este paso.

Representación JSON
{
  "agencies": [
    {
      object (TransitAgency)
    }
  ],
  "name": string,
  "uri": string,
  "color": string,
  "iconUri": string,
  "nameShort": string,
  "textColor": string,
  "vehicle": {
    object (TransitVehicle)
  }
}
Campos
agencies[]

object (TransitAgency)

La empresa o las empresas de transporte público que operan esta línea de transporte público.

name

string

El nombre completo de esta línea de transporte público, por ejemplo, "Local de 8 Avenida".

uri

string

el URI de esta línea tal como la proporciona la empresa de transporte público.

color

string

El color que se usa comúnmente para la señalización de esta línea Representado en hexadecimal.

iconUri

string

Es el URI del ícono asociado con esta línea.

nameShort

string

El nombre corto de esta línea de transporte público. Normalmente, este nombre será un número de línea, como "M7" o "355".

textColor

string

El color que se usa comúnmente en el texto de la señalización de esta línea Representado en hexadecimal.

vehicle

object (TransitVehicle)

Es el tipo de vehículo que opera en esta línea de transporte público.

Empresa de transporte público

Una empresa de transporte público que opera una línea de transporte público.

Representación JSON
{
  "name": string,
  "phoneNumber": string,
  "uri": string
}
Campos
name

string

El nombre de la empresa de transporte público.

phoneNumber

string

El número de teléfono con formato específico de la configuración regional de la empresa de transporte público.

uri

string

El URI de la empresa de transporte público.

Vehículo de transporte público

Información sobre un vehículo que se usa en rutas de transporte público.

Representación JSON
{
  "name": {
    object (LocalizedText)
  },
  "type": enum (TransitVehicleType),
  "iconUri": string,
  "localIconUri": string
}
Campos
name

object (LocalizedText)

El nombre de este vehículo, en mayúsculas.

type

enum (TransitVehicleType)

Es el tipo de vehículo que se usa.

iconUri

string

Es el URI de un ícono asociado con este tipo de vehículo.

localIconUri

string

Es el URI del ícono asociado con este tipo de vehículo, según la señalización de transporte local.

Tipo de vehículo en tránsito

Es el tipo de vehículos para las rutas de transporte público.

Enumeradores
TRANSIT_VEHICLE_TYPE_UNSPECIFIED No se utiliza.
BUS Autobús
CABLE_CAR Un vehículo que funciona con un cable y generalmente sobre el suelo; Los teleféricos pueden ser del tipo GONDOLA_LIFT.
COMMUTER_TRAIN Ferrocarril suburbano
FERRY Ferry
FUNICULAR Un vehículo que sube por una pendiente pronunciada a través de un cable; Un funicular normalmente consta de dos coches; cada uno actúa como contrapeso del otro.
GONDOLA_LIFT Un funicular aéreo
HEAVY_RAIL Ferrocarril metropolitano
HIGH_SPEED_TRAIN Tren de alta velocidad
INTERCITY_BUS Autobús interurbano
LONG_DISTANCE_TRAIN Tren de larga distancia.
METRO_RAIL Transporte en tren ligero
MONORAIL Monorriel
OTHER Todos los demás vehículos
RAIL Ferrocarril
SHARE_TAXI El transporte “share taxi” es una clase de autobús que puede dejar y recoger pasajeros en cualquier punto de su recorrido.
SUBWAY Tren ligero subterráneo
TRAM Tren ligero sobre el suelo
TROLLEYBUS Trolebús

Asesoramiento para viajes de la ruta

Contiene la información adicional sobre la que se debe informar al usuario sobre un paso del tramo, como posibles restricciones de zona de tráfico.

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

object (TollInfo)

Contiene información sobre los peajes de la RouteLeg específica. Este campo solo se propaga si esperamos que haya peajes en RouteLeg. Si se establece este campo, pero el subcampo estimado de precio no está propagado, esperamos que la ruta contenga peajes, pero no sabemos cuál es el precio estimado. Si este campo no existe, no hay peajes en RouteLeg.

speedReadingIntervals[]

object (SpeedReadingInterval)

Intervalos de lectura de velocidad que detallan la densidad del tráfico Se aplica en el caso de las preferencias de enrutamiento TRAFFIC_AWARE y TRAFFIC_AWARE_OPTIMAL. Los intervalos cubren toda la polilínea de RouteLeg sin superponerse. El punto de inicio de un intervalo especificado es el mismo que el punto final del intervalo anterior.

Ejemplo:

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

Valores localizados de la ruta

Representaciones de texto de determinadas propiedades.

Representación JSON
{
  "distance": {
    object (LocalizedText)
  },
  "duration": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  }
}
Campos
distance

object (LocalizedText)

Se representa la distancia de viaje en forma de texto.

duration

object (LocalizedText)

Es el tiempo que se tiene en cuenta las condiciones de tráfico en el texto. Nota: Si no solicitaste información sobre el tráfico, este valor será el mismo que el valor estáticoDuration.

staticDuration

object (LocalizedText)

Es la duración sin considerar las condiciones del tráfico, representada en forma de texto.

Descripción general de los pasos

Proporciona información general sobre una lista de RouteLegStep.

Representación JSON
{
  "multiModalSegments": [
    {
      object (MultiModalSegment)
    }
  ]
}
Campos
multiModalSegments[]

object (MultiModalSegment)

Información resumida sobre diferentes segmentos multimodales de RouteLeg.steps. Este campo no se propaga si RouteLeg no contiene segmentos multimodales en los pasos.

Segmento modal múltiple

Proporciona información resumida sobre diferentes segmentos multimodales de RouteLeg.steps. Un segmento multimodal se define como uno o más RouteLegStep contiguos que tienen el mismo RouteTravelMode. Este campo no se propaga si RouteLeg no contiene segmentos multimodales en los pasos.

Representación JSON
{
  "navigationInstruction": {
    object (NavigationInstruction)
  },
  "travelMode": enum (RouteTravelMode),
  "stepStartIndex": integer,
  "stepEndIndex": integer
}
Campos
navigationInstruction

object (NavigationInstruction)

NavigationInstruction para el segmento multimodal.

travelMode

enum (RouteTravelMode)

El medio de transporte del segmento multimodal.

stepStartIndex

integer

El índice RouteLegStep correspondiente que es el inicio de un segmento multimodal.

stepEndIndex

integer

El índice RouteLegStep correspondiente que es el final de un segmento multimodal.

Viewport

Un viewport de latitud y longitud, representado como dos puntos diagonales low y high. Un viewport se considera una región cerrada, es decir, incluye su límite. Los límites de latitud deben oscilar entre -90 y 90 grados inclusive, y los de longitud deben oscilar entre -180 y 180 grados inclusive. Entre los casos, se incluyen los siguientes:

  • Si low = high, el viewport consta de ese punto único.

  • Si es low.longitude > high.longitude, se invierte el rango de longitud (el viewport cruza la línea de longitud de 180 grados).

  • Si low.longitude = -180 grados y high.longitude = 180 grados, el viewport incluirá todas las longitudes.

  • Si low.longitude = 180 grados y high.longitude = -180 grados, el rango de longitud está vacío.

  • Si es low.latitude > high.latitude, el rango de latitud está vacío.

low y high deben propagarse, y el cuadro representado no puede estar vacío (como se especifica en las definiciones anteriores). Un viewport vacío generará un error.

Por ejemplo, este viewport incluye la ciudad de Nueva York por completo:

{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }

Representación JSON
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
Campos
low

object (LatLng)

Obligatorio. Es el punto bajo del viewport.

high

object (LatLng)

Obligatorio. Es el punto alto del viewport.

Valores en ruta localizados

Representaciones de texto de determinadas propiedades.

Representación JSON
{
  "distance": {
    object (LocalizedText)
  },
  "duration": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  },
  "transitFare": {
    object (LocalizedText)
  }
}
Campos
distance

object (LocalizedText)

Se representa la distancia de viaje en forma de texto.

duration

object (LocalizedText)

Es la duración que se considera en las condiciones de tráfico, representada en forma de texto. Nota: Si no solicitaste información sobre el tráfico, este valor será el mismo que el valor estáticoDuration.

staticDuration

object (LocalizedText)

Es la duración sin considerar las condiciones del tráfico, representada en forma de texto.

transitFare

object (LocalizedText)

Tarifa de transporte público representada en un formulario de texto.

Resultados de Geocoding

Contiene GeocodedWaypoints para puntos de referencia de origen, destino e intermedio. Solo se propaga para los puntos de referencia de la dirección.

Representación JSON
{
  "origin": {
    object (GeocodedWaypoint)
  },
  "destination": {
    object (GeocodedWaypoint)
  },
  "intermediates": [
    {
      object (GeocodedWaypoint)
    }
  ]
}
Campos
origin

object (GeocodedWaypoint)

Punto de referencia con codificación geográfica de origen.

destination

object (GeocodedWaypoint)

Punto de referencia con codificación geográfica de destino.

intermediates[]

object (GeocodedWaypoint)

Una lista de puntos de referencia geocodificados intermedios que contienen un campo de índice que corresponde a la posición basada en cero del waypoint en el orden en que se especificaron en la solicitud.

Punto de referencia geocodificado

Detalles sobre las ubicaciones utilizadas como puntos de referencia. Solo se propaga para los puntos de referencia de la dirección. Incluye detalles sobre los resultados de geocodificación con el fin de determinar a qué se geocodifica la dirección.

Representación JSON
{
  "geocoderStatus": {
    object (Status)
  },
  "type": [
    string
  ],
  "partialMatch": boolean,
  "placeId": string,
  "intermediateWaypointRequestIndex": integer
}
Campos
geocoderStatus

object (Status)

Indica el código de estado que se genera a partir de la operación de geocodificación.

type[]

string

Los tipos del resultado, en forma de cero o más etiquetas de tipo. Tipos admitidos: https://developers.google.com/maps/documentation/Geocoding/requests-Geocoding#Types.

partialMatch

boolean

Indica que el geocodificador no mostró una coincidencia exacta para la solicitud original, aunque sí encontró una coincidencia parcial para la dirección solicitada. Te recomendamos que examines la solicitud original para comprobar que no haya errores ortográficos y que la dirección no esté incompleta.

placeId

string

El ID de lugar de este resultado.

intermediateWaypointRequestIndex

integer

El índice del waypoint intermedio correspondiente en la solicitud. Solo se propaga si el punto de referencia correspondiente es un punto de referencia intermedio.