Descripción general de la API de Distance Matrix (heredada)

Desarrolladores del Espacio Económico Europeo (EEE)

Introducción

La API de Distance Matrix (heredada) es un servicio que acepta una solicitud HTTPS que contiene los puntos de partida y de destino para un medio de transporte determinado. Para cada combinación de origen y destino, devuelve la distancia y la duración del viaje.

Por qué usar la API de Distance Matrix (heredada)

Puedes usar la API de Distance Matrix (heredada) para determinar las rutas de viaje más eficientes entre varios orígenes y destinos posibles. Por ejemplo, qué trabajadores enviar a los lugares de trabajo o desde qué almacenes enviar paquetes.

Qué puedes hacer con la API de Distance Matrix (heredada)

Con la API de Distance Matrix (heredada), 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 (en automóvil, en bicicleta, en transporte público o a pie), así como los medios de transporte público (autobús, metro, tren, tranvía o ferrocarril).

La API de Distance Matrix (heredada) proporciona información basada en la ruta recomendada entre los puntos de partida y de llegada. Puedes solicitar los siguientes tipos de datos de distancia:

  • Distancia para un medio de transporte seleccionado
  • Distancia en kilómetros o millas
  • Duración estimada del 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 (heredada)

La API de Distance Matrix (heredada) usa cualquier cantidad de orígenes (puntos de partida) y destinos, y devuelve la distancia y la duración del viaje entre cada origen y todos los destinos solicitados, comenzando por el primer origen de la solicitud y continuando paso a paso hasta el siguiente.

Por ejemplo, si tu solicitud especifica A y B como orígenes, y C y D como destinos, devuelve las distancias y la duración del viaje en este orden:

  • De la A a la C
  • De la A a la D
  • B to C
  • B a D

En el siguiente ejemplo, se muestra una solicitud para dos orígenes, Washington, DC y Boston, con un solo 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 (heredada) junto con los datos que devuelve.

Recursos de datos Datos devueltos Formato de devolución
Matriz de distancia

Proporciona los orígenes y destinos en forma de 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 el tráfico si especificaste el modo de conducción y una hora de salida
  • JSON
  • XML

Cómo usar la API de Distance Matrix (heredada)

1 Inicia la configuración Comienza con Configura tu proyecto de Google Cloud y completa las instrucciones de configuración que se indican a continuació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 (heredada) directamente desde tu navegador. Consulta Solicitudes de ejemplo en la guía de introducción para ver ejemplos.
3 Redacta 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 Parámetros opcionales en la guía Solicitud y respuesta de matriz de distancia (heredada).
4 Comprende los conceptos básicos de las respuestas Explora las respuestas de datos para prepararte para usar los datos de la matriz de distancia en tu app. Consulta Respuestas de la matriz de distancia para obtener más detalles.
5 Incorpora datos de la 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 con 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 según la licencia Apache 2.0 que cuentan con asistencia de la comunidad. Descárgalas de GitHub, donde también puedes encontrar instrucciones de instalación y código de muestra.

¿Qué sigue?