Centro de ayuda HealthyApps
Español (Latinoamérica)
Centro de ayuda
Sitio principal ↗

Buscar temas de ayuda

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
Versiones de exportación
Entrenamientos Versión 2 Entrenamientos Versión 2 Estructura básicaCampos obligatoriosCampos opcionalesAgrupación temporal de métricas del entrenamiento
Entrenamientos Versión 1 (legado) Entrenamientos Versión 1 (legado) Estructura de la Versión 1
Documentación relacionada

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 entrenamiento
  • name (String): Nombre del tipo de entrenamiento (p. ej., "Running", "Cycling", "Swimming")
  • start (Date): Hora de inicio del entrenamiento en formato yyyy-MM-dd HH:mm:ss Z
  • end (Date): Hora de fin del entrenamiento en formato yyyy-MM-dd HH:mm:ss Z
  • duration (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 entrenamiento
  • totalEnergy (Object): Calorías totales (activas + en reposo) quemadas
  • intensity (Object): Valor del equivalente metabólico de la tarea (MET)

Distancia y velocidad

{
  "distance": {
    "qty": 3.5,
    "units": "mi"
  }
}
  • distance (Object): Distancia total recorrida
  • speed (Object): Velocidad media calculada a partir de la distancia y la duración
  • avgSpeed (Object): Velocidad media a lo largo del entrenamiento
  • maxSpeed (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 ganada
  • elevationDown (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 entrenamiento
  • humidity (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 calle
  • strokeStyle (String): Uno de:
    • "Backstroke"
    • "Breaststroke"
    • "Butterfly"
    • "Freestyle"
    • "Mixed"
    • "Kickboard"
    • "Unknown"
  • swolfScore (Number): Puntuación de eficiencia de natación
  • salinity (String): "Fresh Water" o "Salt Water"
  • totalSwimmingStrokeCount (Object): Número total de brazadas
  • swimCadence (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 tiempo
  • stepCadence (Object): Pasos por minuto
  • flightsClimbed (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 entrenamiento
  • maxHeartRate (Object): Frecuencia cardiaca máxima durante el entrenamiento
  • avgHeartRate (Object): Frecuencia cardiaca media durante el entrenamiento
  • heartRateData (Array): Mediciones detalladas del entrenamiento, que terminan cuando termina el entrenamiento
  • heartRateRecovery (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ón
  • qty (Number): Valor de cantidad
  • units (String): Unidad de medida
  • source (String, opcional): Dispositivo o app de origen de los datos

Estructura HeartRateData:

  • date (Date): Marca de tiempo de la medición
  • Min (Number): Frecuencia cardiaca mínima
  • Avg (Number): Frecuencia cardiaca media
  • Max (Number): Frecuencia cardiaca máxima
  • units (String): Unidad (count/min con 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 latitud
  • longitude (Number): Coordenada GPS de longitud
  • altitude (Number): Elevación en metros
  • course (Number): Dirección de desplazamiento en grados (0-360)
  • courseAccuracy (Number): Precisión de la medición de rumbo en grados
  • horizontalAccuracy (Number): Precisión de la posición horizontal en metros
  • verticalAccuracy (Number): Precisión de la posición vertical en metros
  • timestamp (Date): Hora en que se registró la ubicación
  • speed (Number): Velocidad en metros por segundo
  • speedAccuracy (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"
    }
  ]
}

Documentación relacionada