Estimador de tiempo en bici: duración por distancia y velocidad

La velocidad media nula o negativa se rechaza con el error claro invalid_input, porque dividir por una velocidad no positiva no constituye un plan de ruta. El camino es aritmética determinista pura con redondeo decimal fijo —sin llamadas de red, sin semillas aleatorias, sin dependencia del reloj de pared—, de modo que el ejecutor gratuito del navegador y la API de prepago devuelven el mismo JSON en cada ocasión.

Qué significa el tiempo de pedaleo y cómo se calcula

La fórmula cerrada es riding_time igual a distance dividido por average_speed, donde distance y average_speed comparten el mismo sistema de unidades: cuarenta kilómetros a veinte kilómetros por hora son dos horas; veinticinco millas a doce y media millas por hora también son dos horas. En caso de éxito, la respuesta repite distance y average_speed redondeados, publica riding_time_hours y riding_time_minutes con redondeo fijo a doce decimales, fija riding_time_formatted a una cadena legible compacta como dos horas treinta minutos, e incluye formula y steps para que hojas de trabajo y pruebas automatizadas puedan afirmar cada línea intermedia.

Cómo invocar la API y qué se obtiene

Envíe un cuerpo JSON con dos números finitos obligatorios: distance (alias dist, d, length, total_distance, ride_distance) y average_speed (alias speed, avg_speed, v, velocity, ride_speed). La distancia debe ser estrictamente positiva y como máximo un millón; average_speed debe ser estrictamente positiva y como máximo diez mil por hora, de modo que los cocientes intermedios permanezcan finitos en precisión doble IEEE en el Worker y en el navegador. En caso de éxito, la respuesta repite distance y average_speed redondeados, fija riding_time_hours a distance dividido por average_speed, riding_time_minutes a ese valor multiplicado por sesenta, riding_time_formatted a una etiqueta compacta de horas y minutos construida a partir de minutos enteros tras el redondeo, formula a la cadena riding_time igual a distance dividido por average_speed, message a un resumen breve, y steps a un arreglo ordenado de líneas de sustitución. La validación fallida —campos ausentes, números no finitos, valores fuera de los límites publicados, distancia nula o negativa, average_speed nula o negativa, o un cociente no finito— devuelve invalid_input y nunca se cobra. El precio es un $0.002 fijo por petición exitosa con unidad item y precio unitario marginal nulo. Prefiera campos JSON numéricos cuando controle el cliente; los números en cadena solo se aceptan cuando coinciden con un patrón numérico finito estricto sin unidades ni texto final.

Consejos prácticos, límites y búsquedas relacionadas

Las medias recreativas típicas se sitúan entre doce y veinticinco kilómetros por hora; los grupos de carretera entrenados suelen ir más alto, y la asistencia de e-bike puede elevar aún más las medias —siempre por debajo del máximo del catálogo—. Esta página se dirige a quienes buscan un estimador de tiempo de ciclismo, duración de ruta en bici o calculadora de distancia y velocidad media para bicicletas; no es una herramienta de ETA en coche, ni un planificador de itinerarios multi-parada, ni un modelo de calorías o potencia. Prefiera esta capacidad cuando ya conozca la distancia y una velocidad media planificada o histórica y solo necesite la duración pura de pedaleo; si su fuente es un track GPS, extraiga primero la distancia y la media en movimiento. Mantenga distance y average_speed dentro de los rangos publicados para que el cociente no desborde en un tiempo de pedaleo no finito que el solucionador deba rechazar. Al enseñar o probar, combine ejemplos: cuarenta kilómetros a veinte kilómetros por hora dan dos horas y una cadena formateada limpia de dos horas; treinta kilómetros a quince kilómetros por hora también dan dos horas; noventa minutos de sillín se recuperan de cuarenta y cinco kilómetros a treinta kilómetros por hora; y average_speed igual a cero demuestra la ruta dura invalid_input que protege de la división por cero. Las tareas fallidas que devuelven invalid_input no consumen saldo prepagado, lo que mantiene baratos los scripts exploratorios cuando sondea a propósito el error de velocidad nula. Las comprobaciones de ida y vuelta son sencillas: recalcule distance dividido por average_speed a mano y confirme que iguala riding_time_hours con el mismo redondeo a doce decimales, y confirme que riding_time_minutes iguala ese valor por sesenta con la misma política de redondeo.