Descripción general de la API de Distance Matrix

La API de Distance Matrix es un servicio que acepta solicitudes HTTPS que incluyen los orígenes y destinos de un medio de transporte determinado. Por 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 la ubicación de viajes entre varios orígenes y destinos posibles. Para 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 medio de transporte, como en automóvil, bicicleta, transporte público o a pie, así como medios de transporte, como autobús, metro, tren, tranvía o tren

La API de Distance Matrix proporciona información sobre la ruta recomendada entre el punto de inicio y el de 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 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 uno de origen y todos los destinos solicitados, comenzando con el primer origen en la solicitud y se procede paso a paso a la 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 la A a la C
  • De la A a la D
  • De 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, 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 mediante las la API de Distance Matrix junto con los datos que se muestran.

Recursos de datos Datos mostrados Formato de devolución
Distance Mat

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

  • La distancia y la duración del 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. Para comenzar, configura tu Proyecto de Google Cloud y completa la configuración instrucciones que se detallan 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 muestra en la guía de primeros pasos para ver ejemplos.
3 Cómo redactar una solicitud más compleja Prueba con una solicitud que proporcione varios orígenes y destinos. Aprendizaje sobre parámetros opcionales para limitar los cálculos, como un la hora de salida o las restricciones de la ruta. Consulta los Parámetros opcionales. de la guía Solicitud y respuesta de Distance Matrix.
4 Comprende los conceptos básicos de las respuestas Explora las respuestas de datos para prepararte para usar los datos de matriz de distancia en tu app. Consulta Respuestas de Distance Matrix para conocer los detalles.
5 Incorpora datos de matriz de distancia en tu propia app. Puedes usar estos datos para calcular la distancia y la duración del viaje.

Bibliotecas cliente disponibles

Llama a esta API en el lenguaje de que elijas mediante una de las siguientes bibliotecas cliente:

Los clientes de Java, Python, Go y Node.js para Google Maps Los servicios son bibliotecas cliente con asistencia de la comunidad, de código abierto en el Licencia 2.0 de Apache. Descárgalas desde GitHub, donde también encontrarás instrucciones de instalación y código de muestra.

¿Qué sigue?