Estimador de tempo de ciclismo: duração por distância e velocidade

Velocidade média zero ou negativa é rejeitada com o erro claro invalid_input, porque dividir por uma velocidade não positiva não é um plano de pedalada. O caminho é aritmética determinística pura com arredondamento decimal fixo —sem chamadas de rede, sem sementes aleatórias, sem dependência do relógio de parede—, de modo que o executor gratuito do navegador e a API pré-paga devolvem o mesmo JSON sempre.

O que significa o tempo de pedalada e como é calculado

A fórmula fechada é riding_time igual a distance dividido por average_speed, em que distance e average_speed compartilham o mesmo sistema de unidades: quarenta quilômetros a vinte quilômetros por hora são duas horas; vinte e cinco milhas a doze e meia milhas por hora também são duas horas. Em caso de sucesso, a resposta ecoa distance e average_speed arredondados, publica riding_time_hours e riding_time_minutes com arredondamento fixo de doze casas decimais, define riding_time_formatted como uma string humana compacta como duas horas e trinta minutos, e inclui formula e steps para que planilhas e testes automatizados possam afirmar cada linha intermediária.

Como chamar a API e o que volta

Envie um corpo JSON com dois números finitos obrigatórios: distance (aliases dist, d, length, total_distance, ride_distance) e average_speed (aliases speed, avg_speed, v, velocity, ride_speed). A distância deve ser estritamente positiva e no máximo um milhão; average_speed deve ser estritamente positiva e no máximo dez mil por hora para que os quocientes intermediários permaneçam finitos em precisão dupla IEEE no Worker e no navegador. Em caso de sucesso, a resposta ecoa distance e average_speed arredondados, define riding_time_hours como distance dividido por average_speed, riding_time_minutes como esse valor vezes sessenta, riding_time_formatted como um rótulo compacto de hora e minuto construído a partir de minutos inteiros após o arredondamento, formula como a string riding_time igual a distance dividido por average_speed, message como um resumo curto, e steps como um array ordenado de linhas de substituição. Validação falha —campos ausentes, números não finitos, valores fora dos limites publicados, distância zero ou negativa, average_speed zero ou negativa, ou um quociente não finito— retorna invalid_input e nunca é cobrada. O preço é um US$ 0,002 fixo por requisição bem-sucedida com unidade item e preço unitário marginal zero. Prefira campos JSON numéricos quando você controla o cliente; números em string só são aceitos quando batem com um padrão numérico finito estrito sem unidades nem texto final.

Dicas práticas, limites e buscas relacionadas

Médias recreativas típicas ficam entre doze e vinte e cinco quilômetros por hora; grupos de estrada treinados costumam ir mais alto, e a assistência de e-bike pode empurrar as médias ainda mais —sempre bem abaixo do máximo do catálogo—. Esta página visa quem busca um estimador de tempo de ciclismo, duração de passeio de bike ou calculadora de distância e velocidade média para bicicletas; não é uma ferramenta de ETA de carro, nem um planejador de itinerário multi-parada, nem um modelo de calorias ou potência. Prefira esta capacidade quando você já conhece a distância e uma velocidade média planejada ou histórica e só precisa da duração pura de pedalada; se sua fonte é um track GPS, extraia primeiro a distância e a média em movimento. Mantenha distance e average_speed dentro das faixas publicadas para que o quociente não transborde em um tempo de pedalada não finito que o solucionador precise rejeitar. Ao ensinar ou testar, combine exemplos: quarenta quilômetros a vinte quilômetros por hora rendem duas horas e uma string formatada limpa de duas horas; trinta quilômetros a quinze quilômetros por hora também rendem duas horas; noventa minutos no selim podem ser recuperados de quarenta e cinco quilômetros a trinta quilômetros por hora; e average_speed igual a zero demonstra o caminho duro invalid_input que protege contra divisão por zero. Tarefas falhas que retornam invalid_input não consomem saldo pré-pago, o que mantém scripts exploratórios baratos quando você sonda de propósito o erro de velocidade zero. Checagens de ida e volta são fáceis: recalcule distance dividido por average_speed à mão e confirme que iguala riding_time_hours no mesmo arredondamento de doze casas, e confirme que riding_time_minutes iguala esse valor vezes sessenta com a mesma política de arredondamento.