Cálculo de rotas por coordenadas: guia para frotas

Latitude e longitude: comece pelos pontos corretos

Coordenadas ajudam a localizar um endereço com precisão, mas o ponto escolhido precisa representar o acesso do veículo. O centro de um galpão, uma entrada de pedestres ou uma rua paralela podem gerar uma rota inadequada. Revise o portão de entrada e o lado da via nas primeiras integrações.

Na API Pedágios, o endpoint /api/coordenadas/v3 recebe pares na ordem [latitude, longitude]. A geometria GeoJSON da resposta utiliza a convenção de coordenadas do GeoJSON; não reutilize uma estrutura na outra sem conferir a documentação. Mantenha casas decimais suficientes e evite transformar os números em texto formatado com vírgula.

O exemplo abaixo é um corpo de requisição para dois pontos. As coordenadas servem para demonstrar o formato, e não constituem recomendação de trajeto para um caminhão específico.

POST /api/coordenadas/v3
Content-Type: application/json
Authorization: SUA_CHAVE

{
  "pontos": [[-23.5505, -46.6333], [-22.9068, -43.1729]],
  "veiculo": { "tipo": "caminhao", "eixos": 5 }
}

Consulte: Documentação da API Pedágios

Categoria de pedágio não substitui restrição de caminhão

Informar cinco eixos pode selecionar uma tarifa, mas isso não demonstra que a rota respeitou altura, peso, largura, carga perigosa ou restrições municipais. Esses dados precisam ser suportados pelo motor de roteamento e preenchidos conforme o contrato de cada API.

Na API Pedágios, o campo veiculo é documentado para o cálculo de custos por categoria. Ele não deve ser interpretado como garantia de trajeto homologado para as dimensões ou o peso da carga. Quando a operação depende dessas restrições, utilize um serviço que documente esse suporte e valide sua cobertura na região.

Consulte: Documentação da API Pedágios · HERE Routing API: roteamento de caminhões

Google Maps, HERE e TomTom: o que verificar

A referência atual do Google Routes inclui o modo TRUCK e orienta o preenchimento dos atributos do veículo. Confirme a disponibilidade do recurso e da cobertura aplicável ao seu projeto. Não trate uma chamada DRIVE como equivalente a roteamento de caminhão.

HERE documenta parâmetros como altura e peso no modo de caminhão. TomTom também documenta parâmetros de veículo no serviço Calculate Route. A existência do parâmetro é o início da análise: teste ruas, acessos e restrições conhecidas nas regiões em que a frota opera.

Consulte: Google Routes API: modos de viagem · HERE Routing API: roteamento de caminhões · TomTom Routing API: cálculo de rotas · Documentação da API Pedágios

Como medir precisão e latência antes de contratar

Escolha uma amostra representativa e mantenha iguais os pontos, o horário de consulta e as opções enviadas. Para precisão, compare acessos, distância, pedágios encontrados e restrições conhecidas. Anote cada divergência e investigue se veio da entrada, do mapa ou da regra de cálculo.

Para latência, execute a medição a partir do servidor que fará a integração. Registre a mediana e o percentil 95, além dos erros e timeouts. Uma única chamada rápida não caracteriza o comportamento em produção; o resultado também depende da quantidade de pontos e do tamanho da resposta.

Não há, neste guia, um benchmark independente que sustente um ranking de menor latência. A melhor compra é a que satisfaz os requisitos medidos no seu cenário, com preço e limites compreendidos.

• Teste rotas urbanas, rodoviárias, com paradas e ida e volta.
• Registre as mesmas opções para permitir reprodução do teste.
• Avalie o custo de consultas extras ao recalcular uma viagem.
• Defina o comportamento do sistema quando a API estiver indisponível.

Conecte a rota ao orçamento

Depois de validar o itinerário, use a categoria correta para estimar o pedágio e acrescente combustível e demais custos operacionais. Ao calcular a volta, não dobre automaticamente o total da ida: o sentido de cobrança e o trajeto podem mudar.

A API Pedágios documenta retorno e alternativas de rota. Confira o contrato do endpoint escolhido, pois as opções não são idênticas em todos os serviços. Para custos regulatórios de transporte, consulte também o guia de tabela ANTT.

Consulte: Documentação da API Pedágios · Tabela ANTT e piso mínimo de frete

Perguntas frequentes