Entrenamientos - Formato de exportación JSON
Documentación de la estructura de entrenamientos en exportaciones JSON
Última actualización: 31 de octubre de 2026
En esta página
Las exportaciones JSON almacenan los entrenamientos en el array workouts.
Versiones de exportación
Health Auto Export admite dos versiones de exportación de entrenamientos:
- Versión 2 (recomendada): Formato mejorado con metadatos más detallados y datos estructurados
- Versión 1 (legado): Formato anterior mantenido por compatibilidad con flujos existentes
Entrenamientos Versión 2
La Versión 2 incluye los siguientes campos obligatorios y datos opcionales. Los ejemplos usan Localizar unidades desactivado; activarlo puede cambiar las etiquetas de unidad en las series de métricas.
Estructura básica
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"name": "Running",
"start": "2024-02-06 07:00:00 -0800",
"end": "2024-02-06 07:30:00 -0800",
"duration": 1800
}
Campos obligatorios
id(String): Identificador único del entrenamientoname(String): Nombre del tipo de entrenamiento (p. ej., "Running", "Cycling", "Swimming")start(Date): Hora de inicio del entrenamiento en formatoyyyy-MM-dd HH:mm:ss Zend(Date): Hora de fin del entrenamiento en formatoyyyy-MM-dd HH:mm:ss Zduration(Number): Duración del entrenamiento en segundos
Campos opcionales
Los campos opcionales dependen de los datos disponibles y de tus selecciones de exportación:
Origen de registro
{
"source": {
"name": "Workout App",
"identifier": "com.example.workouts"
}
}
source(Object): La app o el dispositivo que registró el entrenamiento, con su nombre e identificador de app. Las lecturas de métricas individuales tienen cadenas de origen separadas y pueden proceder de otra app o dispositivo.
Información de ubicación
{
"location": "Outdoor",
"isIndoor": false
}
location(String): Uno de"Indoor","Outdoor","Pool","Open Water"isIndoor(Boolean): Si el entrenamiento se realizó en interior
Energía e intensidad
{
"activeEnergyBurned": {
"qty": 350,
"units": "kcal"
},
"totalEnergy": {
"qty": 450,
"units": "kcal"
},
"intensity": {
"qty": 8.5,
"units": "kcal/hr\u00b7kg"
}
}
activeEnergyBurned(Object): Calorías activas quemadas durante el entrenamientototalEnergy(Object): Calorías totales (activas + en reposo) quemadasintensity(Object): Valor del equivalente metabólico de la tarea (MET)
Distancia y velocidad
{
"distance": {
"qty": 3.5,
"units": "mi"
}
}
distance(Object): Distancia total recorridaspeed(Object): Velocidad media calculada a partir de la distancia y la duraciónavgSpeed(Object): Velocidad media a lo largo del entrenamientomaxSpeed(Object): Velocidad máxima alcanzada
Cada objeto incluye qty y units.
Elevación
{
"elevationUp": {
"qty": 500,
"units": "ft"
},
"elevationDown": {
"qty": 450,
"units": "ft"
}
}
elevationUp(Object): Elevación total ganadaelevationDown(Object): Elevación total perdida
Unidades: "ft" (pies) o "m" (metros)
Datos ambientales
{
"temperature": {
"qty": 72,
"units": "degF"
},
"humidity": {
"qty": 65,
"units": "%"
}
}
temperature(Object): Temperatura ambiente durante el entrenamientohumidity(Object): Porcentaje de humedad relativa
Unidades de temperatura: "degF" (Fahrenheit) o "degC" (Celsius)
Campos específicos de natación
{
"lapLength": {
"qty": 0.025,
"units": "mi"
},
"strokeStyle": "Freestyle",
"swolfScore": 45,
"salinity": "Fresh Water",
"totalSwimmingStrokeCount": {
"qty": 1200,
"units": "count"
},
"swimCadence": {
"qty": 30,
"units": "count/min"
}
}
lapLength(Object): Longitud de cada callestrokeStyle(String): Uno de:"Backstroke""Breaststroke""Butterfly""Freestyle""Mixed""Kickboard""Unknown"
swolfScore(Number): Puntuación de eficiencia de nataciónsalinity(String):"Fresh Water"o"Salt Water"totalSwimmingStrokeCount(Object): Número total de brazadasswimCadence(Object): Brazadas por minuto
Datos de pasos y cadencia
{
"stepCount": [
{
"date": "2024-02-06 07:00:00 -0800",
"qty": 5000,
"units": "count",
"source": "Apple Watch"
}
],
"stepCadence": {
"qty": 180,
"units": "count/min"
},
"flightsClimbed": {
"qty": 10,
"units": "count"
}
}
stepCount(Array): Array de mediciones de recuento de pasos a lo largo del tiempostepCadence(Object): Pasos por minutoflightsClimbed(Object): Número de pisos de escaleras subidos
Datos de frecuencia cardiaca
{
"heartRate": {
"min": {
"qty": 120,
"units": "count/min"
},
"avg": {
"qty": 150,
"units": "count/min"
},
"max": {
"qty": 175,
"units": "count/min"
}
},
"maxHeartRate": {
"qty": 175,
"units": "count/min"
},
"avgHeartRate": {
"qty": 150,
"units": "count/min"
},
"heartRateData": [
{
"date": "2024-02-06 07:00:00 -0800",
"Min": 120,
"Avg": 150,
"Max": 175,
"units": "count/min",
"source": "Apple Watch"
}
],
"heartRateRecovery": [
{
"date": "2024-02-06 07:30:00 -0800",
"Min": 140,
"Avg": 145,
"Max": 150,
"units": "count/min",
"source": "Apple Watch"
}
]
}
heartRate(Object): Resumen con frecuencia cardiaca mín., prom. y máx. durante el entrenamientomaxHeartRate(Object): Frecuencia cardiaca máxima durante el entrenamientoavgHeartRate(Object): Frecuencia cardiaca media durante el entrenamientoheartRateData(Array): Mediciones detalladas del entrenamiento, que terminan cuando termina el entrenamientoheartRateRecovery(Array): Mediciones separadas de los dos minutos inmediatamente posteriores al fin del entrenamiento
Las frecuencias cardiacas de resumen usan valores de entrenamiento registrados cuando están disponibles, y en su defecto las lecturas de frecuencia cardiaca del entrenamiento. Las lecturas exportadas incluyen mediciones tomadas durante las pausas, por lo que sus picos y promedios pueden diferir del resumen.
Arrays de datos en serie temporal
Muchas métricas pueden incluirse como arrays en serie temporal cuando está activado "Incluir métricas del entrenamiento":
{
"activeEnergy": [
{
"date": "2024-02-06 07:00:00 -0800",
"qty": 50,
"units": "kcal",
"source": "Apple Watch"
}
],
"basalEnergy": [
{
"date": "2024-02-06 07:00:00 -0800",
"qty": 20,
"units": "kcal",
"source": "Apple Watch"
}
],
"cyclingCadence": [
{
"date": "2024-02-06 07:00:00 -0800",
"qty": 90,
"units": "count/min",
"source": "Apple Watch"
}
],
"cyclingDistance": [
{
"date": "2024-02-06 07:00:00 -0800",
"qty": 0.5,
"units": "mi",
"source": "Apple Watch"
}
],
"cyclingPower": [
{
"date": "2024-02-06 07:00:00 -0800",
"qty": 200,
"units": "W",
"source": "Power Meter"
}
],
"cyclingSpeed": [
{
"date": "2024-02-06 07:00:00 -0800",
"qty": 18,
"units": "mi/hr",
"source": "Apple Watch"
}
],
"swimDistance": [
{
"date": "2024-02-06 07:00:00 -0800",
"qty": 25,
"units": "yd",
"source": "Apple Watch"
}
],
"swimStroke": [
{
"date": "2024-02-06 07:00:00 -0800",
"qty": 20,
"units": "count",
"source": "Apple Watch"
}
],
"walkingAndRunningDistance": [
{
"date": "2024-02-06 07:00:00 -0800",
"qty": 0.25,
"units": "mi",
"source": "Apple Watch"
}
]
}
Estructura QuantityData:
date(Date): Marca de tiempo de la mediciónqty(Number): Valor de cantidadunits(String): Unidad de medidasource(String, opcional): Dispositivo o app de origen de los datos
Estructura HeartRateData:
date(Date): Marca de tiempo de la mediciónMin(Number): Frecuencia cardiaca mínimaAvg(Number): Frecuencia cardiaca mediaMax(Number): Frecuencia cardiaca máximaunits(String): Unidad (count/mincon Localizar unidades desactivado)source(String, opcional): Dispositivo o app de origen de los datos
Datos de ruta
Cuando está activado "Incluir datos de ruta" y el entrenamiento tiene datos GPS:
{
"route": [
{
"latitude": 37.7749,
"longitude": -122.4194,
"altitude": 50.5,
"course": 45.0,
"courseAccuracy": 5.0,
"horizontalAccuracy": 10.0,
"verticalAccuracy": 15.0,
"timestamp": "2024-02-06 07:00:00 -0800",
"speed": 7.0,
"speedAccuracy": 0.5
}
]
}
Campos de ubicación:
latitude(Number): Coordenada GPS de latitudlongitude(Number): Coordenada GPS de longitudaltitude(Number): Elevación en metroscourse(Number): Dirección de desplazamiento en grados (0-360)courseAccuracy(Number): Precisión de la medición de rumbo en gradoshorizontalAccuracy(Number): Precisión de la posición horizontal en metrosverticalAccuracy(Number): Precisión de la posición vertical en metrostimestamp(Date): Hora en que se registró la ubicaciónspeed(Number): Velocidad en metros por segundospeedAccuracy(Number): Precisión de la medición de velocidad en m/s
Metadatos
{
"metadata": {
"customField": {
"label": "value",
"quantity": 123
},
"anotherField": [
1,
2,
3
]
}
}
metadata(Object): Metadatos personalizados adicionales asociados al entrenamiento
Eventos, actividades y splits
Las exportaciones JSON y Markdown de la Versión 2 pueden incluir events, segments, laps y activities registrados por la app de entrenamiento. Siguen disponibles cuando Incluir métricas del entrenamiento está desactivado. CSV y GPX no incluyen estos registros.
Con Incluir métricas del entrenamiento activado y las métricas relevantes seleccionadas, los intervalos también pueden incluir distancia, energía activa, resúmenes de frecuencia cardiaca y ritmo o velocidad del tiempo activo. Los valores distinguen las mediciones registradas de las estimaciones; los valores no disponibles se omiten.
Con la distancia seleccionada, splits puede incluir splits estimados de kilómetros y millas. Pueden diferir de los splits de la app de registro, y el split final se marca como parcial cuando es más corto que la distancia objetivo. Las lecturas de distancia que faltan o los tipos de entrenamiento no admitidos pueden impedir el cálculo de splits.
Puntuaciones de esfuerzo del entrenamiento
Las exportaciones JSON y Markdown de la Versión 2 pueden incluir valores seleccionados de Puntuación de esfuerzo del entrenamiento (effortScore) y Puntuación de esfuerzo del entrenamiento estimada (estimatedEffortScore). Cada uno es un objeto con qty y units: "appleEffortScore".
Las puntuaciones requieren iOS 18 o posterior y acceso a los datos correspondientes en Apple Health. Las puntuaciones del entrenamiento completo y de la actividad son independientes. Son independientes de Agrupación temporal e Incluir métricas del entrenamiento; CSV no las incluye.
En Explorar → Entrenamientos, abre la hoja de exportación de la lista o los ajustes de exportación de Versión 2 de un entrenamiento, y usa Seleccionar campos de exportación para elegir las puntuaciones de esfuerzo antes de exportar.
Agrupación temporal de métricas del entrenamiento
Al usar la Versión de exportación 2 y con "Incluir métricas del entrenamiento" activado, puedes controlar la granularidad de los datos en serie temporal:
- Minutos: Agrupa las métricas del entrenamiento por minutos del reloj. El primer y el último minuto pueden incluir unos segundos justo antes de que empiece el entrenamiento o justo después de que termine.
- Segundos: Agrupa las métricas del entrenamiento por segundos del reloj, con cada marca de tiempo marcando el inicio de su segundo. El primer y el último segundo pueden incluir la fracción de segundo justo fuera del entrenamiento. Los archivos son más grandes que con la agrupación por minutos.
La energía activa y en reposo usan los mismos totales combinados que otras métricas del entrenamiento en cada grupo temporal. Las lecturas de más de un dispositivo o app se incluyen juntas.
Entrenamientos Versión 1 (legado)
La Versión 1 usa una estructura más sencilla. Para exportaciones nuevas, se recomienda la Versión 2.
Estructura de la Versión 1
{
"name": "Running",
"start": "2024-02-06 07:00:00 -0800",
"end": "2024-02-06 07:30:00 -0800",
"totalEnergy": {
"qty": 450,
"units": "kcal"
},
"activeEnergy": {
"qty": 350,
"units": "kcal"
},
"distance": {
"qty": 3.5,
"units": "mi"
},
"heartRateData": [
{
"date": "2024-02-06 07:00:00 -0800",
"qty": 150,
"units": "bpm"
}
],
"route": [
{
"lat": 37.7749,
"lon": -122.4194,
"altitude": 50.5,
"timestamp": "2024-02-06 07:00:00 -0800"
}
]
}