Descripción general de la API de Distance Matrix

La API de Distance Matrix es un servicio que acepta una solicitud HTTPS que contiene los orígenes y destinos para un medio de transporte determinado. Para cada combinación de origen y destino, muestra la distancia y la duración del viaje.

Por qué usar la API de Distance Matrix

Puedes usar la API de Distance Matrix para ayudar a determinar las rutas de viaje más eficientes entre varios orígenes y destinos posibles. Por ejemplo, qué trabajadores enviar a los sitios de trabajo o desde qué almacenes enviar paquetes.

Qué puedes hacer con la API de Distance Matrix

Con la API de Distance Matrix, puedes proporcionar la distancia y el tiempo de viaje para una matriz de orígenes y destinos. Puedes especificar varias opciones, incluidos los medios de transporte, como en automóvil, en bicicleta, en transporte público o a pie, además de los medios en transporte público, como autobús, metro, tren, tranvía o tren.

La API de Distance Matrix proporciona información basada en la ruta recomendada entre el inicio y los puntos de destino. Puedes solicitar estos tipos de datos de distancia:

  • Distancia de un medio de transporte seleccionado
  • Distancia en kilómetros o millas
  • Tiempo de viaje estimado en tráfico

mapa que muestra el origen y los destinos en un mapa y en la respuesta de la API

Cómo funciona la API de Distance Matrix

La API de Distance Matrix usa cualquier cantidad de orígenes (puntos de partida) y destinos, y muestra la distancia y el tiempo de viaje entre cada origen y todos los destinos solicitados, a partir del primer origen en la solicitud y avanzando paso a paso hasta el siguiente.

Por ejemplo, si tu solicitud especifica A y B como orígenes, y C y D como destinos, muestra las distancias y el tiempo de viaje en este orden:

  • De A a C
  • De la A a la D
  • B a C
  • De B a D

En el siguiente ejemplo, se muestra una solicitud para dos orígenes: Washington, D.C. y Boston, con un solo destino, Ciudad de Nueva York, NY, en formato JSON:

https://maps.googleapis.com/maps/api/distancematrix/json
  ?destinations=New%20York%20City%2C%20NY
  &origins=Washington%2C%20DC%7CBoston
  &units=imperial
  &key=YOUR_API_KEY

Recursos

En la siguiente tabla, se resumen los recursos disponibles a través de la API de Distance Matrix junto con los datos que muestra.

Recursos de datos Datos mostrados Formato de devolución
Matriz de distancia

Proporciona orígenes y destinos en forma de IDs de lugar, direcciones o coordenadas de latitud y longitud.

  • Distancia y tiempo de viaje entre cada origen y cada destino
  • La duración en el tráfico si especificaste el modo en automóvil y una hora de salida
  • JSON
  • XML

Cómo usar la API de Distance Matrix

1 Prepárate. Para comenzar, consulta Configura tu proyecto de Google Cloud y completa las instrucciones de configuración que se indican a continuación.
2 Prueba una solicitud de Distance Matrix Una vez que tengas una clave de API, podrás comenzar a probar la API de Distance Matrix directamente desde tu navegador. Consulta Solicitudes de ejemplo en la guía de introducción para ver ejemplos.
3 Cómo redactar una solicitud más compleja Intenta realizar una solicitud que proporcione varios orígenes y destinos. Obtén información sobre los parámetros opcionales para limitar los cálculos, como una hora de salida específica, o las restricciones de ruta. Consulta Parámetros opcionales en la guía Solicitud y respuesta de Distance Matrix.
4 Comprende los conceptos básicos de las respuestas Explora las respuestas de datos y prepárate para usar los datos de Distance Matrix en tu app. Consulta Respuestas de Distance Matrix para obtener más detalles.
5 Incorpora datos de matrices de distancia 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 mediante 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 basadas en la licencia Apache 2.0 que asisten a la comunidad. Descárgalos desde GitHub, donde también encontrarás instrucciones de instalación y código de muestra.

Próximos pasos