- Solicitud HTTP
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Calidad de las polilíneas
- PolylineEncoding
- Unidades
- Referencia
- Procesamiento adicional
- Ruta
- RouteLabel.
- RouteLeg
- Polilínea
- RouteLegStep
- NavigationInstruction
- Manufactura
- RouteLegStepTravelAdvisory
- RouteLegStepLocalizedValues
- RouteLegStepTransitDetails
- TransitStopDetails
- TransitStop
- TransitDetailsLocalizedValues
- LocalizedTime
- TransitLine
- TransitAgency
- TransitVehicle
- TransitVehicleType.
- RouteLegTravelAdvisory
- RouteLegLocalizedValues
- Descripción general de los pasos
- MultiModalSegment
- Ventana de visualización
- RouteLocalizedValues
- GeocodingResults
- GeocodedWaypoint
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 ( |
Campos | |
---|---|
origin |
Obligatorio. Punto de referencia de origen. |
destination |
Obligatorio. Punto de referencia de destino. |
intermediates[] |
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 |
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 extra larga, se muestra un error. Puedes especificar esta opción solo cuando |
polylineQuality |
Opcional. Especifica tu preferencia por la calidad de la polilínea. |
polylineEncoding |
Opcional. Especifica la codificación preferida para la polilínea. |
departureTime |
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 Es una marca de tiempo en formato RFC3339 UTC “Zulú”, con resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
arrivalTime |
Opcional. La hora de llegada. NOTA: Solo se puede establecer cuando Es una marca de tiempo en formato RFC3339 UTC “Zulú”, con 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 muestran rutas alternativas para las solicitudes que tienen puntos de referencia intermedios. |
routeModifiers |
Opcional. Un conjunto de condiciones que se deben satisfacer 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 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 |
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 |
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 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 |
requestedReferenceRoutes[] |
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 |
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. |
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 |
transitPreferences |
Opcional. Especifica las preferencias que influyen en la ruta que se muestra para las rutas |
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 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 |
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 |
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 ( |
Campos | |
---|---|
routeLabels[] |
Etiquetas de |
legs[] |
Es un conjunto de etapas (segmentos de ruta entre puntos de referencia) que conforman la ruta. Cada etapa corresponde al viaje entre dos |
distanceMeters |
Indica la distancia de viaje de la ruta, en metros. |
duration |
Indica el tiempo necesario para navegar por la ruta. Si configuras Una duración en segundos con un máximo de 9 dígitos decimales, que termina en ' |
staticDuration |
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 ' |
polyline |
La polilínea general de la ruta Esta polilínea es la polilínea combinada de todo |
description |
Es una descripción de la ruta. |
warnings[] |
Es un array de advertencias que se muestran cuando se muestra la ruta. |
viewport |
Cuadro de límite del viewport de la polilínea |
travelAdvisory |
Información adicional sobre la ruta. |
optimizedIntermediateWaypointIndex[] |
Si configuras |
localizedValues |
Representaciones en el texto de las propiedades de |
routeToken |
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: |
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 ( |
Campos | |
---|---|
distanceMeters |
La distancia de viaje del tramo de ruta, en metros. |
duration |
El tiempo necesario para navegar por el tramo. Si Una duración en segundos con un máximo de 9 dígitos decimales, que termina en ' |
staticDuration |
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 ' |
polyline |
La polilínea general de esta etapa que incluye la polilínea de cada |
startLocation |
Es la ubicación de inicio de este segmento. Es posible que esta ubicación sea diferente de la |
endLocation |
Es la ubicación final de este segmento. Es posible que esta ubicación sea diferente de la |
steps[] |
Es un array de pasos que denotan segmentos dentro de este segmento. Cada paso representa una instrucción de navegación. |
travelAdvisory |
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 |
Representaciones en el texto de las propiedades de |
stepsOverview |
Obtén una descripción general de los pasos de este |
Polilínea
Encapsula una polilínea codificada.
Representación JSON |
---|
{ // Union field |
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 |
La codificación de string de la polilínea mediante el algoritmo de codificación de polilínea |
geoJsonLinestring |
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 ( |
Campos | |
---|---|
distanceMeters |
La distancia de viaje de este paso, en metros. En algunas circunstancias, es posible que este campo no tenga un valor. |
staticDuration |
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 ' |
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 sobre la que se debe informar al usuario, como una posible restricción de zona de tráfico, en un paso determinado. |
localizedValues |
Representaciones en el texto de las propiedades de |
transitDetails |
Los detalles correspondientes a este paso si el medio de transporte es |
travelMode |
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 ( |
Campos | |
---|---|
speedReadingIntervals[] |
NOTA: Actualmente, este campo no se propaga. |
Valores localizados de la ruta
Representaciones de texto de determinadas propiedades.
Representación JSON |
---|
{ "distance": { object ( |
Campos | |
---|---|
distance |
Se representa la distancia de viaje en forma de texto. |
staticDuration |
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 ( |
Campos | |
---|---|
stopDetails |
Información sobre las paradas de llegada y salida del paso. |
localizedValues |
Representaciones en el texto de las propiedades de |
headsign |
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 |
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 ' |
transitLine |
Información sobre la línea de transporte público que se usa en este paso. |
stopCount |
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 |
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 |
Detalles de la parada de transporte público
Detalles sobre las paradas del transporte público para el RouteLegStep
Representación JSON |
---|
{ "arrivalStop": { object ( |
Campos | |
---|---|
arrivalStop |
Información sobre la parada de llegada del paso. |
arrivalTime |
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: |
departureStop |
Información sobre la parada de salida del paso. |
departureTime |
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: |
Parada de transporte público
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 |
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 ( |
Campos | |
---|---|
arrivalTime |
La hora en la representación de texto con formato con la zona horaria correspondiente |
departureTime |
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 ( |
Campos | |
---|---|
time |
La hora especificada como una string en una zona horaria determinada. |
timeZone |
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 ( |
Campos | |
---|---|
agencies[] |
La empresa o las empresas de transporte público que operan esta línea de transporte público. |
name |
El nombre completo de esta línea de transporte público, por ejemplo, "Local de 8 Avenida". |
uri |
el URI de esta línea tal como la proporciona la empresa de transporte público. |
color |
El color que se usa comúnmente para la señalización de esta línea Representado en hexadecimal. |
iconUri |
Es el URI del ícono asociado con esta línea. |
nameShort |
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 |
El color que se usa comúnmente en el texto de la señalización de esta línea Representado en hexadecimal. |
vehicle |
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 |
El nombre de la empresa de transporte público. |
phoneNumber |
El número de teléfono con formato específico de la configuración regional de la empresa de transporte público. |
uri |
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 ( |
Campos | |
---|---|
name |
El nombre de este vehículo, en mayúsculas. |
type |
Es el tipo de vehículo que se usa. |
iconUri |
Es el URI de un ícono asociado con 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. |
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 ( |
Campos | |
---|---|
tollInfo |
Contiene información sobre los peajes de la |
speedReadingIntervals[] |
Intervalos de lectura de velocidad que detallan la densidad del tráfico Se aplica en el caso de las preferencias de enrutamiento Ejemplo:
|
Valores localizados de la ruta
Representaciones de texto de determinadas propiedades.
Representación JSON |
---|
{ "distance": { object ( |
Campos | |
---|---|
distance |
Se representa la distancia de viaje en forma de texto. |
duration |
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 |
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 ( |
Campos | |
---|---|
multiModalSegments[] |
Información resumida sobre diferentes segmentos multimodales de |
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 ( |
Campos | |
---|---|
navigationInstruction |
NavigationInstruction para el segmento multimodal. |
travelMode |
El medio de transporte del segmento multimodal. |
stepStartIndex |
El índice |
stepEndIndex |
El índice |
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 yhigh.longitude
= 180 grados, el viewport incluirá todas las longitudes.Si
low.longitude
= 180 grados yhigh.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 ( |
Campos | |
---|---|
low |
Obligatorio. Es el punto bajo del viewport. |
high |
Obligatorio. Es el punto alto del viewport. |
Valores en ruta localizados
Representaciones de texto de determinadas propiedades.
Representación JSON |
---|
{ "distance": { object ( |
Campos | |
---|---|
distance |
Se representa la distancia de viaje en forma de texto. |
duration |
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 |
Es la duración sin considerar las condiciones del tráfico, representada en forma de texto. |
transitFare |
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 ( |
Campos | |
---|---|
origin |
Punto de referencia con codificación geográfica de origen. |
destination |
Punto de referencia con codificación geográfica de destino. |
intermediates[] |
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 ( |
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, en forma de cero o más etiquetas de tipo. Tipos admitidos: https://developers.google.com/maps/documentation/Geocoding/requests-Geocoding#Types. |
partialMatch |
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 |
El ID de lugar de este resultado. |
intermediateWaypointRequestIndex |
El índice del waypoint intermedio correspondiente en la solicitud. Solo se propaga si el punto de referencia correspondiente es un punto de referencia intermedio. |