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
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. |
|
|
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:
- Cliente de Java para los servicios de Google Maps
- Cliente de Python para los servicios de Google Maps
- Cliente de Go para los servicios de Google Maps
- Cliente de Node.js para los servicios de Google Maps
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
- Comenzar a usar Distance Matrix: Ve a Comenzar.
- Comenzar con 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.