Construindo requisições para a Distance Matrix API
Antes de começar a usar a API, será necessário obter o token de autenticação.
Os seguintes headers serão necessários, onde a palavra token deverá ser substiuída pelo token obtido no processo de autenticação:
--header 'Content-Type: application/json' \ --header 'Authorization: Bearer token'
Em body serão enviados todos os parâmetros para resolver o cálculo da matriz de distâncias.
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 resposta no futuro ou o status do processamento.
A API possui os seguintes endpoints, onde o termo {{matrixId}}
deve ser substítuido pelo ID do problema a ser consultado:
- 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 da matriz de distâncias.
Nota: Os IDs das soluções ficam disponíveis para consulta durante o prazo de 7 dias.