Distância total multiparada
Nova York–Filadélfia 120 km, Washington 140 km e Richmond 110 km somam 370 km, com acumulados de 120, 260 e 370 km. Informe as distâncias dos seus trechos para obter o total da rota e a quilometragem em cada parada. Grátis no seu navegador.
- Grátis
- Funciona no seu navegador
- Sem cadastro
- Seus dados não saem do seu aparelho
Executar grátis
Exemplo resolvido
- Origem
- New York
- Total
- 370 km
- Total (km)
- 370
- Total (mi)
- 229,907341
- Quantidade de trechos
- 3
Planejar uma viagem por várias cidades, um tour de entregas ou um itinerário com vários hotéis costuma começar com uma lista de distâncias de trecho em que você já confia — de um app de mapas, um guia impresso ou uma planilha do despachante. O que ainda falta é um total limpo e uma leitura de quilometragem acumulada em cada parada para que paradas de combustível, pausas e divisão de custos permaneçam honestas. Esta calculadora de distância total de rota multiparada aceita uma lista ordenada de distâncias de trecho, opcionalmente rotuladas com nomes de destino, soma-as em um total de rota e monta uma tabela acumulada no estilo odômetro desde a origem até o último ponto de passagem.
Como funcionam a distância de itinerário multiparada e a quilometragem acumulada
Uma rota multiparada aqui é um itinerário aberto e ordenado de um ou mais trechos. Cada trecho é uma distância não negativa que você já mediu ou estimou entre paradas consecutivas — de cidade a cidade, depósito a cliente, hotel a hotel. A capacidade não consulta coordenadas nem inventa caminhos rodoviários; trata suas distâncias como fonte da verdade e concentra-se na contabilidade que planejadores realmente reutilizam.
Com n trechos há n mais uma paradas: a parada zero é a origem com quilometragem acumulada zero, e após cada trecho concluído a soma parcial avança pela distância desse trecho. A distância total da rota é simplesmente a soma de todos os trechos. Essa identidade é a mesma lógica de odômetro que motoristas usam ao anotar marcos em um diário de viagem: começar em zero, somar cada segmento, e a leitura na última parada iguala o total da viagem.
Rótulos opcionais em cada trecho nomeiam o destino daquele segmento; uma string opcional de origem nomeia a primeira parada para que a tabela acumulada fique legível na interface sem um segundo join. Trechos de comprimento zero são permitidos (parada no mesmo local ou placeholder), mas distâncias negativas são rejeitadas porque a quilometragem não pode retroceder neste modelo.
Onde totais de rota multiparada se encaixam em produtos e pipelines
Combine com ferramentas de volume de combustível ou custo de viagem quando precisar de estimativas de despesa; com velocidade média ou ETA quando precisar de tempo. Não use isto para distância de grande círculo a partir de latitude e longitude — essa é outra intenção de busca atendida por ferramentas geográficas de polilinha que medem trechos haversine. Aqui o usuário já possui as distâncias e quer apenas totais de itinerário e quilometragem acumulada.
Validação falha não consome saldo. Mantenha listas modestas para UX interativa, fixe totais arredondados nos testes e você obtém um bloco pequeno e auditável para cada canal que o KIT já atende.
Casos de uso
Tabelas de itinerário de road trip
Cole distâncias de trecho cidade a cidade, rotule cada parada e publique a distância total mais a quilometragem acumulada em cada noite de hotel.
Progresso de entregas multiparada
Some comprimentos de depósito a parada e entre paradas e mostre aos motoristas quantas milhas restam após cada trecho concluído.
Pré-passos de custo e combustível da viagem
Calcule uma única distância total a partir de trechos conhecidos antes de chamar calculadoras de volume de combustível, custo de combustível ou orçamento de viagem.
Perguntas frequentes
Como a distância total de rota multiparada é calculada?
Cada distância de trecho é validada como número finito não negativo e então somada. A quilometragem acumulada na parada k é a soma dos primeiros k trechos; a origem começa em zero.
Preciso de coordenadas GPS ou endereços?
Não. Forneça as distâncias de trecho que você já tem (de mapas, manifestos ou estimativas). Esta ferramenta não geocodifica nem mede caminhos de grande círculo a partir de lat/lon.
Qual é o número mínimo de trechos?
É necessário pelo menos um trecho (duas paradas: origem e destino).
Posso misturar quilômetros e milhas em um mesmo pedido?
Não. Todas as distâncias de trecho devem compartilhar a mesma unidade, escolhida com unit km ou mi.
Posso dar nome a cada parada?
Sim. Cada trecho pode levar o nome do lugar onde termina, e você também pode nomear o ponto de partida. Os nomes só identificam a tabela de acumulados; nunca mudam as distâncias nem o total.
Ferramentas relacionadas
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
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/multi-stop-route-distance \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"legs":[{"distance":120,"label":"Philadelphia"},{"distance":140,"label":"Washington DC"},{"distance":110,"label":"Richmond"}]}'const res = await fetch("https://api.kit.forhosting.com/travel/multi-stop-route-distance", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"legs": [
{
"distance": 120,
"label": "Philadelphia"
},
{
"distance": 140,
"label": "Washington DC"
},
{
"distance": 110,
"label": "Richmond"
}
]
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/travel/multi-stop-route-distance",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"legs": [
{
"distance": 120,
"label": "Philadelphia"
},
{
"distance": 140,
"label": "Washington DC"
},
{
"distance": 110,
"label": "Richmond"
}
]
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/travel/multi-stop-route-distance", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"legs":[{"distance":120,"label":"Philadelphia"},{"distance":140,"label":"Washington DC"},{"distance":110,"label":"Richmond"}]}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"legs":[{"distance":120,"label":"Philadelphia"},{"distance":140,"label":"Washington DC"},{"distance":110,"label":"Richmond"}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/travel/multi-stop-route-distance", 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
{
"legs": [
{
"distance": 120,
"label": "Philadelphia"
},
{
"distance": 140,
"label": "Washington DC"
},
{
"distance": 110,
"label": "Richmond"
}
]
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "travel.multi_stop_route_distance",
"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
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. |
Notas técnicas
Escolha quilômetros ou milhas estatutárias; cada resposta bem-sucedida também devolve total_km e total_mi.
Como funcionam a distância de itinerário multiparada e a quilometragem acumulada
Quando a unidade é quilômetros, total e total_km coincidem e total_mi é derivado com o fator internacional de 1.609344 quilômetros por milha estatutária; quando a unidade é milhas, a conversão dual corre no sentido inverso.
Contrato de entrada, unidades, aliases e erros de validação
Cada entrada pode ser um objeto com campo distance obrigatório e label opcional, ou um número finito simples tratado como distância sem rótulo. Legs vazios, mais de quinhentas entradas ou uma unidade desconhecida falham na validação antes de qualquer soma e não são cobrados. Trocar a unit sem converter os números é um erro comum do cliente — se sua planilha está em milhas, envie unit mi em vez de deixar o padrão. Envie por POST um corpo JSON com um array legs obrigatório de pelo menos uma entrada. Os valores de distância devem ser finitos e não negativos; strings vazias, NaN, Infinity e campos distance ausentes falham com invalid_input indicando a linha. O array aceita aliases de transporte segments, stages e distances para que clientes móveis e de planilhas mapeiem colunas sem reestruturar. A unit opcional seleciona a unidade de entrada e do total principal: km (padrão) ou mi; aliases incluem distance_unit. O origin opcional (aliases start, start_label, origin_label) apenas rotula a parada zero e nunca altera a matemática. Uma carga útil bem-sucedida devolve total e unit; sempre total_km e total_mi; leg_count e stop_count; legs como lista ordenada de índice do trecho, distância, quilometragem acumulada após esse trecho e label opcional; cumulative_at_stops com índice da parada, quilometragem acumulada e label opcional da origem ao último ponto; mais strings formula e method para auditoria e documentação. O preço é um valor fixo US$ 0,002 por item bem-sucedido na API; o caminho tier-A no navegador é gratuito para checagens interativas.
Onde totais de rota multiparada se encaixam em produtos e pipelines
Use este endpoint sempre que distâncias de trecho já existam e você precise de um total transparente mais quilometragem acumulada por parada: planejadores de road trip que colam comprimentos cidade a cidade de uma exportação de mapa, esboços de entrega multiparada antes de módulos de combustível e custo, blogs de viagem que publicam tabela de itinerário com distância em andamento, painéis de frota que enriquecem lista de paradas com progresso estilo odômetro, e exercícios de logística em sala que ensinam somas de prefixo com dados reais de viagem. Chame-o de um Worker, um job de backend ou um script: passe legs, leia total e cumulative_at_stops, opcionalmente armazene o detalhamento de legs ao lado de cada linha da interface.
Perguntas técnicas
Quanto custa a API?
Cada solicitação bem-sucedida é cobrada a US$ 0,002 do seu saldo pré-pago ForHosting KIT. Validação falha não é cobrada. A ferramenta do navegador é gratuita.