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 lugar para distintos 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 indicaciones entre ubicaciones, incluidos los siguientes detalles:

  • Instrucciones sobre cómo llegar a un destino en 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 waypoints 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 mostrados Formato de 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 información.

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 medios de transporte, puntos de referencia y restricciones de ruta. Consulta los 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 lenguaje que prefieras 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 que cuentan con la asistencia de la comunidad según la licencia Apache 2.0. Descárgalas desde GitHub, donde también encontrarás instrucciones de instalación y código de muestra.

¿Qué sigue?