O que uma API de pedágio entrega?
Uma API de pedágio transforma origem, destino, data e configuração do veículo em dados que outros sistemas podem consumir. A resposta do Geodagio separa distância, cobranças encontradas, total e estado de revisão.
A API Geodagio calcula a rota, associa praças ou pórticos ao trajeto e aplica a tarifa oficial vigente para a classe informada.
Dados devolvidos por cálculo
- Distância
- Quilometragem rodoviária devolvida em metros para cálculo exato.
- Pedágios
- Sequência de cobranças, valor individual e total quando precificado.
- Correspondência
- Distância do match, confiança e resolução de sentido.
- Revisão
- Motivos explícitos quando tarifa, rodovia ou sentido exigem conferência.
POST /api/v1/routes/calculate
Idempotency-Key: calculo-pedido-48391
Authorization: Bearer <token>
{ "origin": "Campinas, SP", "destination": "Curitiba, PR", "vehicle": { "axleCount": 2, "vehicleClassCode": "CAR" }, "calculationDate": "2026-08-21" }
Como o Geodagio evita totais enganosos
O total só é apresentado quando as cobranças estão precificadas e o sentido está resolvido. Se faltar tarifa oficial ou houver ambiguidade, o status muda para revisão e a resposta explica o motivo.
- tarifas versionadas por período de vigência;
- idempotência para evitar consumo e cálculo duplicados;
- isolamento de dados por empresa;
- trilha de fonte e referência oficial;
- sinais externos usados apenas como apoio de auditoria.
Quem usa API de pedágio e quilometragem
O contrato atende transportadoras, embarcadores, plataformas de frete, operadores logísticos, TMS, ERPs e equipes que precisam comparar custo planejado e realizado.
Principais fluxos
- cotação de frete com custo rodoviário;
- planejamento e auditoria de viagens;
- simulação por tipo de veículo e eixos;
- processamento de planilhas com múltiplas rotas;
- conciliação e análise de divergências.
Comece pela documentação técnica
Consulte o contrato OpenAPI, códigos de erro e regras de autenticação antes de integrar. Para lotes extensos, use a importação observável em vez de disparar requisições concorrentes sem controle.
Pronto para avaliar?
Abra o console ou consulte o contrato completo da API.