Trip

Armazenando rotas com Route Storage

A Route Storage é um novo recurso que pode ser utilizado em conjunto com a Trip API que permite armazenar por mais tempo a solução de rotas fixas.

Por padrão, as rotas ficam armazenadas por 7 dias. Com a Route Storage esse prazo pode ser estendido até 5 anos.  Esta nova funcionalidade foi desenvolvida especialmente para empresas que trabalham com rotas fixas, devido a contratos de gerenciamento de riscos com suas seguradoras, por exemplo.

Alguns fatores como a atualização dos mapas, novas vias ou pavimentação de vias existentes podem fazer com que a rota sofre alterações de tempos em tempos. Mas com o Route Storage, a rota armazenada vai permanecer sempre a mesma, sem nenhuma alteração.

Principais Funcionalidades

  • Armazenamento da rota com data especificada pelo cliente, com limite de até 5 anos;
  • Garantia de que as rotas armazenadas não sofrerão alterações;
  • Ganho de performance, pois a partir do momento em que a solução estiver armazenada em cache, não será necessário reenviar a requisição, diminuindo o tempo de resposta.

Para utilizar o recurso, basta informar o parâmetro expiryIn com a data em formato timestamp de até quando a rota deve ser armazenada.

Após isso, o ID da rota poderá ser consultada normalmente através do endpoint https://api.maplink.global/trip/v1/solutions/{tripid}

Não há necessidade de enviar rota novamente, basta usar o ID gerado.

Alteração e exclusão de rotas armazenadas

Caso haja necessidade de alterar a data final do armazenamento ou exclusão de alguma rota, o processo é feito via nossos canais de suporte.

Basta nos enviar um email para [email protected], incluindo o ID da rota a ser editado e o clientID usado para gerar a rota.

Exemplo – Armazenando e consultando rota com Route Storage

Nesse exemplo temos uma rota entre São Paulo e Campinas, onde adicionamos o parâmetro expiryIn com a data de 31/08/2025, em formato timestamp em milissegundos.

{
    "calculationMode": "THE_FASTEST",
    "points": [
        {
            "latitude": -23.580581,
            "longitude": -46.656743,
            "siteId": "SP"
        },
        {
            "latitude": -22.893165,
            "longitude": -47.064792,
            "siteId": "CAMPINAS"
        }
    ],
    "expiryIn": 1756648905000,
}

O ID da rota será retornado na resposta e poderá ser consultada normalmente até o dia 31/08/2025 no endpoint https://api.maplink.global/trip/v1/solutions/{tripid}