Method: computeRoutes

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

NOTA: Este método requiere que especifiques una máscara de campo de respuesta en la entrada. Puedes proporcionar la máscara de campo de respuesta con el parámetro de URL $fields o fields, o bien con un encabezado HTTP/gRPC X-Goog-FieldMask (consulta los parámetros y encabezados de URL disponibles). El valor es una lista separada por comas de rutas de campo. Consulta la documentación detallada sobre cómo crear 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 la duración, la distancia y la polilínea a nivel de la ruta (una configuración de producción de ejemplo): X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline

Google no recomienda el uso de la máscara de campo de respuesta comodín (*) ni la especificación de la máscara de campo en el 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 de latencia estable. Podríamos agregar más campos de respuesta en el futuro, y esos campos nuevos pueden requerir tiempo de procesamiento adicional. Si seleccionas todos los campos, o bien todos los del nivel superior, es posible que experimentes una degradación del rendimiento, ya que cualquier campo nuevo que agreguemos se incluirá automáticamente en la respuesta.
  • Si seleccionas solo los campos que necesitas, el tamaño de respuesta será menor y, por lo tanto, una capacidad de procesamiento de red mayor.

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. Un conjunto de puntos de referencia a lo largo de la ruta (excluidos los puntos de terminal) para detenerse en o pasar. 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 demasiado larga, se muestra un error. Puedes especificar esta opción solo cuando travelMode es DRIVE o TWO_WHEELER; de lo contrario, la solicitud falla.

polylineQuality

enum (PolylineQuality)

Opcional. Especifica tu preferencia para 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, se establecerá de forma predeterminada la hora en la que realizaste la solicitud. NOTA: Solo puedes especificar un departureTime en el pasado cuando RouteTravelMode se establece en TRANSIT. Los viajes en transporte público están disponibles hasta 7 días en el pasado o 100 días en el futuro.

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. Indica la hora de llegada. NOTA: Solo se puede configurar cuando RouteTravelMode se configura como TRANSIT. Puedes especificar departureTime o arrivalTime, pero no ambos. Los viajes en transporte público están disponibles hasta 7 días en el pasado o 100 días en el futuro.

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. Es un conjunto de condiciones que se deben cumplir 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 Identificador de configuración regional de Unicode. Consulta Idiomas compatibles para ver la lista de idiomas compatibles. 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, consulta el artículo Dominios de nivel superior con código de país.

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 utilizadas para la ruta, el tramo, la distancia de paso y la duración no se ven afectadas por este valor. Si no proporcionas este valor, las unidades de visualización se infieren a partir de la ubicación del primer origen.

optimizeWaypointOrder

boolean

Opcional. Si se establece como verdadera, el servicio intenta minimizar el costo total de la ruta reordenando los puntos de referencia intermedios especificados. La solicitud falla si alguno de los puntos de referencia intermedios es 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 estableces optimizeWaypointOrder como falso, ComputeRoutesResponse.optimized_intermediate_waypoint_index estará vacío.

requestedReferenceRoutes[]

enum (ReferenceRoute)

Opcional. Especifica qué rutas de referencia se deben calcular como parte de la solicitud además de la ruta predeterminada. Una ruta de referencia es aquella con un objetivo de cálculo de ruta diferente al de la ruta predeterminada. Por ejemplo, un cálculo de ruta de referencia de FUEL_EFFICIENT tiene 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 deben especificarse en la máscara de campo para que se muestren en la respuesta.

trafficModel

enum (TrafficModel)

Opcional. Especifica las suposiciones que se usarán al calcular el tiempo en el 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 las solicitudes en las que se estableció RoutingPreference en TRAFFIC_AWARE_OPTIMAL y RouteTravelMode en DRIVE. El valor predeterminado 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 configura como 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 compute_alternatives_routes, y contiene solo una ruta cuando no lo haces. Cuando este array contiene varias entradas, la primera es la ruta más recomendada. Si el array está vacío, significa que 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 cálculo diferente. Cuando se usa el modo de resguardo, este campo contiene información detallada sobre la respuesta de resguardo. De lo contrario, no se establecerá este campo.

