Este producto tiene el estado heredado. A partir de octubre de 2026, ya no se podrá habilitar la API de Directions (heredada) para proyectos nuevos de Google Cloud. Los proyectos existentes siguen siendo totalmente compatibles. Para obtener nuevas funciones y un mejor rendimiento, migra a la API de Routes.

Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

Respuestas sobre cómo llegar

Desarrolladores del Espacio Económico Europeo (EEE)

Este producto se encuentra en estado heredado. A partir de octubre de 2026, ya no se podrá habilitar la API de Directions (heredada) para los proyectos nuevos de Google Cloud. Los proyectos existentes siguen siendo totalmente compatibles. Para obtener funciones nuevas y un mejor rendimiento, migra a la API de Routes.

Respuestas de muestra

Las respuestas de Directions se devuelven en el formato que indica la marca output dentro de la ruta de acceso de la URL de la solicitud.

A continuación, se muestra un ejemplo de solicitud HTTP que calcula la ruta desde Chicago, Illinois, hasta Los Ángeles, California, con dos puntos de referencia en Joplin, Misuri, y Oklahoma City, Oklahoma.

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Los%20Angeles%2C%20CA
  &origin=Chicago%2C%20IL
  &waypoints=Joplin%2C%20MO%7COklahoma%20City%2C%20OK
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Chicago%2C%20IL&destination=Los%20Angeles%2C%20CA&waypoints=Joplin%2C%20MO%7COklahoma%20City%2C%20OK&key=YOUR_API_KEY'

El ejemplo anterior solicita el formato de salida JSON. También es posible solicitar un resultado en formato XML. Selecciona las pestañas que aparecen a continuación para ver las respuestas de ejemplo en formato JSON y XML.

JSON

      
{
  "geocoded_waypoints":
    [
      {
        "geocoder_status": "OK",
        "place_id": "ChIJ7cv00DwsDogRAMDACa2m4K8",
        "types": ["locality", "political"],
      },
      {
        "geocoder_status": "OK",
        "place_id": "ChIJ69Pk6jdlyIcRDqM1KDY3Fpg",
        "types": ["locality", "political"],
      },
      {
        "geocoder_status": "OK",
        "place_id": "ChIJgdL4flSKrYcRnTpP0XQSojM",
        "types": ["locality", "political"],
      },
      {
        "geocoder_status": "OK",
        "place_id": "ChIJE9on3F3HwoAR9AhGJW_fL-I",
        "types": ["locality", "political"],
      },
    ],
  "routes":
    [
      {
        "bounds":
          {
            "northeast": { "lat": 41.8781139, "lng": -87.6297872 },
            "southwest": { "lat": 34.0523525, "lng": -118.2435717 },
          },
        "copyrights": "Map data ©2022 Google, INEGI",
        "legs":
          [
            {
              "distance": { "text": "579 mi", "value": 932311 },
              "duration": { "text": "8 hours 48 mins", "value": 31653 },
              "end_address": "Joplin, MO, USA",
              "end_location": { "lat": 37.0842449, "lng": -94.513284 },
              "start_address": "Chicago, IL, USA",
              "start_location": { "lat": 41.8781139, "lng": -87.6297872 },
              "steps":
                [
                  {
                    "distance": { "text": "443 ft", "value": 135 },
                    "duration": { "text": "1 min", "value": 24 },
                    "end_location": { "lat": 41.8769003, "lng": -87.6297353 },
                    "html_instructions": "Head <b>south</b> on <b>S Federal St</b> toward <b>W Van Buren St</b>",
                    "polyline": { "points": "eir~FdezuOdCEjBC" },
                    "start_location": { "lat": 41.8781139, "lng": -87.6297872 },
                    "travel_mode": "DRIVING",
                  },
                  {
                    "distance": { "text": "269 ft", "value": 82 },
                    "duration": { "text": "1 min", "value": 20 },
                    "end_location": { "lat": 41.8768866, "lng": -87.63073 },
                    "html_instructions": "Turn <b>right</b> at the 1st cross street onto <b>W Van Buren St</b>",
                    "maneuver": "turn-right",
                    "polyline": { "points": "sar~FzdzuO@fC?|@" },
                    "start_location": { "lat": 41.8769003, "lng": -87.6297353 },
                    "travel_mode": "DRIVING",
                  },
                  // Additional steps omitted for brevity
                ],
              "traffic_speed_entry": [],
              "via_waypoint": [],
            },
            // Additional legs (Joplin to Oklahoma City, Oklahoma City to Los Angeles) omitted for brevity
          ],
        "overview_polyline":
          {
            "points": "eir~FdezuOxyFzfFl`G|qZvtSzqo@d}EhlLtqIdjFhrTfvEdca@... (truncated for brevity)",
          },
        "summary": "I-55 S and I-44",
        "warnings": [],
        "waypoint_order": [0, 1],
      },
    ],
  "status": "OK",
}

