Cómo utilizar la API de enrutamiento de TomTom para la hora estimada de llegada

Un tutorial sobre el uso de nuestra API para calcular una hora de llegada precisa

(Bre Teiko) (22 de octubre de 2020)

UN RESUMEN RÁPIDO DE LA API DE ENRUTAMIENTO

La API de enrutamiento es una herramienta poderosa que se puede utilizar para obtener direcciones precisas para diversos tipos de vehículos, con rutas como la más rápida, la más corta, la más emocionante, etc. También puede proporcionarle la forma geométrica de la ruta deseada y instrucciones.

Pero una característica de la API que se pasa por alto es la opción de obtener un resumen de las rutas solicitadas. Es útil mostrar posibilidades al usuario, como en este ejemplo: necesitamos encontrar el hospital o farmacia más cercanos. Al obtener los resúmenes, podemos ofrecer una mejor selección utilizando el ejemplo de enrutamiento de matriz que se encuentra aquí .

Otro caso de uso clásico para esto es una aplicación de viaje compartido. Calcular el mejor conductor a partir de una lista de proveedores repartidos por un área se vuelve complicado cuando no necesitamos crear rutas para comparar, ya que solo necesitamos la distancia de conducción o la hora estimada de llegada. Aquí es cuando el Resumen hace su magia.

El resumen se solicita con el siguiente parámetro:

El valor polilínea devolverá la representación gráfica de la ruta en una matriz de pares LatLng, mientras que el resumenOnly le dará una sección JSON adicional en la respuesta como esta :

Aquí hay algunos datos interesantes que diferencia a esta API en particular de otras:

  1. Puede ver que hay diferentes ETA sin tráfico, tráfico en vivo y tráfico histórico.
  2. Puede obtener rutas alternativas y ver cuánta desviación hay de la original.

NOTA: Las desviaciones y rutas alternativas solo están disponibles cuando una ruta inicial es calculado primero.

NOTA 2: El consumo de combustible se estima en. Pero si pasamos los modelos de consumo, ya sea para vehículos eléctricos o con motor de combustión, el cálculo se vuelve mucho más preciso.

Ahora, echemos un vistazo a un real- ejemplo de vida…

DIFERENTES TIPOS, DIFERENTES ETAS

Vamos a comprobar algunas ETA diferentes de nuestro hotel en el centro de Chicago. ¿Qué tal “La Quinta Inn”? Para este hotel, usaremos la ubicación:

Desde el hotel, nos gustaría encontrar un restaurante cercano, un restaurante de estilo criollo cajún. Para ello podemos utilizar la API de búsqueda de categorías [ https://developer.tomtom.com/search-api/search-api-documentation-search/category-search] para obtener una lista de posibles restaurantes alrededor del hotel (usando LatLng del hotel como el sesgo de posición).

Eliminando los datos no utilizados, obtenemos una pequeña lista. Este es el primer elemento:

Entonces Como puede ver, también obtenemos la distancia a nuestro hotel como parte del resultado. Pero este valor, en metros, es un punto de vista de la distancia directa, no la distancia real conduciendo o caminando. Puede replicar mis resultados ejecutando este comando Curl.

Para la distancia real de conducción utilizamos la API de enrutamiento, solicitando solo el Resumen y agregando la opción de calcular para diferentes tiempos de viaje. Este es el punto final de la API que podemos usar:

Lo que nos da:

Si bien esto es lo suficientemente bueno por ahora, necesitamos obtener aún MÁS rutas para comparar, y para eso nada es mejor que usar la API de enrutamiento de matriz.

OBTENER TODAS LAS RUTAS / RUTAS POSIBLES A MUCHOS DESTINOS

De la documentación en nuestro Portal para desarrolladores:

El servicio Matrix Routing permite el cálculo de una matriz de resúmenes de ruta para un conjunto de rutas definidas con ubicaciones de origen y destino.

  • Para cada origen dado, este servicio calcula el costo de enrutamiento desde ese origen a cada destino dado.
  • El conjunto de orígenes y el conjunto de destinos se pueden considerar como los encabezados de columna y fila de una tabla, mientras que cada celda de la tabla contiene los costos de enrutamiento desde el origen al destino de esa celda.

Los siguientes costos se calculan para cada ruta:

  • Tiempos de viaje
  • Distancias

Consulte la documentación completa aquí: https://developer.tomtom.com/routing-api/routing-api-documentation-matrix-routing/synchronous-matrix

Esto parece exactamente lo que necesitamos.

En nuestro caso vamos a calcular resúmenes de conducción y peatones para poder decidir si queremos caminar o conducir y dado que las solicitudes son lo suficientemente simples, no hay rutas complicadas aquí, entonces podemos usar la versión sincrónica: esperará una respuesta una vez que se hayan calculado todas las rutas.

NOTA: La versión sincrónica de la API de enrutamiento matricial expirará ter 60 segundos, así que asegúrese de usarlo solo con rutas pequeñas.

El punto final es una solicitud HTTP-POST. Esta es la URL que vamos a utilizar:

El cuerpo POST: Aquí configuraremos las solicitudes de las diferentes rutas (mismo origen, diferentes destinos). Sigue este formato:

Así que en en nuestro caso, este es nuestro cuerpo POST:

Con esta solicitud obtenemos el siguiente resultado, truncado con fines editoriales:

Para cada destino obtenemos un objeto de respuesta y su RouteSummary con la misma información necesaria que obtuvimos al ejecutar una llamada simple. Aquí vemos que el restaurante «Cajun Grill» es el más cercano a nosotros para conducir. Con esto podemos poblar una lista o una pantalla para el usuario. Intente cambiar el Modo de viaje a Peatón si desea una ruta a pie. Ex. Para rutas peatonales:

Usando esta solicitud , vemos que el restaurante Cajun Grill TAMBIÉN es el más cercano a nosotros a poca distancia, pero en el caso de que tengamos diferentes restaurantes para elegir, siempre podemos usar la API de Batch Routing para crear todas las rutas necesarias usando un solo call: https://developer.tomtom.com/routing-api/routing-api-documentation/batch-routing

De esta manera solo creamos las rutas que necesitamos mostrar al usuario.

EN RESUMEN

En este artículo, echamos un vistazo a la API de enrutamiento y cómo obtener ETA y conducción real o Caminando distancias a través del objeto Resumen en la respuesta de la API de Matrix Routing.

La API de Matrix Routing nos permite buscar diferentes resúmenes con una sola llamada donde podemos obtener dichas ETA de diferentes destinos.

Espero que este artículo le ayude a comprender mejor la API de enrutamiento de TomTom. Gracias por volver ¡Ading y Happy Mapping!

Para obtener más información sobre los servicios y las soluciones de TomTom para los servicios de movilidad y transporte de última milla, consulte la página de Movilidad y bajo demanda aquí .

Este artículo apareció originalmente en https://developer.tomtom.com/blog . El autor original es José José Rojas.

Deja una respuesta

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *