- Solicitud HTTP
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- PolylineQuality
- PolylineEncoding
- Unidades
- ReferenceRoute
- ExtraComputation
- Ruta
- RouteLabel
- RouteLeg
- Polilínea
- RouteLegStep
- NavigationInstruction
- Maniobra
- RouteLegStepTravelAdvisory
- RouteLegStepLocalizedValues
- RouteLegStepTransitDetails
- TransitStopDetails
- TransitStop
- TransitDetailsLocalizedValues
- LocalizedTime
- TransitLine
- TransitAgency
- TransitVehicle
- TransitVehicleType
- RouteLegTravelAdvisory
- RouteLegLocalizedValues
- StepsOverview
- MultiModalSegment
- Ventana gráfica
- RouteLocalizedValues
- GeocodingResults
- GeocodedWaypoint
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 ( |
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 (excluidos los puntos de terminal) para detenerse en o pasar. 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 muestra 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. 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 Una marca de tiempo en formato RFC3339 UTC "Zulú", con 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 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. Es 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 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 |
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 |
Opcional. Especifica las unidades de medida para los campos de visualización. Estos campos incluyen el campo |
optimizeWaypointOrder |
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 |
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 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 |
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 deben especificarse en la máscara de campo para que se muestren en la respuesta. |
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 |
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 |
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 |
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 ( |
Campos | |
---|---|
routeLabels[] |
Son las etiquetas de |
legs[] |
Conjunto de tramos (segmentos de ruta 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 |
El tiempo necesario para navegar por la ruta. Si configuras Es una duración en segundos con hasta nueve dígitos decimales que termina en " |
staticDuration |
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 " |
polyline |
Polilínea general de la ruta Esta polilínea es la polilínea combinada de todos los elementos |
description |
Una descripción de la ruta. |
warnings[] |
Un array de advertencias para mostrar cuando se muestre la ruta. |
viewport |
Es 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 las propiedades de |
routeToken |
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: |
RouteLabel
Son las etiquetas de
que son útiles para identificar propiedades específicas de la ruta y compararlas con otras.Route
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 . |
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 ( |
Campos | |
---|---|
distanceMeters |
La distancia de viaje del tramo de la ruta, en metros. |
duration |
Es el tiempo necesario para navegar por la pierna. Si Es una duración en segundos con hasta nueve dígitos decimales que termina en " |
staticDuration |
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 " |
polyline |
Polilínea general de este segmento que incluye la polilínea de cada |
startLocation |
La ubicación inicial de este tramo. Es posible que esta ubicación sea diferente de la |
endLocation |
La ubicación final de este tramo. Es posible que esta ubicación sea diferente de la |
steps[] |
Es un array de pasos que denota 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 la zona de tráfico, en un tramo de la ruta. |
localizedValues |
Representaciones de texto de las propiedades de |
stepsOverview |
Descripción general sobre los pasos en esta |
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 coding_polyline. Las direcciones (polyline_type ) solo pueden ser una de las siguientes opciones: |
|
encodedPolyline |
Codificación de strings de la polilínea mediante el algoritmo de codificación de polilínea |
geoJsonLinestring |
Especifica una polilínea con el formato LineString de GeoJSON. |
RouteLegStep
Contiene un segmento de un
. Un paso corresponde a una sola instrucción de navegación. Los tramos de la ruta se componen 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 |
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 " |
polyline |
La polilínea asociada con este paso. |
startLocation |
La ubicación inicial 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 posibles restricciones de la zona de tráfico, en un paso de la etapa. |
localizedValues |
Representaciones de texto de las propiedades de |
transitDetails |
Son los detalles relacionados con este paso si el medio de transporte es |
travelMode |
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 ( |
Campos | |
---|---|
speedReadingIntervals[] |
NOTA: Este campo no está propagado actualmente. |
RouteLegStepLocalizedValues
Representaciones de texto de determinadas 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 de tráfico, representada en forma de texto. |
RouteLegStepTransitDetails
Información adicional de RouteLegStep
relacionada con las rutas TRANSIT
.
Representación JSON |
---|
{ "stopDetails": { object ( |
Campos | |
---|---|
stopDetails |
Es la información sobre las paradas de llegada y salida del paso. |
localizedValues |
Representaciones de texto de las propiedades de |
headsign |
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 |
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 " |
transitLine |
Corresponde a la información sobre la línea de transporte público que se usa en este paso. |
stopCount |
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 |
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 |
TransitStopDetails
Detalles sobre las paradas de transporte público del RouteLegStep
.
Representación JSON |
---|
{ "arrivalStop": { object ( |
Campos | |
---|---|
arrivalStop |
Información sobre la parada de llegada para el paso. |
arrivalTime |
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: |
departureStop |
Es la información sobre la parada de salida del paso. |
departureTime |
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: |
TransitStop
Incluye información sobre una parada de transporte público.
Representación JSON |
---|
{
"name": string,
"location": {
object ( |
Campos | |
---|---|
name |
Es 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 valores de RouteTransitDetails
Representación JSON |
---|
{ "arrivalTime": { object ( |
Campos | |
---|---|
arrivalTime |
Hora en la representación de texto con formato con la zona horaria correspondiente. |
departureTime |
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 ( |
Campos | |
---|---|
time |
La hora especificada como una cadena en una zona horaria determinada. |
timeZone |
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 ( |
Campos | |
---|---|
agencies[] |
La empresa (o las empresas) de transporte público que opera esta línea de transporte público. |
name |
Es el nombre completo de esta línea de transporte público. Por ejemplo, "8 Avenue Local". |
uri |
el URI de esta línea de transporte público tal como lo proporciona la empresa de transporte público. |
color |
Es 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, este nombre será un número de línea, como "M7" o "355". |
textColor |
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 |
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 |
Es el nombre de la empresa de transporte público. |
phoneNumber |
Es el número de teléfono con formato específico de la configuración regional de la empresa de transporte público. |
uri |
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 ( |
Campos | |
---|---|
name |
Es el nombre del vehículo, en mayúsculas. |
type |
Indica 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. |
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 ( |
Campos | |
---|---|
tollInfo |
Contiene información sobre los peajes en el |
speedReadingIntervals[] |
Intervalos de lectura rápida que detallan la densidad del tráfico Se aplica en el caso de las preferencias de enrutamiento de Ejemplo:
|
RouteLegLocalizedValues
Representaciones de texto de determinadas propiedades.
Representación JSON |
---|
{ "distance": { object ( |
Campos | |
---|---|
distance |
Distancia de viaje representada en forma de texto. |
duration |
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 |
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 ( |
Campos | |
---|---|
multiModalSegments[] |
Se resumió la información sobre diferentes segmentos multimodales del |
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 ( |
Campos | |
---|---|
navigationInstruction |
NavigationInstruction para el segmento multimodal. |
travelMode |
El medio de viaje 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. 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 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
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 ( |
Campos | |
---|---|
low |
Obligatorio. Es el punto inferior del viewport. |
high |
Obligatorio. Es el punto más alto del viewport. |
RouteLocalizedValues
Representaciones de texto de determinadas propiedades.
Representación JSON |
---|
{ "distance": { object ( |
Campos | |
---|---|
distance |
Distancia de viaje representada en forma de texto. |
duration |
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 |
Es la duración sin tener en cuenta las condiciones de tráfico, representada en forma de texto. |
transitFare |
Tarifas de transporte público representadas en forma de texto |
GeocodingResults
Contiene
para puntos de referencia intermedios, de origen y de destino. Solo se completa para los puntos de referencia de la dirección.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 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 ( |
Campos | |
---|---|
geocoderStatus |
Indica el código de estado que se genera a partir de la operación de geocodificación. |
type[] |
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 |
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 |
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 uno intermedio. |