XML

      
<DirectionsResponse>
 <status>OK</status>
 <route>
  <summary>I-55 S and I-44</summary>
  <leg>
   <step>
    <travel_mode>DRIVING</travel_mode>
    <start_location>
     <lat>41.8781139</lat>
     <lng>-87.6297872</lng>
    </start_location>
    <end_location>
     <lat>41.8769003</lat>
     <lng>-87.6297353</lng>
    </end_location>
    <polyline>
     <points>eir~FdezuOdCEjBC</points>
    </polyline>
    <duration>
     <value>24</value>
     <text>1 min</text>
    </duration>
    <html_instructions>Head &lt;b&gt;south&lt;/b&gt; on &lt;b&gt;S Federal St&lt;/b&gt; toward &lt;b&gt;W Van Buren St&lt;/b&gt;</html_instructions>
    <distance>
     <value>135</value>
     <text>443 ft</text>
    </distance>
   </step>
   <step>
    <travel_mode>DRIVING</travel_mode>
    <start_location>
     <lat>41.8769003</lat>
     <lng>-87.6297353</lng>
    </start_location>
    <end_location>
     <lat>41.8768866</lat>
     <lng>-87.6307300</lng>
    </end_location>
    <polyline>
     <points>sar~FzdzuO@fC?|@</points>
    </polyline>
    <duration>
     <value>20</value>
     <text>1 min</text>
    </duration>
    <html_instructions>Turn &lt;b&gt;right&lt;/b&gt; at the 1st cross street onto &lt;b&gt;W Van Buren St&lt;/b&gt;</html_instructions>
    <distance>
     <value>82</value>
     <text>269 ft</text>
    </distance>
    <maneuver>turn-right</maneuver>
   </step>
   <!-- Additional steps omitted for brevity -->
   <duration>
    <value>31653</value>
    <text>8 hours 48 mins</text>
   </duration>
   <distance>
    <value>932311</value>
    <text>579 mi</text>
   </distance>
   <start_location>
    <lat>41.8781139</lat>
    <lng>-87.6297872</lng>
   </start_location>
   <end_location>
    <lat>37.0842449</lat>
    <lng>-94.5132840</lng>
   </end_location>
   <start_address>Chicago, IL, USA</start_address>
   <end_address>Joplin, MO, USA</end_address>
  </leg>
  <!-- Additional legs (Joplin to Oklahoma City, Oklahoma City to Los Angeles) omitted for brevity -->
  <copyrights>Map data ©2022 Google, INEGI</copyrights>
  <overview_polyline>
   <points>eir~FdezuOxyFzfFl`G|qZvtSzqo@d}EhlLtqIdjFhrTfvEdca@... (truncated for brevity)</points>
  </overview_polyline>
  <waypoint_index>0</waypoint_index>
  <waypoint_index>1</waypoint_index>
  <bounds>
   <southwest>
    <lat>34.0523525</lat>
    <lng>-118.2435717</lng>
   </southwest>
   <northeast>
    <lat>41.8781139</lat>
    <lng>-87.6297872</lng>
   </northeast>
  </bounds>
 </route>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJ7cv00DwsDogRAMDACa2m4K8</place_id>
 </geocoded_waypoint>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJ69Pk6jdlyIcRDqM1KDY3Fpg</place_id>
 </geocoded_waypoint>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJgdL4flSKrYcRnTpP0XQSojM</place_id>
 </geocoded_waypoint>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJE9on3F3HwoAR9AhGJW_fL-I</place_id>
 </geocoded_waypoint>
</DirectionsResponse>

En el resto de esta documentación se usará sintaxis JSON. En la mayoría de los casos, el formato de salida no importa para ilustrar conceptos o nombres de campos en la documentación. Sin embargo, ten en cuenta las siguientes diferencias sutiles:

Los resultados XML se unen en un elemento raíz <DirectionsResponse>.
JSON denota entradas con varios elementos por arrays plurales (como steps y legs), mientras que XML los denota con varios elementos singulares (como <step> y <leg>).
JSON indica el orden de los puntos de referencia a través del campo waypoint_order, mientras que XML los indica con elementos <waypoint_index> individuales.
Los elementos en blanco se indican a través de arrays vacíos en JSON, pero por la ausencia de cualquier elemento de ese tipo en XML. Por ejemplo, una respuesta que no genera resultados devolverá un array routes vacío en JSON, pero no elementos <route> en XML.

DirectionsResponse

Campo	Obligatorio	Tipo	Descripción
`routes`	required	Array<DirectionsRoute>	Contiene un array de rutas desde el origen hasta el destino. Las rutas consisten en tramos y pasos anidados. Consulta DirectionsRoute para obtener más información.
`status`	required	DirectionsStatus	Contiene el estado de la solicitud y puede incluir información de depuración para ayudarte a identificar el motivo del error en la solicitud. Consulta DirectionsStatus para obtener más información.
`available_travel_modes`	opcional	Array<TravelMode>	Contiene un array de medios de transporte disponibles. Este campo se devuelve cuando una solicitud especifica un medio de transporte y no obtiene resultados. El array contiene los medios de transporte disponibles en los países del conjunto de puntos de referencia determinado. Este campo no se devuelve si uno o más de los puntos de referencia son "puntos de referencia intermedios". Consulta TravelMode para obtener más información.
`error_message`	opcional	string	Cuando el servicio devuelve un código de estado que no es `OK`, es posible que haya un campo `error_message` adicional dentro del objeto de respuesta. Este campo contiene información más detallada sobre los motivos del código de estado proporcionado. Este campo no siempre se devuelve y su contenido está sujeto a cambios.
`geocoded_waypoints`	opcional	Array<DirectionsGeocodedWaypoint>	Contiene un array con detalles sobre la geocodificación del origen, el destino y los puntos de referencia. Los elementos del array geocoded_waypoints corresponden, según su posición basada en cero, al origen, los puntos de referencia en el orden en que se especifican y el destino. Estos detalles no estarán presentes para los puntos de referencia especificados como valores textuales de latitud y longitud si el servicio no devuelve resultados. Esto se debe a que esos puntos de referencia solo se someten a geocodificación inversa para obtener su dirección representativa después de que se encuentra una ruta. Un objeto JSON vacío ocupará los lugares correspondientes en el array geocoded_waypoints. Consulta DirectionsGeocodedWaypoint para obtener más información.

DirectionsRoute

Las rutas constan de legs y steps anidados.

Campo	Obligatorio	Tipo	Descripción
`bounds`	required	Límites	Contiene el cuadro delimitador del viewport de `overview_polyline`. Consulta Límites para obtener más información.
`copyrights`	required	string	Contiene los avisos sobre derechos de autor que se deben mostrar para esta ruta. Debes controlar y mostrar esta información por tu cuenta. Este contenido se debe leer tal como está. No analices este contenido de solo visualización de manera programática.
`legs`	required	Array<DirectionsLeg>	Es un array que contiene información sobre un tramo de la ruta, entre dos ubicaciones de la ruta determinada. Habrá un tramo separado para cada punto de referencia o destino especificados. (Una ruta sin puntos de referencia contendrá exactamente un tramo dentro del array legs). Cada tramo consta de una serie de pasos. Consulta DirectionsLeg para obtener más información.
`overview_polyline`	required	DirectionsPolyline	Contiene un objeto que incluye una representación de la polilínea codificada de la ruta. Esta polilínea es una ruta aproximada (unificada) del resultado de las instrucciones sobre cómo llegar. Consulta DirectionsPolyline para obtener más información.
`summary`	required	string	Contiene una descripción textual breve de la ruta, adecuada para nombrarla y diferenciarla de las alternativas.
`warnings`	required	Array<string>	Contiene un array de advertencias que aparecerán cuando se muestren estas instrucciones sobre cómo llegar. Debes controlar y mostrar estas advertencias por tu cuenta.
`waypoint_order`	required	Array<integer>	Es un array que indica el orden de los puntos de referencia en la ruta calculada. Es posible que se reordenen estos puntos de referencia si se pasó optimize:true en el parámetro waypoints de la solicitud.
`fare`	opcional	Tarifa	Si estuviera presente, contiene los costos totales (es decir, los costos totales de los tickets) para esta ruta. Esta propiedad se muestra únicamente para las solicitudes de transporte público y solo para las rutas que disponen de información sobre las tarifas para todos los segmentos del recorrido. Consulta Tarifa para obtener más información.

Límites

Es un rectángulo en coordenadas geográficas desde puntos en las esquinas suroeste y noreste.

Campo	Obligatorio	Tipo	Descripción
`northeast`	required	LatLngLiteral	Consulta LatLngLiteral para obtener más información.
`southwest`	required	LatLngLiteral	Consulta LatLngLiteral para obtener más información.

LatLngLiteral

Es un objeto que describe una ubicación específica con latitud y longitud en grados decimales.

Campo	Obligatorio	Tipo	Descripción
`lat`	required	número	Latitud en grados decimales
`lng`	required	número	Longitud en grados decimales

DirectionsLeg

Campo	Obligatorio	Tipo	Descripción
`end_address`	required	string	Contiene la dirección legible por humanos (por lo general, una dirección postal) de la geocodificación inversa del `end_location` de este tramo. Este contenido se debe leer tal como está. No analices la dirección con formato de manera programática.
`end_location`	required	LatLngLiteral	Son las coordenadas de latitud y longitud del destino determinado de este tramo. Debido a que la API de Directions calcula las instrucciones sobre cómo llegar entre ubicaciones con la opción de transporte más cercana (por lo general, una ruta) en los puntos de partida y destino, es posible que `end_location` sea diferente del destino proporcionado para este segmento si, por ejemplo, no hay una ruta cerca del destino. Consulta LatLngLiteral para obtener más información.
`start_address`	required	string	Contiene la dirección legible por humanos (por lo general, una dirección postal) que resulta de la geocodificación inversa de `start_location` de este tramo. Este contenido se debe leer tal como está. No analices la dirección con formato de manera programática.
`start_location`	required	LatLngLiteral	Son las coordenadas de latitud y longitud del origen de este tramo. Debido a que la API de Directions calcula las instrucciones sobre cómo llegar entre ubicaciones con la opción de transporte más cercana (por lo general, una ruta) en los puntos de partida y destino, es posible que `start_location` sea diferente del origen proporcionado para este tramo si, por ejemplo, no hay una ruta cerca del origen. Consulta LatLngLiteral para obtener más información.
`steps`	required	Array<DirectionsStep>	Es un array de pasos que denota información sobre cada paso individual del tramo del viaje. Consulta DirectionsStep para obtener más información.
`traffic_speed_entry`	opcional	Array<DirectionsTrafficSpeedEntry>	Obsoleto: Este array siempre está vacío. Información sobre la velocidad del tráfico a lo largo del tramo. Consulta DirectionsTrafficSpeedEntry para obtener más información.
`via_waypoint`	required	Array<DirectionsViaWaypoint>	Son las ubicaciones de los puntos de referencia intermedios a lo largo de este tramo. Consulta DirectionsViaWaypoint para obtener más información.
`arrival_time`	opcional	TimeZoneTextValueObject	Contiene la hora estimada de llegada para este tramo. Esta propiedad solo se muestra para las rutas en transporte público. Consulta TimeZoneTextValueObject para obtener más información.
`departure_time`	opcional	TimeZoneTextValueObject	Contiene la hora estimada de salida para este tramo, especificada como un objeto Time. `departure_time` solo está disponible para las rutas en transporte público. Consulta TimeZoneTextValueObject para obtener más información.
`distance`	opcional	TextValueObject	Es la distancia total que abarca este tramo. Consulta TextValueObject para obtener más información.
`duration`	opcional	TextValueObject	Es la duración total de este tramo. Consulta TextValueObject para obtener más información.
`duration_in_traffic`	opcional	TextValueObject	Indica la duración total de este tramo. Este valor es una estimación del tiempo en el tráfico según las condiciones de tráfico actuales e históricas. Consulta el parámetro de solicitud `traffic_model` para conocer las opciones que puedes usar para solicitar que el valor que se muestra sea optimista, pesimista o una estimación aproximada. La duración en el tráfico solo se devuelve si se cumplen todas las condiciones que se indican a continuación: La solicitud no incluye waypoints de parada. Si la solicitud incluye puntos de referencia, estos deben tener el prefijo `via:` para evitar las paradas. La solicitud se realiza específicamente para obtener la ruta en auto (el parámetro mode se establece en `driving`). La solicitud incluye un parámetro `departure_time`. Las condiciones del tráfico están disponibles para la ruta solicitada. Consulta TextValueObject para obtener más información.

DirectionsStep

Cada elemento del array steps define un solo paso de las instrucciones sobre cómo llegar calculadas. Un paso es la unidad más pequeña de la ruta de una instrucción sobre cómo llegar y contiene un paso individual en el que se describe una instrucción específica y única para el viaje. Por ejemplo, "Gira a la izquierda en la calle 4". En el paso no solo se describe la instrucción, sino que también se incluye información sobre la distancia y la duración de este paso con respecto al siguiente. Por ejemplo, el paso "Incorpórate a la I-80 hacia el oeste" puede contener una duración de "37 millas" y "40 minutos", lo que indica que el próximo paso se encuentra a 37 millas o 40 minutos del paso actual.

Cuando uses la API de Directions para buscar rutas en transporte público, el array de pasos incluirá detalles adicionales sobre el transporte público en forma de array transit_details. Si las instrucciones sobre cómo llegar incluyen varios medios de transporte, se proporcionarán instrucciones detalladas para los pasos a pie o en auto en un array de pasos internos. Por ejemplo, un paso a pie incluirá instrucciones sobre cómo llegar desde las ubicaciones de partida y destino: "Camina hasta Innes Ave y Fitch St". Ese paso incluirá instrucciones detalladas sobre cómo llegar a pie para esa ruta en el array de pasos internos, como "Dirígete hacia el noroeste", "Gira a la izquierda en Arelious Walker" y "Gira a la izquierda en Innes Ave".

Campo	Obligatorio	Tipo	Descripción
`duration`	required	TextValueObject	Contiene el tiempo típico necesario para realizar el paso, hasta el siguiente. Este campo puede no definirse si se desconoce la duración. Consulta TextValueObject para obtener más información.
`end_location`	required	LatLngLiteral	Contiene la ubicación del último punto de este paso. Consulta LatLngLiteral para obtener más información.
`html_instructions`	required	string	Contiene instrucciones con formato para este paso, presentadas como una cadena de texto HTML. Este contenido se debe leer tal como está. No analices de manera programática este contenido que solo se muestra.
`polyline`	required	DirectionsPolyline	Contiene un solo objeto de puntos que incluye una representación de la polilínea codificada del paso. Esta polilínea es una ruta aproximada (unificada) del paso. Consulta DirectionsPolyline para obtener más información.
`start_location`	required	LatLngLiteral	Contiene la ubicación del punto de partida de este paso. Consulta LatLngLiteral para obtener más información.
`travel_mode`	required	TravelMode	Contiene el tipo de modo de viaje utilizado. Consulta TravelMode para obtener más información.
`distance`	opcional	TextValueObject	Contiene la distancia entre este paso y el siguiente. Este campo puede no definirse si se desconoce la distancia. Consulta TextValueObject para obtener más información.
`maneuver`	opcional	string	Contiene la acción que se debe realizar en el paso actual (girar a la izquierda, incorporarse, seguir recto, etcétera). Los valores están sujetos a cambios, y se pueden ingresar valores nuevos sin aviso previo. The allowed values include: `turn-slight-left`, `turn-sharp-left`, `turn-left`, `turn-slight-right`, `turn-sharp-right`, `keep-right`, `keep-left`, `uturn-left`, `uturn-right`, `turn-right`, `straight`, `ramp-left`, `ramp-right`, `merge`, `fork-left`, `fork-right`, `ferry`, `ferry-train`, `roundabout-left`, and `roundabout-right`
`steps`	opcional		Contiene instrucciones detalladas sobre cómo llegar a pie o en auto en las rutas en transporte público. Los pasos secundarios solo están disponibles cuando travel_mode se establece en "transit". El array de pasos interno es del mismo tipo que steps.
`transit_details`	opcional	DirectionsTransitDetails	Son los detalles relacionados con este paso si el medio de transporte es `transit`. Consulta DirectionsTransitDetails para obtener más información.

TextValueObject

Es un objeto que contiene un valor numérico y su representación de texto con formato.

Campo	Obligatorio	Tipo	Descripción
`text`	required	string	Valor de string
`value`	required	número	Es un valor numérico.

DirectionsPolyline

La codificación de polilíneas es un algoritmo de compresión con pérdida que te permite almacenar una serie de coordenadas como una sola cadena. Las coordenadas de punto se codifican usando valores firmados. Si solo tienes unos pocos puntos estáticos, también puedes usar la utilidad de codificación de polilíneas interactiva.

El proceso de codificación convierte un valor binario en una serie de códigos de caracteres para caracteres ASCII con el esquema de codificación base64 conocido: para garantizar que estos caracteres se muestren correctamente, los valores codificados se suman con 63 (el carácter ASCII "?") antes de convertirlos en ASCII. El algoritmo también verifica si hay códigos de caracteres adicionales para un punto determinado. Para ello, comprueba el bit menos significativo de cada grupo de bytes. Si este bit se establece en 1, el punto aún no está completamente formado y deben seguir datos adicionales.

Además, para ahorrar espacio, los puntos solo incluyen el desplazamiento desde el punto anterior (excepto, por supuesto, para el primer punto). Todos los puntos se codifican en Base64 como números enteros con signo, ya que las latitudes y longitudes son valores con signo. El formato de codificación dentro de una polilínea debe representar dos coordenadas que representen la latitud y la longitud con una precisión razonable. Dada una longitud máxima de +/-180 grados con una precisión de 5 decimales (de 180.00000 a -180.00000), se necesita un valor de número entero binario con signo de 32 bits.

Campo	Obligatorio	Tipo	Descripción
`points`	required	string	Es una representación de cadena única de la polilínea.

TravelMode

DRIVING (predeterminado) indica que el cálculo se realiza con la red de rutas.
BICYCLING solicita el cálculo para andar en bicicleta por ciclovías y calles preferidas (cuando estén disponibles).
TRANSIT solicita el cálculo con rutas de transporte público (cuando estén disponibles).
WALKING solicita el cálculo para caminar por rutas peatonales y veredas (cuando estén disponibles).

DirectionsTransitDetails

Información adicional que no es relevante para otros medios de transporte.

Campo	Obligatorio	Tipo	Descripción
`arrival_stop`	opcional	DirectionsTransitStop	La parada de transporte público de llegada. Consulta DirectionsTransitStop para obtener más información.
`arrival_time`	opcional	TimeZoneTextValueObject	Consulta TimeZoneTextValueObject para obtener más información.
`departure_stop`	opcional	DirectionsTransitStop	La parada de transporte público de salida. Consulta DirectionsTransitStop para obtener más información.
`departure_time`	opcional	TimeZoneTextValueObject	Consulta TimeZoneTextValueObject para obtener más información.
`headsign`	opcional	string	Especifica la dirección en la que se debe viajar en esta línea, como se marca en el vehículo o la parada de salida. A menudo, será la estación terminal.
`headway`	opcional	integer	Especifica la cantidad de segundos previstos entre las salidas desde la misma parada a esa hora. Por ejemplo, con un valor `headway` de 600, se debe prever una espera de diez minutos en caso de perder un autobús.
`line`	opcional	DirectionsTransitLine	Contiene información sobre la línea de transporte público que se usa en este paso. Consulta DirectionsTransitLine para obtener más información.
`num_stops`	opcional	integer	Es la cantidad de paradas desde la salida hasta la llegada. Incluye la parada de llegada, pero no la de salida. Por ejemplo, si las instrucciones sobre cómo llegar implican salir de la parada A, pasar por las paradas B y C, y llegar a la parada D, `num_stops` mostrará 3 paradas.
`trip_short_name`	opcional	string	Es el texto que aparece en los horarios y los carteles para que los pasajeros identifiquen un viaje en transporte público. El texto debe identificar de forma exclusiva un viaje en un día de servicio. Por ejemplo, "538" es el `trip_short_name` del tren de Amtrak que sale de San José, California, a las 15:10 los días de semana hacia Sacramento, California.

DirectionsTransitStop

Campo	Obligatorio	Tipo	Descripción
`location`	required	LatLngLiteral	Es la ubicación de la parada. Consulta LatLngLiteral para obtener más información.
`name`	required	string	Es el nombre de la parada de transporte público.

TimeZoneTextValueObject

Es un objeto que contiene el tiempo Unix, una zona horaria y su representación de texto con formato.

Campo	Obligatorio	Tipo	Descripción
`text`	required	string	Es la hora especificada como una cadena en la zona horaria.
`time_zone`	required	string	Contiene la zona horaria. El valor es el nombre de la zona horaria tal como se define en la base de datos de zonas horarias de IANA, p.ej., "America/New_York".
`value`	required	número	Es la hora especificada como tiempo Unix o segundos desde la medianoche del 1 de enero de 1970 (UTC).

DirectionsTransitLine

Campo	Obligatorio	Tipo	Descripción
`agencies`	required	Array<DirectionsTransitAgency>	Es la empresa (o las empresas) de transporte público que opera esta línea de transporte público. Consulta DirectionsTransitAgency para obtener más información.
`name`	required	string	Es el nombre completo de esta línea de transporte público, p.ej., "8 Avenue Local".
`color`	opcional	string	Es el color que se suele usar para la señalización de esta línea.
`icon`	opcional	string	Contiene la URL del ícono asociado con esta línea.
`short_name`	opcional	string	Es el nombre corto de esta línea de transporte público. Suele ser el número de la línea, como "M7" o "355".
`text_color`	opcional	string	Es el color que se suele usar para la señalización de esta línea.
`url`	opcional	string	Contiene la URL de esta línea de transporte público tal como la proporciona la empresa de transporte público.
`vehicle`	opcional	DirectionsTransitVehicle	Es el tipo de vehículo que opera en esta línea de transporte público. Consulta DirectionsTransitVehicle para obtener más información.

DirectionsTransitAgency

Campo	Obligatorio	Tipo	Descripción
`name`	opcional	string	Es el nombre de esta empresa de transporte público.
`phone`	opcional	string	Es el número de teléfono de la empresa de transporte público.
`url`	opcional	string	Es la URL de la empresa de transporte público.

DirectionsTransitVehicle

Campo	Obligatorio	Tipo	Descripción
`name`	required	string	Es el nombre de este vehículo, en mayúsculas.
`type`	required	string	Es el tipo de vehículo que se usó. `BUS`: autobús. `CABLE_CAR`: Es 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`: transbordador, ferry. `FUNICULAR`: Un vehículo que sube por una pendiente pronunciada a través de un cable Un funicular normalmente consta de dos coches, y 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`: Se mostrará este tipo para todos los demás vehículos. `RAIL`: tren. `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 The allowed values include: `BUS`, `CABLE_CAR`, `COMMUTER_TRAIN`, `FERRY`, `FUNICULAR`, `GONDOLA_LIFT`, `HEAVY_RAIL`, `HIGH_SPEED_TRAIN`, `INTERCITY_BUS`, `LONG_DISTANCE_TRAIN`, `METRO_RAIL`, `MONORAIL`, `OTHER`, `RAIL`, `SHARE_TAXI`, `SUBWAY`, `TRAM`, and `TROLLEYBUS`
`icon`	opcional	string	Contiene la URL de un ícono asociado con este tipo de vehículo.
`local_icon`	opcional	string	Contiene la URL del ícono asociado con este tipo de vehículo, según la señalización del transporte local.

