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 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 en el 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, comenzando con el primer origen de la solicitud y avanzando paso a paso al 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 la A a la 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 mediante las Distance Matrix API junto con los datos que se muestran.
Recursos de datos | Datos que se muestran | Formato de devolución |
---|---|---|
Distance Mat
Proporciona los orígenes y destinos en forma de IDs de lugares, 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 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 primeros pasos para ver 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 restricciones de 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 los datos para prepararte para usar los datos de la matriz de distancias en tu app. Consulta Respuestas de la matriz de distancias para obtener más información. |
5 | Incorpora datos de matriz de distancias 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 idioma que elijas a través de una de las siguientes bibliotecas cliente:
- Java Cliente de los servicios de Google Maps
- Python Cliente de los servicios de Google Maps
- Biblioteca 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 según la Licencia Apache 2.0 que cuentan con asistencia de la comunidad. Descargarlas desde GitHub, donde también encontrarás instrucciones de instalación y código de muestra
¿Qué sigue?
- Comenzar a usar Distance Matrix: Ve a Comenzar.
- Comenzar con las solicitudes y respuestas de muestra: Ve a Distance Matrix solicitud y respuesta
- Sigue las prácticas recomendadas: Ve a Prácticas recomendadas para servicios web Prácticas recomendadas.