geocodingResults

object (GeocodingResults)

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

PolylineQuality

Es un conjunto de valores que especifican la calidad de la polilínea.

Enumeradores
POLYLINE_QUALITY_UNSPECIFIED No se especificó ninguna preferencia de calidad de polilínea. 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 mayor tamaño de la respuesta. Usa este valor cuando necesites más precisión.
OVERVIEW Especifica una polilínea de informació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.

PolylineEncoding

Especifica el tipo preferido de polilínea que se 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 especifican la unidad de medida que se usa en la pantalla.

Enumeradores
UNITS_UNSPECIFIED No se han especificado las unidades de medida. El valor predeterminado es la unidad de medida que se infiere de la solicitud.
METRIC Unidades de medida métricas.
IMPERIAL Unidades de medida imperiales (inglés).

ReferenceRoute

Una ruta de referencia compatible con ComputeRoutesRequest.

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

ExtraComputation

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 La información sobre los peajes de las rutas.
FUEL_CONSUMPTION Consumo de combustible estimado de la(s) ruta(s).
TRAFFIC_ON_POLYLINE Polilíneas con reconocimiento de tráfico para las rutas
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS NavigationInstructions presentada como una cadena de texto HTML con formato. El contenido se debe leer tal como está. Es solo para visualización. No la analices de manera programática.

Ruta

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

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)

Son las etiquetas de Route que son útiles para identificar propiedades específicas de la ruta y compararlas con otras.

legs[]

object (RouteLeg)

Conjunto de tramos (segmentos de ruta entre puntos de referencia) que conforman la ruta. Cada tramo corresponde al viaje entre dos Waypoints que no son 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)

Es la duración del viaje a través de 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 es 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 configuras optimizeWaypointOrder como verdadero, este campo contiene el orden optimizado de puntos de referencia intermedios. De lo contrario, este campo estará vacío. Por ejemplo, si proporcionas una entrada como Origen: LA; Puntos de referencia intermedios: Dallas, Bangor y Phoenix; Destino: Nueva York; y el orden optimizado de puntos de referencia intermedios es Phoenix, Dallas, Bangor, 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 de texto de las propiedades de Route.

routeToken

string

Un token de ruta seguro para la Web, codificado en base64 que se puede pasar al SDK de Navigation, que permite que este SDK reconstruya la ruta durante la navegación y, en caso de redirigir, respetar la intención original cuando creaste la ruta llamando a v2.computeRoutes. Los clientes deben tratar este token como un BLOB opaco. No está diseñado para leer ni mutar. NOTA: Route.route_token solo está disponible para las solicitudes que configuraron 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.

RouteLabel

Son las etiquetas de Route que son útiles para identificar propiedades específicas de la ruta y compararlas con otras.

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

RouteLeg

Contiene 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)
  },
  "localizedValues": {
    object (RouteLegLocalizedValues)
  },
  "stepsOverview": {
    object (StepsOverview)
  }
}
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)

Es la duración del viaje por el tramo, que se calcula 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)

Polilínea general de este segmento que incluye la polilínea de cada step

startLocation

object (Location)

La ubicación inicial de este tramo. Es posible que esta ubicación sea diferente de la origin proporcionada. 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. Es posible que esta ubicación sea diferente de la destination proporcionada. 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)

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

localizedValues

object (RouteLegLocalizedValues)

Representaciones de texto de las propiedades de RouteLeg.

stepsOverview

object (StepsOverview)

Descripción general sobre los pasos en esta RouteLeg. Este campo solo se propaga para las rutas TRANSIT.

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

Contiene 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)
  },
  "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 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)

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

localizedValues

object (RouteLegStepLocalizedValues)

Representaciones de texto de las propiedades de RouteLegStep.

transitDetails

object (RouteLegStepTransitDetails)

Son los detalles relacionados con este paso si el medio de transporte es TRANSIT.

travelMode

enum (RouteTravelMode)

Indica el medio de transporte utilizado en este paso.

Maneuver

Un conjunto de valores que especifican la acción de navegación que se realizará para el paso actual (por ejemplo, girar a la izquierda, combinar o seguir derecho).

Enumeradores
MANEUVER_UNSPECIFIED No se usa.
TURN_SLIGHT_LEFT Gira levemente hacia la izquierda.
TURN_SHARP_LEFT Gira totalmente hacia la izquierda.
UTURN_LEFT Gira en "U" hacia la izquierda.
TURN_LEFT Gira a la izquierda.
TURN_SLIGHT_RIGHT Gira levemente hacia la derecha.
TURN_SHARP_RIGHT Gira totalmente a la derecha.
UTURN_RIGHT Gira en "U" hacia la derecha.
TURN_RIGHT Gira a la derecha.
STRAIGHT Sigue derecho.
RAMP_LEFT Toma la rampa izquierda.
RAMP_RIGHT Toma la rampa derecha.
MERGE Combínalo con el tráfico.
FORK_LEFT Toma el tenedor izquierdo.
FORK_RIGHT Toma el tenedor derecho.
FERRY Toma el ferri.
FERRY_TRAIN Toma el tren que lleva al ferri.
ROUNDABOUT_LEFT Gira a la izquierda en la rotonda.
ROUNDABOUT_RIGHT Gira a la derecha en la rotonda.
DEPART Maniobra inicial.
NAME_CHANGE Se utiliza para indicar un cambio de nombre de calle.

RouteLegStepTravelAdvisory

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

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

object (SpeedReadingInterval)

NOTA: Este campo no está propagado actualmente.

RouteLegStepLocalizedValues

Representaciones de texto de determinadas propiedades.

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

object (LocalizedText)

Distancia de viaje representada en forma de texto.

staticDuration

object (LocalizedText)

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

RouteLegStepTransitDetails

Información adicional de RouteLegStep relacionada con las rutas 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)

Es la información sobre las paradas de llegada y salida del paso.

localizedValues

object (TransitDetailsLocalizedValues)

Representaciones de texto de las propiedades de RouteLegStepTransitDetails.

headsign

string

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

headway

string (Duration format)

Especifica la hora esperada como la duración entre las salidas desde la misma parada en este momento. Por ejemplo, con un valor de segundos entre 600, se espera una espera de diez minutos en caso de perder un autobús.

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

transitLine

object (TransitLine)

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

stopCount

integer

Es 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 parte de la parada A, pasa por las paradas B y C, y llega a la parada D, el valor de stopCount mostrará 3.

tripShortText

string

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

TransitStopDetails

Detalles sobre las paradas de transporte público del 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 para el paso.

arrivalTime

string (Timestamp format)

Es la hora estimada de llegada para el paso.

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)

Es la información sobre la parada de salida del paso.

departureTime

string (Timestamp format)

Es la hora estimada de salida para el paso.

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

TransitStop

Incluye información sobre una parada de transporte público.

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

string

Es el nombre de la parada de transporte público.

location

object (Location)

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

TransitDetailsLocalizedValues

Descripciones localizadas de valores de RouteTransitDetails

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

object (LocalizedTime)

Hora en la representación de texto con formato con la zona horaria correspondiente.

departureTime

object (LocalizedTime)

Hora en la representación de texto con formato con la zona horaria correspondiente.

LocalizedTime

Descripción localizada del tiempo

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

object (LocalizedText)

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

timeZone

string

Contiene la zona horaria. El valor es el nombre de la zona horaria según se define en la base de datos de zonas horarias de IANA, p.ej., “America/New_York”.

TransitLine

Contiene información sobre la línea de transporte público utilizada 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 opera esta línea de transporte público.

name

string

Es el nombre completo de esta línea de transporte público. Por ejemplo, "8 Avenue Local".