DirectionsTrafficSpeedEntry

Campo	Obligatorio	Tipo	Descripción
`offset_meters`	required	número	Es el desplazamiento a lo largo de la ruta (en metros) hasta el cual es válida esta categoría de velocidad.
`speed_category`	required	string	Son las condiciones actuales de tráfico y velocidad en esta parte de una ruta.

DirectionsViaWaypoint

Campo	Obligatorio	Tipo	Descripción
`location`	opcional	LatLngLiteral	Es la ubicación del punto de referencia. Consulta LatLngLiteral para obtener más información.
`step_index`	opcional	integer	Es el índice del paso que contiene el punto de referencia.
`step_interpolation`	opcional	número	Es la posición del punto de referencia a lo largo de la polilínea del paso, expresada como una proporción de 0 a 1.

Fare

Es la tarifa total de la ruta.

{
  "currency" : "USD",
  "value" : 6,
  "text" : "$6.00"
}

Campo	Obligatorio	Tipo	Descripción
`currency`	required	string	Es un código de moneda ISO 4217 que indica la moneda en la que se expresa el importe.
`text`	required	string	monto total con formato en el idioma solicitado.
`value`	required	número	Es el importe total de la tarifa expresado en la moneda especificada.

DirectionsStatus

El campo status dentro del objeto de respuesta de Directions contiene el estado de la solicitud y puede incluir información de depuración para ayudarte a identificar el motivo del error en el servicio de Directions. El campo de estado puede contener los siguientes valores:

