ForHosting KIT · Ferramentas para dev

Distância total multiparada

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.

● BetaGrátis · no seu navegador

Executar grátis Ver a API

Use pelo WebAPIE-mailTelegramApp em breve

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. Escolha quilômetros ou milhas estatutárias; cada resposta bem-sucedida também devolve total_km e total_mi. O mesmo módulo puro alimenta o widget gratuito do navegador e o caminho de API pré-pago, de modo que notebooks, workers de borda e tickets de suporte concordam sempre nos mesmos totais arredondados sem geocodificação, tiles de mapa ou saltos de rede.

Como usar

Insira os dados no formulário acima. A ferramenta os verifica antes de calcular e mostra o resultado na mesma página.

Confira os dados

Use os rótulos e as unidades indicados em cada campo. Se algo estiver ausente ou fora do intervalo permitido, a página mostra o que corrigir.

Repita o cálculo ou automatize

Use a ferramenta web para verificações individuais e a API quando precisar da mesma capacidade em um fluxo automatizado.

Casos de uso

Obtenha uma resposta agora

Insira um conjunto de valores e veja o resultado sem montar uma planilha ou um script.

Compare cenários

Altere um valor por vez e repita o cálculo para entender o que muda o resultado.

Automatize tarefas repetidas

Use a API quando precisar executar o mesmo cálculo dentro do seu produto ou fluxo.

Perguntas frequentes

Como usar esta capacidade?

Preencha os campos acima e execute nesta página. O formulário destaca qualquer dado que precise de correção.

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/multi-stop-route-distance

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

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 →