uri

string

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

color

string

Es el color que se usa comúnmente en la señalización de esta línea. Se representa en hexadecimal.

iconUri

string

El URI para el ícono asociado con esta línea.

nameShort

string

Es 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

Es el color que se usa comúnmente en el texto de la señalización para esta línea. Se representa en hexadecimal.

vehicle

object (TransitVehicle)

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

TransitAgency

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

Es el nombre de la empresa de transporte público.

phoneNumber

string

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

uri

string

Es el URI de la empresa de transporte público.

TransitVehicle

Es la información sobre un vehículo que se usa en las rutas de transporte público.

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

object (LocalizedText)

Es el nombre del vehículo, en mayúsculas.

type

enum (TransitVehicleType)

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

TransitVehicleType

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

Enumeradores
TRANSIT_VEHICLE_TYPE_UNSPECIFIED No se utiliza.
BUS Usuarios
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

RouteLegTravelAdvisory

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

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

object (TollInfo)

Contiene información sobre los peajes en el RouteLeg específico. Este campo solo se propaga si se prevé 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 el 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 RouteLeg 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).

RouteLegLocalizedValues

Representaciones de texto de determinadas propiedades.

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

object (LocalizedText)

Distancia de viaje representada en forma de texto.

duration

object (LocalizedText)

Es la duración que tiene en cuenta 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 destaticDuration.

staticDuration

object (LocalizedText)

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

StepsOverview

Proporciona información general sobre una lista de RouteLegStep.

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

object (MultiModalSegment)

Se resumió la información sobre diferentes segmentos multimodales del RouteLeg.steps. Este campo no se propaga si el elemento RouteLeg no contiene ningún segmento multimodal en los pasos.

MultiModalSegment

Proporciona información resumida sobre diferentes segmentos multimodales del 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 el elemento RouteLeg no contiene ningún segmento multimodal 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 viaje 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 por dos puntos low y high opuestos en diagonal. Una viewport se considera una región cerrada, es decir, incluye su límite. Los límites de latitud deben variar entre -90 y 90 grados inclusive, y los límites de longitud deben estar entre -180 y 180 grados inclusive. Se incluyen varios casos:

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

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

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

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

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

Tanto low como high deben completarse, 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 abarca por completo la ciudad de Nueva York:

{ "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 inferior del viewport.

high

object (LatLng)

Obligatorio. Es el punto más alto del viewport.

RouteLocalizedValues

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)

Distancia de viaje representada en forma de texto.

duration

object (LocalizedText)

Es la duración que tiene en cuenta 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 staticDuration.

staticDuration

object (LocalizedText)

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

transitFare

object (LocalizedText)

Tarifas de transporte público representadas en forma de texto

GeocodingResults

Contiene GeocodedWaypoints para puntos de referencia intermedios, de origen y de destino. Solo se completa 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 geocodificado de origen.

destination

object (GeocodedWaypoint)

Punto de referencia geocodificado de destino.

intermediates[]

object (GeocodedWaypoint)

Una lista de puntos de referencia con geocodificación intermedia, cada uno de los cuales contiene un campo de índice que corresponde a la posición con base cero del punto de referencia en el orden en el que se especificaron en la solicitud.

GeocodedWaypoint

Detalles sobre las ubicaciones utilizadas como puntos de referencia. Solo se completa para los puntos de referencia de la dirección. Incluye detalles acerca de los resultados de la geocodificación con el fin de determinar a qué se realizó la geocodificación de 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

Son los tipos del resultado, en forma de cero o más etiquetas de tipo. Tipos admitidos: Tipos de dirección y tipos de componentes de direcciones.

partialMatch

boolean

Indica que el geocodificador no devolvió 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

Es el ID de lugar de este resultado.

intermediateWaypointRequestIndex

integer

El índice del punto de referencia intermedio correspondiente en la solicitud. Solo se completa si el punto de referencia correspondiente es uno intermedio.