OK indica que la respuesta contiene un resultado válido.
NOT_FOUND indica que no se pudo geocodificar al menos una de las ubicaciones especificadas en el origen, el destino o los puntos de referencia de la solicitud.
ZERO_RESULTS indica que no se encontró ninguna ruta entre el origen y el destino.
MAX_WAYPOINTS_EXCEEDED indica que se proporcionaron demasiados puntos de referencia en la solicitud. En el caso de las aplicaciones que usan la API de Directions como servicio web o el servicio Directions en la API de Maps JavaScript, la cantidad máxima permitida de puntos de referencia es de 25, además del origen y el destino.
MAX_ROUTE_LENGTH_EXCEEDED indica que la ruta solicitada es demasiado larga y no se puede procesar. Este error se produce cuando se muestran instrucciones más complejas sobre cómo llegar a un lugar. Intenta reducir la cantidad de puntos de referencia, giros o instrucciones.
INVALID_REQUEST indica que la solicitud proporcionada no era válida. Entre las causas comunes de este estado, se incluyen un parámetro o un valor del parámetro no válidos.
OVER_DAILY_LIMIT indica cualquiera de las siguientes opciones:
- Falta la clave de API o no es válida.
- No se habilitó la facturación en tu cuenta.
- Se superó un límite de uso autoimpuesto.
- La forma de pago proporcionada ya no es válida (por ejemplo, venció una tarjeta de crédito).
Consulta las Preguntas frecuentes de Maps para obtener información sobre cómo corregir este problema.
OVER_QUERY_LIMIT indica que el servicio recibió demasiadas solicitudes de tu aplicación dentro del período permitido.
REQUEST_DENIED indica que el servicio rechazó el uso del servicio Directions por parte de tu aplicación.
UNKNOWN_ERROR indica que no se pudo procesar una solicitud de instrucciones sobre cómo llegar debido a un error del servidor. La solicitud podría completarse si realizas un nuevo intento.

