- Solicitud HTTP
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- PolylineQuality
- PolylineEncoding
- ReferenceRoute
- ExtraComputation
- RouteTokenOptions
- RouteTokenBehavior
- Ruta
- RouteLabel
- RouteLeg
- RouteLegStep
- NavigationInstruction
- Maniobra
- RouteLegStepTravelAdvisory
- RouteLegStepLocalizedValues
- RouteLegStepTransitDetails
- TransitStopDetails
- TransitStop
- TransitDetailsLocalizedValues
- LocalizedTime
- TransitLine
- TransitAgency
- TransitVehicle
- TransitVehicleType
- RouteLegTravelAdvisory
- RouteLegLocalizedValues
- StepsOverview
- MultiModalSegment
- Ventana gráfica
- RouteLocalizedValues
- RouteTokenUpdateFidelity
- PolylineDetails
- AltitudeInfo
- PolylinePointIndex
- IncidentInfo
- IncidentType
- SegmentInfo
- FerryInfo
- RoadFeatureState
- HighwayInfo
- TollInfo
- TunnelInfo
- VignetteInfo
- HovInfo
- RestrictionInfo
- PredictedSpeedInfo
- PredictedSpeedInterval
- GeocodingResults
- GeocodedWaypoint
Devuelve la ruta principal junto con rutas alternativas opcionales, según 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 con un encabezado HTTP/gRPC X-Goog-FieldMask
(consulta los parámetros y encabezados de URL disponibles). El valor es una lista de rutas de campo separadas por comas. Consulta la documentación detallada sobre cómo construir las rutas de los campos.
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 (un ejemplo de configuración de producción):
X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline
Google desaconseja 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 ahorrar ciclos de procesamiento, lo que nos permite mostrarte el resultado con una latencia más baja.
- Seleccionar solo los campos que necesitas para tu trabajo de producción garantiza un rendimiento de latencia estable. Es posible que agreguemos más campos de respuesta en el futuro, y esos campos nuevos podrían requerir tiempo de procesamiento adicional. Si seleccionas todos los campos o si lo haces en el nivel superior, es posible que experimentes una degradación del rendimiento, ya que los campos nuevos que agregues se incluirán automáticamente en la respuesta.
- Seleccionar solo los campos que necesitas da como resultado un tamaño de respuesta más pequeño 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 ( |
Campos | |
---|---|
origin |
Obligatorio. Punto de referencia de origen. |
destination |
Obligatorio. Punto de referencia de destino. |
intermediates[] |
Opcional. Un conjunto de puntos de referencia a lo largo de la ruta (sin incluir puntos de terminal), para parar en la ruta o pasar por ella. Se admiten hasta 25 puntos de referencia intermedios. |
travelMode |
Opcional. Especifica el medio de transporte. |
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 devuelve un error. Puedes especificar esta opción solo cuando |
polylineQuality |
Opcional. Especifica tu preferencia para la calidad de la polilínea. |
polylineEncoding |
Opcional. Especifica la codificación preferida para la polilínea. |
departureTime |
Opcional. Hora de salida. Si no estableces este valor, el valor predeterminado será la hora en que realizaste la solicitud. NOTA: Solo puedes especificar un Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
arrivalTime |
Opcional. Indica la hora de llegada. NOTA: Solo se puede configurar cuando Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
computeAlternativeRoutes |
Opcional. Especifica si se deben calcular rutas alternativas además de la ruta. No se devuelven rutas alternativas para las solicitudes que tienen puntos de referencia intermedios. |
routeModifiers |
Opcional. Un conjunto de condiciones que se deben cumplir y que afectan la forma en que se calculan las rutas. |
languageCode |
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 Unicode. Consulta Idiomas compatibles para obtener la lista de idiomas admitidos. Si no proporcionas este valor, el idioma de visualización se infiere de la ubicación de la solicitud de ruta. |
regionCode |
Opcional. Es 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 Dominios de nivel superior con códigos de país. |
units |
Opcional. Especifica las unidades de medida para los campos de visualización. Estos campos incluyen el campo |
optimizeWaypointOrder |
Opcional. Si se configura 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 un punto de referencia |
requestedReferenceRoutes[] |
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 una ruta con un objetivo de cálculo de ruta diferente al de la ruta predeterminada. Por ejemplo, un cálculo de ruta de referencia de |
extraComputations[] |
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. |
routeToken |
Opcional. Obsoleto: usa |
routeTokenOptions |
Opcional. Los tokens de ruta permiten que una solicitud dependa de una ruta seleccionada previamente. |
trafficModel |
Opcional. Especifica las suposiciones que se deben usar cuando se calcula el tiempo en el tráfico. Esta configuración afecta el valor que se muestra en el campo de duración de |
transitPreferences |
Opcional. Especifica las preferencias que influyen en la ruta que se muestra para las rutas |
navigationSessionId |
Opcional. Es el ID de sesión de navegación generado por el cliente que se usa para asociar esta solicitud de instrucciones sobre cómo llegar con los registros de navegación del cliente para el análisis de navegación. Debe ser un UUID que cumpla con RFC 4122 generado de forma aleatoria y que sea único para una sesión de navegación específica. |
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 ( |
Campos | |
---|---|
routes[] |
Contiene un array de rutas calculadas (hasta tres) cuando especificas |
fallbackInfo |
En algunos casos, cuando el servidor no puede procesar 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 |
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 tamaño de respuesta mayor. 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 . |
PolylineEncoding
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 GeoJSON |
ReferenceRoute
Una ruta de referencia compatible en ComputeRoutesRequest.
Enumeradores | |
---|---|
REFERENCE_ROUTE_UNSPECIFIED |
No se usa. Las solicitudes que contienen este valor fallan. |
FUEL_EFFICIENT |
Ruta con mayor ahorro de combustible. Se determina que las rutas etiquetadas con este valor están optimizadas en función de 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 |
Información sobre los peajes de las rutas. |
FUEL_CONSUMPTION |
Consumo de combustible estimado de las rutas. |
TRAFFIC_ON_POLYLINE |
Polilíneas adaptadas al tráfico para las rutas. |
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS |
NavigationInstructions se presenta como una cadena de texto HTML con formato. Este contenido se debe leer tal como está. Solo se puede mostrar. No lo analices de manera programática. |
PREDICTED_SPEED_ON_POLYLINE_20KPH_BUCKETS |
de 20 km/h de velocidad prevista. Resultados en los siguientes : [0, 10) km/h, [10, 30) km/h, ... [110, 130) km/h, [130, inf) km/h. |
PREDICTED_SPEED_ON_POLYLINE_10KPH_BUCKETS |
Buckets de velocidad prevista de 10 km/h. Resultados en los siguientes : [0, 10) km/h, [10, 20) km/h, ... [120, 130) km/h, [130, inf) km/h. |
RouteTokenOptions
Opciones relacionadas con los tokens de ruta.
Representación JSON |
---|
{
"routeToken": string,
"routeTokenBehavior": enum ( |
Campos | |
---|---|
routeToken |
Opcional. Si se establece, se genera una ruta "similar" a la asociada con el token, de ser posible. De todas formas, debes proporcionar los parámetros de consulta originales (p. ej., origen, destino, etcétera). |
routeTokenBehavior |
Opcional. Indica cómo tratar |
RouteTokenBehavior
Los modos admitidos para los tokens de ruta.
Enumeradores | |
---|---|
ROUTE_TOKEN_BEHAVIOR_UNSPECIFIED |
Se trata como GET_ROUTE_UPDATES para brindar compatibilidad. |
GET_ROUTE_UPDATES |
Si |origin| está en la ruta que representa routeToken , una de las rutas resultantes es la que representa routeToken . Las rutas restantes no están relacionadas. Las actualizaciones son más eficientes cuando |origin| está cerca del inicio de routeToken ; es decir, el usuario no se movió lejos de donde se generó routeToken . |
GET_SIMILAR_ROUTES |
La ruta que representa routeToken no se incluye en la respuesta, pero las otras rutas incluyen la similitud con routeToken como un factor de ponderación en su clasificación. |
Ruta
Contiene una ruta compuesta por una serie de tramos de ruta conectados que unen los puntos de referencia intermedios, de inicio y de finalización.
Representación JSON |
---|
{ "routeLabels": [ enum ( |
Campos | |
---|---|
routeLabels[] |
Las etiquetas de |
legs[] |
Conjunto de tramos (segmentos de trayectos entre puntos de referencia) que conforman la ruta. Cada tramo corresponde al viaje entre dos |
distanceMeters |
La distancia de viaje de la ruta en metros. |
duration |
Indica la cantidad de tiempo necesario para navegar por la ruta. Si configuras Una duración en segundos con hasta nueve dígitos decimales, que terminan en “ |
staticDuration |
La duración del viaje por la ruta sin tener en cuenta las condiciones del tráfico. Una duración en segundos con hasta nueve dígitos decimales, que terminan en “ |
polyline |
La polilínea de la ruta general Esta polilínea es la polilínea combinada de todos los elementos |
description |
Es una descripción de la ruta. |
warnings[] |
Array de advertencias que se mostrarán cuando se muestre la ruta. |
viewport |
El cuadro de límite del viewport de la polilínea. |
travelAdvisory |
Información adicional sobre la ruta. |
optimizedIntermediateWaypointIndex[] |
Si configuras |
localizedValues |
Representaciones de texto de propiedades de |
routeToken |
Es un token de ruta seguro para la Web y codificado en Base64 que se puede pasar al SDK de Navigation. Este le permite reconstruir la ruta durante la navegación y, en caso de una redirección, respetar la intención original cuando creaste la ruta llamando a v2.computeRoutes. Los clientes deben tratar este token como un BLOB opaco. No compares su valor entre solicitudes, ya que este token puede cambiar incluso si se devolvió exactamente la misma ruta. NOTA: |
routeTokenUpdateFidelity |
Para |
polylineDetails |
Contiene información sobre los detalles de la polilínea. |
RouteLabel
Las etiquetas de
que son útiles para identificar propiedades específicas de la ruta para compararlas con otras.Route
Enumeradores | |
---|---|
ROUTE_LABEL_UNSPECIFIED |
Predeterminado: sin usar. |
DEFAULT_ROUTE |
La “mejor” ruta predeterminada que se muestra para el cálculo de la ruta. |
DEFAULT_ROUTE_ALTERNATE |
Una alternativa a la “mejor” ruta predeterminada. Se mostrarán rutas como esta cuando se especifique . |
FUEL_EFFICIENT |
Ruta con mayor ahorro de combustible. Se determina que las rutas etiquetadas con este valor están optimizadas en función de los parámetros Eco, como el consumo de combustible. |
RouteLeg
Contiene un segmento entre puntos de referencia que no son via
.
Representación JSON |
---|
{ "distanceMeters": integer, "duration": string, "staticDuration": string, "polyline": { object ( |
Campos | |
---|---|
distanceMeters |
La distancia de viaje del tramo de la ruta, en metros. |
duration |
Es la cantidad de tiempo necesario para navegar por el tramo. Si Una duración en segundos con hasta nueve dígitos decimales, que terminan en “ |
staticDuration |
Es la duración del viaje a través del tramo, que se calcula sin considerar las condiciones del tráfico. Una duración en segundos con hasta nueve dígitos decimales, que terminan en “ |
polyline |
Es la polilínea general de este segmento que incluye la polilínea de cada |
startLocation |
Es la ubicación inicial de este segmento. Esta ubicación puede ser diferente de la |
endLocation |
Es la ubicación final de esta etapa. Esta ubicación puede ser diferente de la |
steps[] |
Array de pasos que denotan segmentos dentro de esta etapa. Cada paso representa una instrucción de navegación. |
travelAdvisory |
Contiene la información adicional que se debe informar al usuario, como posibles restricciones en una zona de tráfico, en un tramo de la ruta. |
localizedValues |
Representaciones de texto de propiedades de |
stepsOverview |
Información general sobre los pasos en este |
RouteLegStep
Contiene un segmento de un
. Un paso corresponde a una sola instrucción de navegación. Los tramos de la ruta constan de escalones.RouteLeg
Representación JSON |
---|
{ "distanceMeters": integer, "staticDuration": string, "polyline": { object ( |
Campos | |
---|---|
distanceMeters |
La distancia de viaje de este paso, en metros. En algunas circunstancias, es posible que este campo no tenga un valor. |
staticDuration |
Es la duración del recorrido en 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 hasta nueve dígitos decimales, que terminan en “ |
polyline |
La polilínea asociada con este paso. |
startLocation |
Es la ubicación de inicio de este paso. |
endLocation |
Es la ubicación final de este paso. |
navigationInstruction |
Instrucciones de navegación. |
travelAdvisory |
Contiene la información adicional que se debe informar al usuario, como posibles restricciones en una zona de tráfico, sobre un paso de una etapa. |
localizedValues |
Representaciones de texto de propiedades de |
transitDetails |
Son los detalles relacionados con este paso si el medio de transporte es |
travelMode |
Indica el medio de transporte utilizado para este paso. |
Maneuver
Es un conjunto de valores que especifican la acción de navegación que se debe realizar para el paso actual (por ejemplo, girar a la izquierda, fusionar o derecha).
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 pronunciadamente a la derecha. |
UTURN_RIGHT |
Haz un giro en U hacia la derecha. |
TURN_RIGHT |
Gira a la derecha. |
STRAIGHT |
Sigue derecho. |
RAMP_LEFT |
Toma la rampa de la izquierda. |
RAMP_RIGHT |
Toma la rampa de la derecha. |
MERGE |
Incorpore en el tráfico. |
FORK_LEFT |
Toma la bifurcación izquierda. |
FORK_RIGHT |
Usa el tenedor correcto. |
FERRY |
Toma el transbordador. |
FERRY_TRAIN |
Toma el tren que te lleva al ferri. |
ROUNDABOUT_LEFT |
Dobla a la izquierda en la rotonda. |
ROUNDABOUT_RIGHT |
Dobla a la derecha en la rotonda. |
DEPART |
Maniobra inicial. |
NAME_CHANGE |
Se usa para indicar un cambio en el nombre de la calle. |
RouteLegStepTravelAdvisory
Contiene la información adicional sobre la que se debe informar al usuario, como posibles restricciones en una zona de tráfico para un paso de una etapa.
Representación JSON |
---|
{
"speedReadingIntervals": [
{
object ( |
Campos | |
---|---|
speedReadingIntervals[] |
NOTA: Este campo no está propagado por el momento. |
RouteLegStepLocalizedValues
Representaciones de texto de ciertas propiedades.
Representación JSON |
---|
{ "distance": { object ( |
Campos | |
---|---|
distance |
Distancia de viaje representada en forma de texto. |
staticDuration |
Es la duración sin tener en cuenta las condiciones del tráfico, representada con formato de texto. |
RouteLegStepTransitDetails
Información adicional para el RouteLegStep
relacionado con las rutas TRANSIT
.
Representación JSON |
---|
{ "stopDetails": { object ( |
Campos | |
---|---|
stopDetails |
Información sobre las paradas de llegada y salida del paso. |
localizedValues |
Representaciones de texto de propiedades de |
headsign |
Especifica la dirección hacia la cual viajar en esta línea, según lo marcado en el vehículo o en la parada de salida. A menudo, la dirección es la estación terminal. |
headway |
Especifica la hora prevista como un período entre salidas desde la misma parada en este momento. Por ejemplo, con un valor de 600 en segundos entre viajes, se espera una espera de diez minutos en caso de perder un autobús. Una duración en segundos con hasta nueve dígitos decimales, que terminan en “ |
transitLine |
Información sobre la línea de transporte público que se usa en este paso. |
stopCount |
La cantidad de paradas desde la salida hasta la 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 devolverá 3. |
tripShortText |
Es el texto que aparece en los horarios y carteles para identificar un viaje en transporte público para los pasajeros. El texto debe identificar de manera exclusiva un viaje durante un día de servicio. Por ejemplo, "538" es el |
TransitStopDetails
Detalles acerca de las paradas del transporte público del RouteLegStep
Representación JSON |
---|
{ "arrivalStop": { object ( |
Campos | |
---|---|
arrivalStop |
Información sobre la parada de llegada del paso. |
arrivalTime |
Es la hora estimada de llegada del paso. Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
departureStop |
Información sobre la parada de salida del paso. |
departureTime |
La hora estimada de salida del paso. Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
TransitStop
Información sobre una parada de transporte público.
Representación JSON |
---|
{
"name": string,
"location": {
object ( |
Campos | |
---|---|
name |
El nombre de la parada de transporte público. |
location |
Es la ubicación de la parada expresada en coordenadas de latitud y longitud. |
TransitDetailsLocalizedValues
Descripciones localizadas de los valores de RouteTransitDetails
.
Representación JSON |
---|
{ "arrivalTime": { object ( |
Campos | |
---|---|
arrivalTime |
La hora en su representación de texto con formato y en la zona horaria correspondiente. |
departureTime |
La hora en su representación de texto con formato y en la zona horaria correspondiente. |
LocalizedTime
Descripción localizada del tiempo.
Representación JSON |
---|
{
"time": {
object ( |
Campos | |
---|---|
time |
La hora especificada como cadena en una zona horaria determinada. |
timeZone |
Contiene la zona horaria. El valor es el nombre de la zona horaria como se define en la base de datos de zonas horarias de IANA, p.ej., "America/New_York". |
TransitLine
Contiene información acerca de la línea de transporte público que se usa en este paso.
Representación JSON |
---|
{ "agencies": [ { object ( |
Campos | |
---|---|
agencies[] |
Es la empresa (o empresas) de transporte público que opera esta línea de transporte público. |
name |
El nombre completo de esta línea de transporte público, por ejemplo, “Local 8 Avenue”. |
uri |
Es el URI de esta línea de transporte público proporcionado por la empresa de transporte público. |
color |
El color que se usa comúnmente en la señalización de esta línea. Se representa en hexadecimal. |
iconUri |
El URI para el ícono asociado con esta línea. |
nameShort |
Es el nombre corto de esta línea de transporte público. Normalmente, será un número de línea, como "M7" o "355". |
textColor |
El color que se usa comúnmente en el texto de la señalización para esta línea. Se representa en hexadecimal. |
vehicle |
Es 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 |
Es el nombre de esta empresa de transporte público. |
phoneNumber |
Es el número de teléfono con formato específico para la configuración regional de la empresa de transporte público. |
uri |
Es el URI de la empresa de transporte público. |
TransitVehicle
Información sobre un vehículo utilizado en rutas de transporte público.
Representación JSON |
---|
{ "name": { object ( |
Campos | |
---|---|
name |
El nombre de este vehículo en mayúsculas. |
type |
El tipo de vehículo que se usa |
iconUri |
El URI de un ícono asociado a este tipo de vehículo. |
localIconUri |
Es el URI del ícono asociado con este tipo de vehículo, según la señalización de transporte local. |
TransitVehicleType
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 |
RouteLegTravelAdvisory
Contiene la información adicional sobre la que se debe informar al usuario sobre un paso de la etapa, como posibles restricciones en la zona de tráfico.
Representación JSON |
---|
{ "tollInfo": { object ( |
Campos | |
---|---|
tollInfo |
Contiene información sobre los peajes de un |
speedReadingIntervals[] |
Intervalos de lectura de velocidad que detallan la densidad del tráfico Se aplica en el caso de las preferencias de enrutamiento de Ejemplo:
|
RouteLegLocalizedValues
Representaciones de texto de ciertas propiedades.
Representación JSON |
---|
{ "distance": { object ( |
Campos | |
---|---|
distance |
Distancia de viaje representada en forma de texto. |
duration |
Es la duración en la que se consideran las condiciones del tráfico, representadas en formato de texto. Nota: Si no solicitaste información sobre el tráfico, este valor será el mismo que el de dynamicDuration. |
staticDuration |
Es la duración sin tener en cuenta las condiciones del tráfico, representada con formato de texto. |
StepsOverview
Proporciona información general sobre una lista de RouteLegStep
.
Representación JSON |
---|
{
"multiModalSegments": [
{
object ( |
Campos | |
---|---|
multiModalSegments[] |
Se resumió la información sobre diferentes segmentos multimodales de |
MultiModalSegment
Proporciona información resumida sobre diferentes segmentos multimodales de RouteLeg.steps
. Un segmento multimodal se define como una o más RouteLegStep
contiguas que tienen el mismo RouteTravelMode
. Este campo no se completa si la RouteLeg
no contiene ningún segmento multimodal en los pasos.
Representación JSON |
---|
{ "navigationInstruction": { object ( |
Campos | |
---|---|
navigationInstruction |
NavigationInstruction para el segmento multimodal. |
travelMode |
Indica el medio de transporte del segmento multimodal. |
stepStartIndex |
El índice |
stepEndIndex |
El índice |
Viewport
Un viewport de latitud y longitud, representado por dos puntos low
y high
opuestos en diagonal. 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 límites de longitud deben oscilar entre -180 y 180 grados inclusive. Varios casos incluyen los siguientes:
Si
low
=high
, el viewport consta de ese solo 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 yhigh.longitude
= 180 grados, el viewport incluye todas las longitudes.Si
low.longitude
= 180 grados yhigh.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
se deben completar, y el cuadro representado no puede estar vacío (como se especifica en las definiciones anteriores). Si el viewport está vacío, se producirá 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 ( |
Campos | |
---|---|
low |
Obligatorio. Es el punto inferior del viewport. |
high |
Obligatorio. Es el punto superior del viewport. |
RouteLocalizedValues
Representaciones de texto de ciertas propiedades.
Representación JSON |
---|
{ "distance": { object ( |
Campos | |
---|---|
distance |
Distancia de viaje representada en forma de texto. |
duration |
Es la duración en la que se tienen en cuenta las condiciones del tráfico, representada en forma de texto. Nota: Si no solicitaste información sobre el tráfico, este valor será el mismo que el de |
staticDuration |
Es la duración sin tener en cuenta las condiciones del tráfico, representada con formato de texto. |
transitFare |
Tarifa de transporte público representada en forma de texto |
RouteTokenUpdateFidelity
Para las solicitudes que usan routeTokenBehavior
GET_ROUTE_UPDATES
, identifica las rutas construidas a partir del routeToken asociado. (No se relaciona con las routeToken
de este mensaje).
Enumeradores | |
---|---|
ROUTE_TOKEN_UPDATE_FIDELITY_UNSPECIFIED |
Esta ruta no se generó a partir de un token de ruta. |
APPROXIMATE |
Esta ruta se reconstruyó a partir de un token de ruta y es lógicamente equivalente, pero la geometría de la ruta no es idéntica. |
IDENTICAL |
Esta ruta es geométricamente idéntica a un token de ruta. |
PolylineDetails
Detalles correspondientes a un índice determinado o a un segmento contiguo de una polilínea Dada una polilínea con puntos P_0, P_1, ... , P_N (índice basado en cero), PolylineDetails
define un intervalo y los metadatos asociados.
Representación JSON |
---|
{ "altitudeInfo": [ { object ( |
Campos | |
---|---|
altitudeInfo[] |
Detalles de la altitud junto a la polilínea |
incidentInfo[] |
Detalles de incidentes junto a la polilínea |
segmentInfo[] |
Detalles del segmento a lo largo de la polilínea |
ferryInfo[] |
Detalles del transbordador junto a la polilínea Este campo solo se propaga si una solicitud especifica el modificador de ruta |
highwayInfo[] |
Detalles de las autopistas junto a la polilínea Este campo solo se propaga si una solicitud especifica el modificador de ruta |
tollInfo[] |
Detalles de los peajes de la polilínea Este campo solo se propaga si una solicitud especifica el modificador de ruta |
tunnelInfo[] |
Detalles del túnel junto a la polilínea Este campo solo se propaga si una solicitud especifica el modificador de ruta |
vignetteInfo[] |
Detalles de la viñeta junto a la polilínea Este campo solo se propaga si una solicitud especifica el modificador de ruta |
hovInfo[] |
Detalles de Hov junto a la polilínea Este campo solo se propaga si una solicitud especifica el modificador de ruta |
restrictionInfo[] |
Detalles de las restricciones junto con la polilínea Este campo solo se propaga si una solicitud especifica el modificador de ruta |
predictedSpeeds[] |
Intervalos de velocidad previstos a lo largo de la polilínea |
AltitudeInfo
Encapsula información sobre la altitud junto a la polilínea.
Representación JSON |
---|
{
"polylinePointIndex": {
object ( |
Campos | |
---|---|
polylinePointIndex |
Es la ubicación de la medición de altitud en la polilínea. |
altitudeMeters |
La altitud en metros en relación con el elipsoide WGS-84. |
PolylinePointIndex
Encapsula los índices de inicio y finalización para obtener un detalle de polilínea. En instancias en las que los datos corresponden a un solo punto, startIndex
y endIndex
serán iguales.
Representación JSON |
---|
{ "startIndex": integer, "endIndex": integer } |
Campos | |
---|---|
startIndex |
Es el índice de inicio de este detalle en la polilínea. |
endIndex |
Es el índice final de este detalle en la polilínea. |
IncidentInfo
Encapsula información sobre un incidente en la polilínea.
Representación JSON |
---|
{ "incidentType": enum ( |
Campos | |
---|---|
incidentType |
El tipo de incidente. |
estimatedDelay |
Retraso estimado en relación con el tiempo de recorrido normal. Solo se devuelve por INCIDENT_JAM. Una duración en segundos con hasta nueve dígitos decimales, que terminan en “ |
polylinePointIndex |
La ubicación del incidente en la polilínea. |
IncidentType
Los tipos de incidentes.
Enumeradores | |
---|---|
INCIDENT_TYPE_UNSPECIFIED |
Valor predeterminado Este valor no se usa. |
INCIDENT_ROAD_CLOSED |
Una ruta cerrada. |
INCIDENT_CRASH |
Un accidente. |
INCIDENT_CONSTRUCTION |
Construcción. |
INCIDENT_JAM |
Embotellamiento |
SegmentInfo
Encapsula información sobre segmentos a lo largo de la polilínea.
Representación JSON |
---|
{
"placeId": string,
"polylinePointIndex": {
object ( |
Campos | |
---|---|
placeId |
El ID de lugar de este tramo de ruta. |
polylinePointIndex |
Ubicación del tramo a lo largo de la polilínea. |
FerryInfo
Encapsula información sobre ferris a lo largo de la polilínea.
Representación JSON |
---|
{ "ferryPresence": enum ( |
Campos | |
---|---|
ferryPresence |
Solo salida. Indica si existe un transbordador para un tramo determinado de la polilínea. |
polylinePointIndex |
La ubicación de la información relacionada con el transbordador junto a la polilínea. |
RoadFeatureState
Encapsula los estados de los componentes de rutas (p.ej., autopistas, transbordadores, etc.) a lo largo de un tramo de polilínea.
Enumeradores | |
---|---|
ROAD_FEATURE_STATE_UNSPECIFIED |
No se calculó el estado de la característica de la ruta (valor predeterminado). |
EXISTS |
Existe la característica de la ruta. |
DOES_NOT_EXIST |
El elemento de la ruta no existe. |
HighwayInfo
Encapsula información sobre autopistas a lo largo de la polilínea.
Representación JSON |
---|
{ "highwayPresence": enum ( |
Campos | |
---|---|
highwayPresence |
Solo salida. Indica si existe una autopista para un determinado tramo de la polilínea. |
polylinePointIndex |
Es la ubicación de la información relacionada con carreteras junto a la polilínea. |
TollInfo
Encapsula información sobre peajes a lo largo de la polilínea.
Representación JSON |
---|
{ "tollPresence": enum ( |
Campos | |
---|---|
tollPresence |
Solo salida. Indica si existe un peaje para un tramo determinado de la polilínea. |
polylinePointIndex |
Es la ubicación de información relacionada con los peajes en la polilínea. |
TunnelInfo
Encapsula información sobre túneles a lo largo de la polilínea.
Representación JSON |
---|
{ "tunnelPresence": enum ( |
Campos | |
---|---|
tunnelPresence |
Solo salida. Indica si existe un túnel para un tramo determinado de la polilínea. |
polylinePointIndex |
La ubicación de la información relacionada con el túnel a lo largo de la polilínea. |
VignetteInfo
Encapsula información sobre las viñetas en la polilínea.
Representación JSON |
---|
{ "vignettePresence": enum ( |
Campos | |
---|---|
vignettePresence |
Solo salida. Indica si existe una viñeta para un tramo determinado de la polilínea. |
polylinePointIndex |
Es la ubicación de la información relacionada con las viñetas en la polilínea. |
HovInfo
Encapsula información sobre segmentos o carriles VAO a lo largo de la polilínea.
Representación JSON |
---|
{ "hovPresence": enum ( |
Campos | |
---|---|
hovPresence |
Solo salida. Indica si existe una ruta o carril para VAO en un tramo determinado de la polilínea. |
polylinePointIndex |
Es la ubicación de información relacionada con VAO en la polilínea. |
RestrictionInfo
Encapsula información sobre varias restricciones a lo largo de la polilínea.
Representación JSON |
---|
{ "restrictionPresence": enum ( |
Campos | |
---|---|
restrictionPresence |
Solo salida. Indica si existe una restricción para un tramo determinado de la polilínea. |
polylinePointIndex |
Es la ubicación de información relacionada con restricciones en la polilínea. |
Campo de unión restriction . Encapsula los tipos de restricciones que pueden aplicarse a un tramo determinado de la polilínea. Las direcciones (restriction ) solo pueden ser una de las siguientes opciones: |
|
restrictedHeightMm |
El límite de altura en milímetros. Este campo se completa cuando la altura restringida impide el paso o genera una baja liberación para el vehículo especificado. |
PredictedSpeedInfo
Encapsula información sobre las velocidades previstas en la polilínea.
Representación JSON |
---|
{ "predictedSpeedInterval": { object ( |
Campos | |
---|---|
predictedSpeedInterval |
El rango de velocidades previstas en esta parte de la polilínea. |
polylinePointIndex |
Ubicación del intervalo de velocidad previsto en la polilínea. |
PredictedSpeedInterval
Intervalo de velocidad previsto y flexible, que representa las velocidades de [lowerBoundKphInclusive
, upperBoundKphExclusive
). Los intervalos que se muestran dependen de los valores de
especificados en la solicitud.extraComputations
Representación JSON |
---|
{ "lowerBoundKphInclusive": integer, "upperBoundKphExclusive": integer } |
Campos | |
---|---|
lowerBoundKphInclusive |
Límite inferior inclusivo. |
upperBoundKphExclusive |
Límite superior exclusivo. Representa el infinito cuando no se propaga. |
GeocodingResults
Contiene
para los puntos de referencia intermedios, de origen y de destino. Solo se completa para los puntos de referencia de direcciones.GeocodedWaypoints
Representación JSON |
---|
{ "origin": { object ( |
Campos | |
---|---|
origin |
Punto de referencia geocodificado de origen. |
destination |
Punto de referencia geocodificado de destino. |
intermediates[] |
Una lista de waypoints intermedios geocodificados, cada uno de los cuales contiene un campo de índice que corresponde a la posición basada en cero del punto de referencia en el orden en 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 direcciones. Incluye información detallada sobre los resultados de geocodificación para determinar a qué dirección se realizó la geocodificación.
Representación JSON |
---|
{
"geocoderStatus": {
object ( |
Campos | |
---|---|
geocoderStatus |
Indica el código de estado que se genera a partir de la operación de geocodificación. |
type[] |
Los tipos del resultado, con formato de cero o más etiquetas de tipo. Tipos admitidos: Tipos de dirección y tipos de componentes de dirección. |
partialMatch |
Indica que el geocodificador no devolvió una coincidencia exacta para la solicitud original, aunque sí pudo establecer 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 |
Es el ID de lugar de este resultado. |
intermediateWaypointRequestIndex |
El índice del punto de referencia intermedio correspondiente en la solicitud. Solo se completa si el punto de referencia correspondiente es un punto de referencia intermedio. |