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 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, incluido el medio de transporte, como en automóvil, bicicleta, transporte público o a pie, además de los medios de transporte público, como 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 inicio y finalización. Puedes solicitar los siguientes tipos de datos de distancia:
- Distancia de un medio de transporte seleccionado
- Distancia en kilómetros o millas
- Tiempo estimado de viaje con tráfico
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, desde el primer origen en la solicitud 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 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 único destino, 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 los orígenes y destinos en forma de ID de lugar, direcciones o coordenadas de latitud y longitud. |
|
|
Cómo usar la API de Distance Matrix
| 1 | Prepárate. | Comienza con Configura tu proyecto de Google Cloud y completa las siguientes instrucciones de configuració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 Ejemplos de solicitudes en la guía para comenzar a fin de obtener ejemplos. |
| 3 | Cómo redactar una solicitud más compleja | Prueba una solicitud que proporcione varios orígenes y destinos. Obtén información sobre los parámetros opcionales para restringir los cálculos, como una hora de salida especificada o las restricciones de rutas. Consulta los parámetros opcionales en la guía Solicitud y respuesta de Distance Matrix. |
| 4 | Conceptos básicos sobre las respuestas | Explora las respuestas de datos a fin de prepararte para usar la matriz de distancia en tu app. Consulta Respuestas de la matriz de distancia para obtener más detalles. |
| 5 | Incorpora datos de matriz de distancia a 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 elijas a través de una de las siguientes bibliotecas cliente:
- Cliente de Java para los servicios de Google Maps
- Cliente de Python para servicios de Google Maps
- Cliente de Go para los Servicios de Google Maps
- Cliente de Node.js para los servicios de Google Maps
El cliente de Java, el cliente de Python, el cliente de Go y el cliente de Node.js para los servicios de Google Maps son bibliotecas cliente de código abierto compatibles con la comunidad en virtud de la licencia Apache 2.0. Descárgalas de GitHub, donde también encontrarás instrucciones de instalación y código de muestra.
Próximos pasos
- Comenzar a usar Distance Matrix: Ve a Comenzar.
- Cómo comenzar con las solicitudes y respuestas de muestra: Ve a Solicitud y respuesta de Distance Matrix.
- Sigue las prácticas recomendadas: Consulta las Prácticas recomendadas para los servicios web.