DirectionsGeocodedWaypoint

Campo	Obligatorio	Tipo	Descripción
`geocoder_status`	opcional	string	Indica el código de estado que se genera a partir de la operación de geocodificación. Este campo puede contener los siguientes valores. The allowed values include: `OK`, and `ZERO_RESULTS`
`partial_match`	opcional		Indica que el geocodificador no mostró una concordancia 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. Las coincidencias parciales generalmente ocurren cuando las direcciones que se pasan en la solicitud no existen en la localidad. También se pueden mostrar coincidencias parciales cuando una solicitud concuerda con dos o más ubicaciones en la misma localidad. Por ejemplo, "21 Henr St, Bristol, UK" mostrará una coincidencia parcial tanto para Henry Street como para Henrietta Street. Ten en cuenta que, si una solicitud incluye una dirección con un componente que contiene errores ortográficos, el servicio de geocodificación puede sugerir una dirección alternativa. Las sugerencias propuestas de esta manera también se marcarán como una coincidencia parcial.
`place_id`	opcional	string	Es un identificador único que se puede usar con otras APIs de Google. Consulta la descripción general del ID de lugar.
`types`	opcional	Array<string>	Indica el tipo de dirección del resultado de geocodificación que se usa para calcular las instrucciones sobre cómo llegar. `administrative_area_level_1` indica una entidad pública de primer orden por debajo del nivel de país. En Estados Unidos, estos niveles administrativos son los estados. No todos los países poseen estos niveles administrativos. En la mayoría de los casos, los nombres cortos de administrative_area_level_1 coincidirán considerablemente con las subdivisiones de ISO 3166-2 y otras listas conocidas; sin embargo, no podemos garantizarlo debido a que nuestros resultados de geocodificación se basan en diferentes indicadores y datos de ubicación. `administrative_area_level_2` indica una entidad pública de segundo orden por debajo del nivel de país. En Estados Unidos, estos niveles administrativos son los condados. No todos los países poseen estos niveles administrativos. `administrative_area_level_3` indica una entidad civil de tercer orden por debajo del nivel de país. Este tipo indica una división política inferior. No todos los países poseen estos niveles administrativos. `administrative_area_level_4` indica una entidad pública de cuarto orden por debajo del nivel de país. Este tipo indica una división política inferior. No todos los países poseen estos niveles administrativos. `administrative_area_level_5` indica una entidad pública de quinto orden por debajo del nivel de país. Este tipo indica una división política inferior. No todos los países poseen estos niveles administrativos. `airport` indica un aeropuerto. `colloquial_area` indica un nombre alternativo de uso general para la entidad. `country`: Indica la entidad política nacional y, por lo general, es el tipo de orden más alto que muestra el geocodificador. `intersection` indica una intersección principal, generalmente de dos rutas principales. `locality` indica una entidad política constituida como ciudad o pueblo. `natural_feature` indica un componente natural destacado. `neighborhood` indica un vecindario designado. `park` indica un parque designado. `plus_code` indica una referencia de ubicación codificada, derivada de la latitud y la longitud. Los Plus Codes se pueden usar como reemplazo de las direcciones en los lugares donde estas no existen (donde los edificios no están numerados o las calles no tienen nombre). Visita https://plus.codes para obtener más información. `point_of_interest` indica un lugar de interés designado. Por lo general, estos "lugares de interés" son entidades locales destacadas que no encajan con facilidad en otras categorías, como "Edificio Empire State" o "Torre Eiffel". `political` indica una entidad política. Por lo general, este tipo indica un polígono de alguna Administración pública. `postal_code` indica un código postal, tal como se usa para identificar una dirección de correo postal dentro del país. `premise` indica una ubicación designada, generalmente un edificio o un conjunto de edificios con un nombre común. `route` indica una ruta designada (como "US 101"). `street_address` indica una dirección precisa. `sublocality` indica una entidad pública de primer orden por debajo de una localidad. Algunas ubicaciones pueden recibir uno de los tipos adicionales: sublocality_level_1 a sublocality_level_5. Cada nivel de sublocalidad es una entidad pública. Los números más altos indican un área geográfica más pequeña. `subpremise` indica una entidad de primer orden por debajo de una ubicación designada, generalmente, un edificio único dentro de un conjunto de edificios con un nombre común. `tourist_attraction` indica una atracción turística. `train_station` indica una estación de tren. `transit_station` indica una estación de transporte público. Una lista vacía de tipos indica que no hay tipos conocidos para el componente de dirección específico, por ejemplo, Lieu-dit en Francia.

