Estimateur de temps à vélo : durée selon distance et vitesse

Une vitesse moyenne nulle ou négative est rejetée avec l'erreur claire invalid_input, car diviser par une vitesse non positive ne constitue pas un plan de sortie. Le chemin est une arithmétique déterministe pure avec arrondi décimal fixe — sans appels réseau, sans graines aléatoires, sans dépendance à l'horloge murale —, de sorte que l'exécuteur gratuit du navigateur et l'API prépayée renvoient le même JSON à chaque fois.

Ce que signifie le temps de pédalage et comment il se calcule

La formule fermée est riding_time égal à distance divisé par average_speed, où distance et average_speed partagent le même système d'unités : quarante kilomètres à vingt kilomètres par heure font deux heures ; vingt-cinq miles à douze miles et demi par heure font également deux heures. En cas de succès, la réponse répète distance et average_speed arrondis, publie riding_time_hours et riding_time_minutes avec un arrondi fixe à douze décimales, fixe riding_time_formatted à une chaîne compacte telle que deux heures trente minutes, et inclut formula et steps afin que les feuilles de calcul et les tests automatisés puissent vérifier chaque ligne intermédiaire.

Comment appeler l'API et ce qui revient

Envoyez un corps JSON avec deux nombres finis obligatoires : distance (alias dist, d, length, total_distance, ride_distance) et average_speed (alias speed, avg_speed, v, velocity, ride_speed). La distance doit être strictement positive et au plus un million ; average_speed doit être strictement positive et au plus dix mille par heure afin que les quotients intermédiaires restent finis en double précision IEEE sur le Worker et dans le navigateur. En cas de succès, la réponse répète distance et average_speed arrondis, fixe riding_time_hours à distance divisé par average_speed, riding_time_minutes à cette valeur multipliée par soixante, riding_time_formatted à une étiquette compacte heures-minutes construite à partir des minutes entières après arrondi, formula à la chaîne riding_time égal à distance divisé par average_speed, message à un court résumé, et steps à un tableau ordonné de lignes de substitution. Une validation échouée — champs manquants, nombres non finis, valeurs hors limites publiées, distance nulle ou négative, average_speed nulle ou négative, ou quotient non fini — renvoie invalid_input et n'est jamais facturée. Le tarif est un forfait $0.002 par requête réussie avec unité item et prix unitaire marginal nul. Préférez des champs JSON numériques lorsque vous contrôlez le client ; les nombres en chaîne ne sont acceptés que s'ils respectent un motif numérique fini strict sans unités ni texte final.

Conseils pratiques, limites et recherches associées

Les moyennes récréatives typiques se situent entre douze et vingt-cinq kilomètres par heure ; les groupes route entraînés sont souvent plus élevés, et l'assistance e-bike peut pousser les moyennes encore plus loin — toujours bien sous le maximum du catalogue. Cette page cible les personnes qui cherchent un estimateur de temps cycliste, une durée de sortie à vélo ou un calculateur distance-vitesse moyenne pour bicyclettes ; ce n'est pas un outil d'ETA automobile, ni un planificateur d'itinéraire multi-arrêts, ni un modèle de calories ou de puissance. Préférez cette capacité lorsque vous connaissez déjà la distance et une vitesse moyenne prévue ou historique et n'avez besoin que de la durée pure de pédalage ; si votre source est une trace GPS, extrayez d'abord la distance et la moyenne en mouvement. Gardez distance et average_speed dans les plages publiées pour que le quotient ne déborde pas vers un temps de pédalage non fini que le solveur doit rejeter. Pour enseigner ou tester, associez des exemples : quarante kilomètres à vingt kilomètres par heure donnent deux heures et une chaîne formatée propre de deux heures ; trente kilomètres à quinze kilomètres par heure donnent aussi deux heures ; quatre-vingt-dix minutes de selle se retrouvent à partir de quarante-cinq kilomètres à trente kilomètres par heure ; et average_speed égal à zéro démontre le chemin dur invalid_input qui protège de la division par zéro. Les tâches en échec qui renvoient invalid_input ne consomment pas le solde prépayé, ce qui maintient les scripts exploratoires peu coûteux lorsque vous sondez volontairement l'erreur de vitesse nulle. Les contrôles aller-retour sont simples : recalculez distance divisé par average_speed à la main et confirmez l'égalité avec riding_time_hours sous le même arrondi à douze décimales, et confirmez que riding_time_minutes égale cette valeur multipliée par soixante selon la même politique d'arrondi.