Creación de solicitudes para la Distance Matrix API
Antes de empezar a utilizar la API, deberá obtener el token de autenticación.
Se requerirán las siguientes headers, donde la palabra token debe sustituirse por el token obtenido en el proceso de autenticación:
--header 'Content-Type: application/json' \ --header 'Authorization: Bearer token'
Todos los parámetros para resolver el cálculo de la matriz de distancia se enviarán en el body.
La Distance Matrix API funciona de forma asíncrona. En otras palabras, se devolverá un ID cuando se envíe el problema. Con este ID puede comprobar la respuesta en el futuro o el estado de tramitación.
La API tiene los siguientes endpoints, en los que el término {{matrixId}}
debe sustituirse por el ID del problema que se desea consultar:
- https://api.maplink.global/matrix/v1/problems – POST
Se utiliza para enviar el problema logístico. Se devolverá un ID para la consulta. - https://api.maplink.global/matrix/v1/events?jobId={{matrixID}} – GET
Devuelve todos los estados desde la recepción de la solicitud hasta su finalización. - https://api.maplink.global/matrix/v1/jobs/{{matrixID}} – GET
Devuelve el estado actual de procesamiento de la solicitud. - https://api.maplink.global/matrix/v1/solutions/{{matrixId}} – GET
Devuelve el resultado de la matriz de distancias.
Nota: Los ID de solución pueden consultarse durante un periodo de 7 días.