5.1. Construindo requisições para a Distance Matrix API
Antes de começar a usar a Distance Matrix API, é necessário utilizar a Authentication API para obter o token de autentificação.
Os seguintes headers são necessários:
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer token'
Onde token é o token obtido no processo de autenticação.
Em body serão enviados todos os parâmetros para resolver o problema logístico.
A Distance Matrix API trabalha de forma assíncrona. Ou seja, ao enviar o problema será retornado um ID. Com esse ID será possível consultar a reposta no futuro ou o status do processamento. A API possui os seguintes endpoints:
https://api.maplink.global/matrix/v1/problems - POST
Usado para enviar o problema logístico. Um ID será retornado para a consulta.https://api.maplink.global/matrix/v1/events?jobId={{matrixID}} - GET
Retorna todos os estados desde o recebimento da requisição até o sua conclusão.https://api.maplink.global/matrix/v1/jobs/{{matrixID}} - GET
Retorna o estado atual do processamento da requisição.https://api.maplink.global/matrix/v1/solutions/{{matrixId}} - GET
Retorna o resultado do planejamento logístico.
Nota: Os IDs das soluções ficam disponíveis para consulta durante o prazo de 7 dias.