ForHosting KIT · Ferramentas para dev

Economia de tempo entre rotas, velocidades e desvios

A rota mais curta nem sempre é a mais rápida. Esta calculadora compara duas opções usando a distância e a velocidade média de cada uma e acrescenta qualquer penalidade fixa por desvio, parada, acesso ou atraso.

● BetaGrátis · no seu navegador

Executar grátis Ver a API

Use pelo WebAPIE-mailTelegramApp em breve

Ela apresenta a duração efetiva das duas rotas, identifica a alternativa mais veloz e mostra a economia absoluta e percentual. Você pode usá-la em viagens de carro, bicicleta ou barco, em entregas e em qualquer trajeto no qual somente a distância não conte toda a história.

Informe premissas comparáveis para as rotas

Comece informando a distância e uma velocidade média realista para as rotas A e B. As duas distâncias usam a unidade selecionada, e as duas velocidades compartilham outra unidade, mantendo a comparação coerente mesmo quando distância e velocidade pertencem a sistemas diferentes. A média deve representar toda a parte em movimento, e não um pico momentâneo do velocímetro. Em viagens rodoviárias, considere ruas urbanas, cruzamentos, trânsito e trechos lentos. Para ciclismo ou navegação, inclua terreno, vento e condições esperadas. Uma rota mais longa pode vencer quando permite uma velocidade sustentada maior; uma via supostamente rápida pode perder a vantagem se a média real for baixa. A distância pode ser zero para representar uma opção cujo único custo seja uma espera ou acesso fixo, mas a velocidade precisa ser maior que zero para que o tempo de viagem exista matematicamente.

Acrescente desvios e atrasos fixos

Dividir distância por velocidade calcula o tempo em movimento, porém muitas escolhas incluem atrasos que não crescem com a quilometragem. Informe esses atrasos em minutos na rota correspondente. A penalidade pode representar uma parada para abastecer, a caminhada desde um estacionamento distante, o check-in de uma balsa, uma praça de pedágio, uma conexão, uma obra conhecida ou o acesso extra até uma rodovia rápida. Cada rota tem sua própria penalidade opcional, cujo padrão é zero. A calculadora converte as unidades, calcula os minutos de deslocamento e só então soma o atraso específico. O resultado separa movimento, penalidade e total, permitindo conferir a conta. Prefira valores esperados a cenários otimistas. Quando um atraso for incerto, faça uma simulação baixa e outra alta para descobrir se a recomendação muda antes de tomar a decisão.

Entenda o resultado da economia

A rota mais rápida é aquela cujo tempo total fica menor após a inclusão da penalidade. A economia é a diferença absoluta entre os dois totais e, portanto, nunca é negativa. Se os valores não arredondados forem praticamente iguais, o resultado indicará empate. A resposta também mostra a economia como percentual do total da opção mais lenta, facilitando distinguir uma melhoria relevante de uma pequena diferença em uma viagem longa. Poupar dez minutos em um trajeto de vinte tem impacto diferente de poupar dez em oito horas. Os números seguem a precisão escolhida, enquanto a duração legível é arredondada para o segundo mais próximo. Esta é uma ferramenta de planejamento, não uma navegação ao vivo: ela não consulta trânsito, bloqueios, clima, horários nem restrições. Atualize médias e penalidades quando as condições mudarem e avalie segurança, confiabilidade, custo e acesso legal junto com o ganho de tempo.

Casos de uso

Comparar um atalho e uma rodovia

Verifique se a maior velocidade da rodovia compensa a distância e o acesso adicionais.

Planejar rotas de entrega

Inclua carga, portaria, pedágio ou desvios ao comparar duas opções recorrentes de entrega.

Avaliar alternativas de bicicleta

Compare um caminho direto e lento com outro mais longo que permita manter melhor ritmo.

Perguntas frequentes

Como o tempo da rota é calculado?

O tempo em movimento é a distância dividida pela velocidade média. Depois, os minutos de desvio são somados ao total.

Qual rota recebe a penalidade de desvio?

Cada rota tem uma penalidade opcional. Informe minutos extras na rota A, na B, nas duas ou em nenhuma.

Posso combinar sistemas de unidades diferentes?

Sim. Selecione uma unidade para as distâncias e outra para as velocidades; a calculadora faz a conversão antes da comparação.

O que acontece quando as rotas levam o mesmo tempo?

O campo faster_route retorna tie, e a economia de tempo é zero.

A ferramenta usa dados de trânsito ao vivo?

Não. Esta calculadora é determinista e não acessa a rede. Forneça médias e penalidades adequadas às condições previstas.

Quanto custa uma solicitação API?

Cada solicitação API custa US$ 0,002. A calculadora no navegador usa a mesma aritmética determinista.

Para desenvolvedores — acesso via API

Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.

Endpoint

POSThttps://api.kit.forhosting.com/travel/route-time-savings

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

Chame do seu código

curl -X POST https://api.kit.forhosting.com/travel/route-time-savings \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"route_a_distance":120,"route_a_speed":80,"route_b_distance":135,"route_b_speed":100}'

const res = await fetch("https://api.kit.forhosting.com/travel/route-time-savings", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "route_a_distance": 120,
    "route_a_speed": 80,
    "route_b_distance": 135,
    "route_b_speed": 100
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/travel/route-time-savings",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "route_a_distance": 120,
    "route_a_speed": 80,
    "route_b_distance": 135,
    "route_b_speed": 100
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/travel/route-time-savings", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"route_a_distance":120,"route_a_speed":80,"route_b_distance":135,"route_b_speed":100}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"route_a_distance":120,"route_a_speed":80,"route_b_distance":135,"route_b_speed":100}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/travel/route-time-savings", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemplo de requisição

{
  "route_a_distance": 120,
  "route_a_speed": 80,
  "route_b_distance": 135,
  "route_b_speed": 100
}

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "travel.route_time_savings",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.

Preço

por chamadaUS$ 0,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

Erros

HTTP	Código	O que significa
`401`	`unauthorized`	Token ausente ou inválido. Confira o header Authorization.
`402`	`insufficient_balance`	Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
`404`	`unknown_type`	Esse tipo de tarefa não existe. Confira o campo type no catálogo.
`429`	`rate_limited`	Muitas requisições em pouco tempo. Espere um instante e tente de novo.

Ver a documentação completa do KIT →