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 la 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, como el medio de transporte (por ejemplo, automóvil, bicicleta, transporte público o a pie) y los tipos de transporte público (por ejemplo, autobús, metro, tren, tranvía o ferrocarril).

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

  • Distancia para un medio de transporte seleccionado
  • Distancia en kilómetros o millas
  • Tiempo estimado de viaje en el 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 de la solicitud y pasando por el siguiente.

Por ejemplo, si tu solicitud especifica A y B como orígenes, y C y D como destinos, se muestran 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 de dos orígenes: Washington, D.C. y Boston, con un solo destino, la ciudad de Nueva York, 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 distancias

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

  • Distancia y tiempo de viaje entre cada origen y cada destino
  • Duración en 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 se indican a continuación.
2 Cómo probar una solicitud de matriz de distancias 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 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 la ruta. Consulta Parámetros opcionales en la guía de 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 Distance Matrix en tu app. Consulta Respuestas de Distance Matrix para obtener más detalles.
5 Incorpora datos de matriz 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 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?