Descripción general de la API de Directions

La API de Directions es un servicio que acepta una solicitud HTTP y muestra instrucciones sobre cómo llegar entre ubicaciones en 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, vehículos particulares, a pie o en bicicleta.

¿Qué puedes hacer con la API de Directions?

Con la API de Directions, puedes calcular instrucciones sobre cómo llegar entre ubicaciones, incluidos los siguientes detalles:

  • Instrucciones sobre cómo llegar a un destino en varios medios de transporte, como transporte público, automóvil, a pie o en bicicleta
  • Indicaciones de varias partes con una serie de waypoints.
  • Especifica los orígenes, los destinos y los puntos de referencia de varias maneras, como cadenas de texto (por ejemplo, "Chicago, IL" o "Darwin, NT, Australia"), IDs de lugares o coordenadas de latitud y longitud.

Cómo funciona la API de Directions

La API de Directions muestra las rutas más eficientes cuando se calculan las instrucciones sobre cómo llegar. El producto considera los siguientes elementos de viaje cuando determina la ruta más eficiente:

  • Tiempo de viaje (principal)
  • Distancia
  • Cantidad de giros

En el siguiente ejemplo, se muestran las instrucciones sobre cómo 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 muestra.

Recursos de datos Datos que se muestran Formato de la devolución
Directions

Proporciona los orígenes y destinos en forma de IDs de lugares, 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 instrucciones para obtener más detalles.
  • JSON
  • XML

Cómo usar la API de Directions

1 Prepárate. Comienza con Configura tu proyecto de Google Cloud y completa las instrucciones de configuración que se indican a continuación.
2 Prueba la demostración Una vez que tengas una clave de API y un proyecto de nube, podrás probar la demostración de instrucciones sin cargo. Consulta la demostración de la API de Directions.
3 Cómo crear una solicitud Consulta las solicitudes de ejemplo y obtén información sobre las opciones disponibles que puedes proporcionar, como los modos de viaje, los puntos de referencia y las restricciones de ruta. Consulta ejemplos de instrucciones sobre cómo llegar.
4 Comprende los conceptos básicos de las respuestas Explora las respuestas de datos para prepararte para usar los datos de instrucciones en tu app. Consulta Respuestas de instrucciones para obtener más información.
5 Incorpora datos de dirección 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 de código abierto según la Licencia Apache 2.0 que cuentan con asistencia de la comunidad. Descargarlas desde GitHub, donde también encontrarás instrucciones de instalación y código de muestra

¿Qué sigue?