Ritmo de viaje a velocidad

Cómo el ritmo se convierte en velocidad y duración del tour

Un ritmo cero o negativo haría la velocidad infinita o invertida; una distancia nula o negativa no es un tour válido—ambos fallan con invalid_input y no se facturan. La implementación es aritmética pura en un Worker isolate: sin mapas, desnivel, tráfico, paradas ni reloj de pared, de modo que entradas idénticas producen siempre el mismo JSON para goldens y pruebas de integración continua.

Cómo leer la respuesta y elegir ritmos de tour realistas

La actividad no cambia el cálculo: solo etiqueta el tipo de tour para plantillas de caminata frente a ciclismo. Prefiera ritmos medios conservadores frente a picos de forma cuando la ruta incluya cuestas, equipaje, paradas fotográficas o calles concurridas: los paseos urbanos suelen situarse cerca de doce a quince minutos por kilómetro, mientras el ciclismo de ocio puede estar entre cuatro y seis minutos por kilómetro según terreno y bicicleta. Una respuesta correcta devuelve pace_minutes tras redondeo estable, pace_display como cadena humana M:SS o H:MM:SS, unit y unit_label (min/km o min/mi), distance y distance_unit, activity y activity_label (walking o cycling), speed_kmh y speed_mph, duration_hours y duration_minutes, duration_display como 2h o 1h 20m, precision, una cadena formula que puede mostrar junto a los números, y method igual a travel_pace_to_speed. Use speed_kmh cuando el material regional sea métrico; speed_mph en itinerarios en millas de EE. UU.; duration_display en tarjetas móviles y duration_hours al encadenar varios tramos en su código. Este endpoint no modela desnivel, viento, semáforos ni pausas en café; añada holgura fuera de la llamada si el itinerario lo necesita. La ausencia conjunta de pace y minutes, valores no finitos, campos conflictivos y precision fuera de rango fallan con invalid_input indicando el problema para que la interfaz resalte el campo.

Uso de la API, precios, flujos de viaje y límites

Use la calculadora gratuita en el navegador para planificar vacaciones, demos de clase y comprobaciones rápidas de tour sin instalar una hoja de cálculo. Combine esta herramienta con un convertidor de unidades de distancia cuando el mapa exporte millas y su tabla de ritmo esté en minutos por kilómetro—convierta un lado primero para que unit y distance sigan coherentes. Las entradas siguen las mismas reglas de retención que otros ítems parse de KIT, y los resultados se pueden fijar en pruebas de integración continua porque el algoritmo es totalmente determinista. Envíe un cuerpo JSON con distance y pace o minutes (seconds opcionales), más unit, activity y precision opcionales. Use la API prepago cuando un portal de viajes, mostrador de alquiler de bicicletas, app de caminatas urbanas o guía ciclista de varios días necesite un contrato estable bajo saldo KIT a $0.002 por ítem correcto; los fallos de validación nunca consumen saldo. En tours a pie o en bici de varios tramos, llame una vez por tramo y sume duration_hours en el cliente para que cada segmento quede auditable en registros y tickets de soporte. Los autores de SDK pueden mapear duration_display a tablas de itinerario y mantener speed_kmh y speed_mph lado a lado para públicos mixtos—la misma forma que los viajeros esbozan a mano al convertir el ritmo del reloj en una ventana de llegada esperada para un paseo museo-puerto o una etapa costera en bici.