Respuestas sobre cómo llegar Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Respuestas de muestra

URL

curl

JSON

XML

DirectionsResponse

routes

status

available_travel_modes

error_message

geocoded_waypoints

DirectionsRoute

bounds

copyrights

legs

overview_polyline

summary

warnings

waypoint_order

fare

Límites

northeast

southwest

LatLngLiteral

lat

lng

DirectionsLeg

end_address

end_location

start_address

start_location

steps

traffic_speed_entry

via_waypoint

arrival_time

departure_time

distance

duration

duration_in_traffic

DirectionsStep

duration

end_location

html_instructions

polyline

start_location

travel_mode

distance

maneuver

steps

transit_details

TextValueObject

text

value

DirectionsPolyline

points

TravelMode

DirectionsTransitDetails

arrival_stop

arrival_time

departure_stop

departure_time

headsign

headway

line

num_stops

trip_short_name

DirectionsTransitStop

location

name

TimeZoneTextValueObject

text

time_zone

value

DirectionsTransitLine

agencies

name

color

icon

short_name

Respuestas sobre cómo llegar

`routes`

`status`

`available_travel_modes`

`error_message`

`geocoded_waypoints`

`bounds`

`copyrights`

`legs`

`overview_polyline`

`summary`

`warnings`

`waypoint_order`

`fare`

`northeast`

`southwest`

`lat`

`lng`

`end_address`

`end_location`

`start_address`

`start_location`

`steps`

`traffic_speed_entry`

`via_waypoint`

`arrival_time`

`departure_time`

`distance`

`duration`

`duration_in_traffic`

`duration`

`end_location`

`html_instructions`

`polyline`

`start_location`

`travel_mode`

`distance`

`maneuver`

`steps`

`transit_details`

`text`

`value`

`points`

`arrival_stop`

`arrival_time`

`departure_stop`

`departure_time`

`headsign`

`headway`

`line`

`num_stops`

`trip_short_name`

`location`

`name`

`text`

`time_zone`

`value`

`agencies`

`name`

`color`

`icon`

`short_name`

`text_color`

`url`

`vehicle`

`name`

`phone`

`url`

`name`

`type`

`icon`

`local_icon`

`offset_meters`

`speed_category`

`location`

`step_index`

`step_interpolation`

`currency`

`text`

`value`