Descripción general de la API de Distance Matrix

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

Por qué usar la API de Distance Matrix

Puedes usar la API de Distance Matrix para 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 de 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 los puntos de partida y de destino. Puedes solicitar los siguientes tipos de datos de distancia:

  • Distancia para un medio de transporte seleccionado
  • Distancia en kilómetros o millas
  • Tiempo estimado de viaje con 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, comenzando por el primer origen en la solicitud y pasando paso a paso al 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
  • B a D

En el siguiente ejemplo, se muestra una solicitud para dos orígenes: Washington, D.C. y Boston, con un solo destino, la 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 se muestran.

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.

  • La distancia y el 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. Comienza con Configura tu proyecto de Google Cloud y completa las instrucciones de configuración que aparecen a continuación.
2 Prueba una solicitud de matriz de distancia 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 muestra en la guía de introducción para ver ejemplos.
3 Cómo redactar una solicitud más compleja Prueba con una solicitud que proporcione múltiples 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 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 a fin de prepararte para usar los datos de matriz de distancia en tu app. Consulta Respuestas de matriz de distancia para obtener más detalles.
5 Incorpora datos de matrices de distancia a tu propia app Puedes utilizar estos datos para calcular la distancia y el tiempo de viaje.

Bibliotecas cliente disponibles

Llama a esta API en el lenguaje que desees 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 que cuentan con asistencia de la comunidad y que se rigen por la licencia Apache 2.0. Descárgalos desde GitHub, donde también encontrarás instrucciones de instalación y código de muestra.

Próximos pasos