Este producto o función tiene el estado de heredado. Para obtener más información sobre el estado de heredado y cómo migrar de los servicios heredados a los más nuevos, consulta
Productos y funciones heredados.
Descripción general de la API de Directions (heredada)
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Desarrolladores del Espacio Económico Europeo (EEE)
La API de Directions (heredada) es un servicio que acepta una solicitud HTTP y devuelve instrucciones entre ubicaciones con formato JSON o XML.
Por qué usar la API de Directions
Con la API de Directions, puedes obtener instrucciones sobre cómo llegar a un destino en varios medios de transporte, como transporte público, automóvil, a pie o en bicicleta.
¿Qué puedes hacer con la API de Directions?
Con la API de Directions, puedes calcular las indicaciones para llegar a un destino entre ubicaciones, incluidos los siguientes detalles:
- Instrucciones sobre cómo llegar en varios medios de transporte, como transporte público, automóvil, a pie o en bicicleta.
- Instrucciones de varias partes con una serie de puntos de referencia.
- Especifica orígenes, destinos y puntos de referencia de varias maneras, incluso como cadenas de texto (por ejemplo, "Chicago, IL" o "Darwin, NT, Australia"), IDs de lugar o coordenadas de latitud y longitud.
Cómo funciona la API de Directions
La API de Directions devuelve las rutas más eficientes cuando calcula instrucciones sobre cómo llegar. El producto tiene en cuenta los siguientes elementos de viaje cuando determina la ruta más eficiente:
- Tiempo de viaje (principal)
- Distancia
- Cantidad de giros
En el siguiente ejemplo de solicitud, se muestran las instrucciones para llegar en automóvil desde Toronto, Ontario, hasta Montreal, Quebec, en formato JSON:
https://maps.googleapis.com/maps/api/directions/json
?destination=Montreal
&origin=Toronto
&key=YOUR_API_KEY
Recursos
En la siguiente tabla, se resumen los recursos disponibles a través de la API de Directions junto con los datos que devuelve.
| Recursos de datos |
Datos devueltos |
Formato de devolución |
| Directions
Proporciona orígenes y destinos en forma de IDs de lugar, direcciones o coordenadas de latitud y longitud. Consulta los parámetros obligatorios
para obtener más detalles.
|
Instrucciones detalladas, divididas en rutas, tramos y pasos Consulta Respuestas de Directions para obtener más detalles.
|
|
Cómo usar la API de Directions
| 1 |
Configura tu cuenta. |
Comienza con Configura tu
proyecto de Google Cloud
y completa las instrucciones
de configuración que se indican a continuación. |
| 2 |
Probar la demostración |
Una vez que tengas una clave de API y un proyecto de Cloud, podrás probar la demostración de direcciones sin cargo. Consulta la demostración de la API de Directions.
|
| 3 |
Crea una solicitud |
Consulta las solicitudes de ejemplo y obtén información sobre las opciones disponibles que puedes proporcionar, como medios de transporte, puntos de referencia y restricciones de ruta. Consulta ejemplos de instrucciones sobre cómo llegar.
|
| 4 |
Conceptos básicos sobre las respuestas |
Explora las respuestas de datos para prepararte para usar datos de direcciones en tu app. Consulta Respuestas de Directions para obtener más detalles.
|
| 5 |
Incorpora datos de direcciones en tu propia app. |
Puedes usar estos datos para calcular la distancia y el tiempo de viaje.
|
Bibliotecas cliente disponibles
Llama a esta API en el idioma que elijas a través de una de las siguientes bibliotecas cliente:
Las bibliotecas cliente de Java, Python, Go y Node.js para los servicios de Google Maps son bibliotecas cliente de código abierto según la licencia Apache 2.0 que cuentan con asistencia de la comunidad.
Descárgalas de GitHub, donde también encontrarás instrucciones de instalación y código de muestra.
¿Qué sigue?
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-08-31 (UTC)
[null,null,["Última actualización: 2025-08-31 (UTC)"],[[["\u003cp\u003eThe Directions API provides route information between locations using various transportation modes like driving, walking, transit, or bicycling.\u003c/p\u003e\n"],["\u003cp\u003eYou can customize your requests by specifying origins, destinations, waypoints, and travel preferences.\u003c/p\u003e\n"],["\u003cp\u003eThe API calculates the most efficient routes based on travel time, distance, and the number of turns.\u003c/p\u003e\n"],["\u003cp\u003eResults are available in JSON or XML format and include detailed directions, routes, legs, and steps.\u003c/p\u003e\n"],["\u003cp\u003eClient libraries are available in Java, Python, Go, and Node.js for easy integration into your applications.\u003c/p\u003e\n"]]],[],null,["# Directions API (Legacy) overview\n\n**European Economic Area (EEA) developers** If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. Functionality varies by region. [Learn more](/maps/comms/eea/faq).\n\nThe Directions API (Legacy) is a service that accepts an HTTP request and returns JSON or XML-formatted directions between locations.\n\nWhy use the Directions API\n--------------------------\n\nWith the Directions API, you can get directions for several modes of\ntransportation, such as transit, driving, walking, or bicycling.\n\nWhat you can do with the Directions API?\n----------------------------------------\n\nWith the Directions API, you can calculate directions between locations,\nincluding the following details:\n\n- Directions for several modes of transportation, including transit, driving, walking or bicycling.\n- Multipart directions using a series of waypoints.\n- Specify origins, destinations, and waypoints in multiple ways, including as text strings (for example, \"Chicago, IL\" or \"Darwin, NT, Australia\"), place IDs, or latitude/longitude coordinates.\n\nHow the Directions API works\n----------------------------\n\nThe Directions API returns the most efficient routes when\ncalculating directions. The product factors in the following travel elements\nwhen determining the most efficient route:\n\n- Travel time (primary)\n- Distance\n- Number of turns\n\nThe following example request returns driving directions from Toronto, Ontario to Montreal, Quebec in JSON format: \n\n```scdoc\nhttps://maps.googleapis.com/maps/api/directions/json\n ?destination=Montreal\n &origin=Toronto\n &key=YOUR_API_KEY\n```\n\n### Resources\n\nThe following table summarizes the resources available through the\nDirections API along with the data it returns.\n\n\u003cbr /\u003e\n\n| Data resources | Data returned | Return format |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------|\n| [Directions](/maps/documentation/directions/get-directions#DirectionsRequests) Supply origins and destinations in the form of place IDs, addresses, or latitude/longitude coordinates. See [required parameters](/maps/documentation/directions/get-directions#required-parameters) for details. | Detailed directions, broken into routes, legs, and steps. See [Directions responses](/maps/documentation/directions/get-directions#DirectionsResponses) for details. | - JSON - XML |\n\n\u003cbr /\u003e\n\nHow to use the Directions API\n-----------------------------\n\n|---|---------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 1 | **Get set up.** | Start with [Set up your Google Cloud project](/maps/documentation/directions/cloud-setup) and complete the setup instructions that follow. |\n| 2 | **Try the demo** | Once you have an API key and a cloud project you try out the directions demo at no charge. See [The Directions API demo](/maps/documentation/directions/start). |\n| 3 | **Build a request** | See the example requests and learn about the available options you can supply, such as travel modes, waypoints, and route restrictions. See [Directions examples](/maps/documentation/directions/get-directions#ExampleRequests). |\n| 4 | **Understand response basics** | Explore the data responses to prepare to use directions data for your app. See [Directions responses](/maps/documentation/directions/get-directions#DirectionsResponses) for details. |\n| 5 | **Incorporate direction data into your own app!** | You can use this data to calculate travel distance and time. |\n\n#### Available client libraries\n\nCall this API in the language of\nyour choice through one of the following client libraries:\n\n- [Java\n Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-java)\n- [Python\n Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-python)\n- [Go Client\n for Google Maps Services](https://github.com/googlemaps/google-maps-services-go)\n- [Node.js\n Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-js)\n\nThe Java Client, Python Client, Go Client and Node.js Client for Google Maps\nServices are community-supported client libraries, open sourced under the\n[Apache 2.0 License](http://www.apache.org/licenses/LICENSE-2.0).\nDownload them from GitHub, where you can also find installation instructions and sample code.\n\nWhat's next\n-----------\n\n- **Start using the Directions API** : Go to [Get started](/maps/documentation/directions/start).\n- **Start making Directions requests** : Go to [Get\n directions](/maps/documentation/directions/get-directions).\n- **Follow best practices** : Go to [Web service best\n practices](/maps/documentation/directions/web-service-best-practices)."]]
