Ritmo de viagem para velocidade

Como o ritmo se converte em velocidade e duração do tour

Envie o ritmo como número decimal de minutos ou como M:SS (ou H:MM:SS em trechos muito lentos), ou separe minutes e seconds opcionais. Ritmo zero ou negativo tornaria a velocidade infinita ou invertida; distância nula ou negativa não é um tour válido—ambos falham com invalid_input e não são cobrados. A implementação é aritmética pura em um Worker isolate: sem mapas, elevação, trânsito, paradas nem relógio de parede, de modo que entradas idênticas sempre geram o mesmo JSON para goldens e testes de integração contínua.

Como ler a resposta e escolher ritmos de tour realistas

A atividade não muda a matemática: só rotula o tipo de tour para modelos de caminhada versus ciclismo. Prefira ritmos médios conservadores a picos de performance quando a rota incluir subidas, bagagem, paradas para foto ou ruas cheias: passeios urbanos de turismo costumam ficar perto de doze a quinze minutos por quilômetro, enquanto ciclismo de lazer pode ficar entre quatro e seis minutos por quilômetro conforme terreno e bicicleta. Uma resposta bem-sucedida devolve pace_minutes após arredondamento estável, pace_display como string humana M:SS ou H:MM:SS, unit e unit_label (min/km ou min/mi), distance e distance_unit, activity e activity_label (walking ou cycling), speed_kmh e speed_mph, duration_hours e duration_minutes, duration_display como 2h ou 1h 20m, precision, uma string formula que você pode exibir ao lado dos números, e method igual a travel_pace_to_speed. Use speed_kmh quando o material regional for métrico; speed_mph em roteiros em milhas dos EUA; duration_display em cartões móveis e duration_hours ao encadear vários trechos no seu código. Este endpoint não modela ganho de elevação, vento, semáforos nem pausas em café; acrescente folga fora da chamada se o roteiro precisar. Ausência conjunta de pace e minutes, valores não finitos, campos conflitantes e precision fora da faixa falham com invalid_input nomeando o problema para a interface destacar o campo.

Uso da API, preços, fluxos de viagem e limites

Use a calculadora gratuita no navegador para planejar férias, demos de aula e checagens rápidas de tour sem instalar planilha. As entradas seguem as mesmas regras de retenção de outros itens parse do KIT, e os resultados são seguros para fixar em testes de integração contínua porque o algoritmo é totalmente determinístico. Envie um corpo JSON com distance e pace ou minutes (seconds opcionais), mais unit, activity e precision opcionais. Use a API pré-paga quando um portal de viagens, balcão de aluguel de bicicletas, app de caminhada urbana ou guia ciclista de vários dias precisar de um contrato estável sob saldo KIT a US$ 0,002 por item bem-sucedido; falhas de validação nunca consomem saldo. Combine esta ferramenta com um conversor de unidades de distância quando o mapa exportar milhas e sua tabela de ritmo estiver em minutos por quilômetro—converta um lado primeiro para unit e distance permanecerem coerentes. Em tours a pé ou de bicicleta com vários trechos, chame uma vez por trecho e some duration_hours no cliente para cada segmento ficar auditável em logs e tickets de suporte. Autores de SDKs podem mapear duration_display em tabelas de itinerário e manter speed_kmh e speed_mph lado a lado para públicos mistos—a mesma forma que viajantes esboçam à mão ao converter o ritmo do relógio em uma janela de chegada esperada para um passeio museu-porto ou uma etapa costeira de bicicleta.