Entraînements - Format d’exportation JSON
Documentation de la structure des entraînements dans les exportations JSON
Dernière mise à jour: 31 octobre 2026
Sur cette page
Les exportations JSON stockent les entraînements dans le tableau workouts.
Versions d’exportation
Health Auto Export prend en charge deux versions d’exportation d’entraînements :
- Version 2 (recommandée) : Format enrichi avec des métadonnées plus détaillées et des données structurées
- Version 1 (héritée) : Ancien format maintenu pour la compatibilité avec les flux existants
Entraînements Version 2
La Version 2 inclut les champs obligatoires suivants et des données facultatives. Les exemples utilisent Localiser les unités désactivé ; l’activer peut modifier les libellés d’unité dans les séries d’indicateurs.
Structure de base
{
"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
}
Champs obligatoires
id(String) : Identifiant unique de l’entraînementname(String) : Nom du type d’entraînement (p. ex. "Running", "Cycling", "Swimming")start(Date) : Heure de début de l’entraînement au formatyyyy-MM-dd HH:mm:ss Zend(Date) : Heure de fin de l’entraînement au formatyyyy-MM-dd HH:mm:ss Zduration(Number) : Durée de l’entraînement en secondes
Champs facultatifs
Les champs facultatifs dépendent des données disponibles et de vos sélections d’exportation :
Source d’enregistrement
{
"source": {
"name": "Workout App",
"identifier": "com.example.workouts"
}
}
source(Object) : L’app ou l’appareil qui a enregistré l’entraînement, avec son nom et son identifiant d’app. Les lectures d’indicateurs individuelles ont des chaînes de source séparées et peuvent provenir d’une autre app ou d’un autre appareil.
Informations de localisation
{
"location": "Outdoor",
"isIndoor": false
}
location(String) : L’un de"Indoor","Outdoor","Pool","Open Water"isIndoor(Boolean) : Indique si l’entraînement a été effectué en intérieur
Énergie et intensité
{
"activeEnergyBurned": {
"qty": 350,
"units": "kcal"
},
"totalEnergy": {
"qty": 450,
"units": "kcal"
},
"intensity": {
"qty": 8.5,
"units": "kcal/hr\u00b7kg"
}
}
activeEnergyBurned(Object) : Calories actives brûlées pendant l’entraînementtotalEnergy(Object) : Calories totales (actives + au repos) brûléesintensity(Object) : Valeur de l’équivalent métabolique de la tâche (MET)
Distance et vitesse
{
"distance": {
"qty": 3.5,
"units": "mi"
}
}
distance(Object) : Distance totale parcouruespeed(Object) : Vitesse moyenne calculée à partir de la distance et de la duréeavgSpeed(Object) : Vitesse moyenne tout au long de l’entraînementmaxSpeed(Object) : Vitesse maximale atteinte
Chaque objet inclut qty et units.
Élévation
{
"elevationUp": {
"qty": 500,
"units": "ft"
},
"elevationDown": {
"qty": 450,
"units": "ft"
}
}
elevationUp(Object) : Élévation totale gagnéeelevationDown(Object) : Élévation totale perdue
Unités : "ft" (pieds) ou "m" (mètres)
Données environnementales
{
"temperature": {
"qty": 72,
"units": "degF"
},
"humidity": {
"qty": 65,
"units": "%"
}
}
temperature(Object) : Température ambiante pendant l’entraînementhumidity(Object) : Pourcentage d’humidité relative
Unités de température : "degF" (Fahrenheit) ou "degC" (Celsius)
Champs spécifiques à la natation
{
"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) : Longueur de chaque longueurstrokeStyle(String) : L’un de :"Backstroke""Breaststroke""Butterfly""Freestyle""Mixed""Kickboard""Unknown"
swolfScore(Number) : Score d’efficacité de nagesalinity(String) :"Fresh Water"ou"Salt Water"totalSwimmingStrokeCount(Object) : Nombre total de mouvementsswimCadence(Object) : Mouvements par minute
Données de pas et de cadence
{
"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) : Tableau de mesures du nombre de pas dans le tempsstepCadence(Object) : Pas par minuteflightsClimbed(Object) : Nombre d’étages d’escaliers montés
Données de fréquence cardiaque
{
"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) : Résumé avec fréquence cardiaque min., moy. et max. pendant l’entraînementmaxHeartRate(Object) : Fréquence cardiaque maximale pendant l’entraînementavgHeartRate(Object) : Fréquence cardiaque moyenne pendant l’entraînementheartRateData(Array) : Mesures détaillées de l’entraînement, se terminant à la fin de l’entraînementheartRateRecovery(Array) : Mesures séparées des deux minutes immédiatement après la fin de l’entraînement
Les fréquences cardiaques de résumé utilisent les valeurs d’entraînement enregistrées lorsqu’elles sont disponibles, sinon les lectures de fréquence cardiaque de l’entraînement. Les lectures exportées incluent les mesures prises pendant les pauses, de sorte que leurs pics et moyennes peuvent différer du résumé.
Tableaux de données en série temporelle
De nombreux indicateurs peuvent être inclus comme tableaux en série temporelle lorsque « Inclure les indicateurs d’entraînement » est activé :
{
"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"
}
]
}
Structure QuantityData :
date(Date) : Horodatage de la mesureqty(Number) : Valeur de quantitéunits(String) : Unité de mesuresource(String, facultatif) : Appareil ou app source des données
Structure HeartRateData :
date(Date) : Horodatage de la mesureMin(Number) : Fréquence cardiaque minimaleAvg(Number) : Fréquence cardiaque moyenneMax(Number) : Fréquence cardiaque maximaleunits(String) : Unité (count/minavec Localiser les unités désactivé)source(String, facultatif) : Appareil ou app source des données
Données d’itinéraire
Lorsque « Inclure les données d’itinéraire » est activé et que l’entraînement a des données 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
}
]
}
Champs de localisation :
latitude(Number) : Coordonnée GPS de latitudelongitude(Number) : Coordonnée GPS de longitudealtitude(Number) : Élévation en mètrescourse(Number) : Direction de déplacement en degrés (0-360)courseAccuracy(Number) : Précision de la mesure de cap en degréshorizontalAccuracy(Number) : Précision de la position horizontale en mètresverticalAccuracy(Number) : Précision de la position verticale en mètrestimestamp(Date) : Heure à laquelle la localisation a été enregistréespeed(Number) : Vitesse en mètres par secondespeedAccuracy(Number) : Précision de la mesure de vitesse en m/s
Métadonnées
{
"metadata": {
"customField": {
"label": "value",
"quantity": 123
},
"anotherField": [
1,
2,
3
]
}
}
metadata(Object) : Métadonnées personnalisées supplémentaires associées à l’entraînement
Événements, activités et splits
Les exportations JSON et Markdown de la Version 2 peuvent inclure events, segments, laps et activities enregistrés par l’app d’entraînement. Ils restent disponibles lorsque Inclure les indicateurs d’entraînement est désactivé. CSV et GPX n’incluent pas ces enregistrements.
Avec Inclure les indicateurs d’entraînement activé et les indicateurs pertinents sélectionnés, les intervalles peuvent également inclure la distance, l’énergie active, les résumés de fréquence cardiaque et l’allure ou la vitesse du temps actif. Les valeurs distinguent les mesures enregistrées des estimations ; les valeurs indisponibles sont omises.
Avec la distance sélectionnée, splits peut inclure des splits estimés en kilomètres et en miles. Ils peuvent différer des splits de l’app d’enregistrement, et le split final est marqué comme partiel lorsqu’il est plus court que la distance cible. Des lectures de distance manquantes ou des types d’entraînement non pris en charge peuvent empêcher le calcul des splits.
Scores d’effort d’entraînement
Les exportations JSON et Markdown de la Version 2 peuvent inclure des valeurs sélectionnées de Score d’effort d’entraînement (effortScore) et Score d’effort d’entraînement estimé (estimatedEffortScore). Chacun est un objet avec qty et units: "appleEffortScore".
Les scores nécessitent iOS 18 ou ultérieur et l’accès aux données correspondantes dans Apple Santé. Les scores de l’entraînement entier et de l’activité sont distincts. Ils sont indépendants du Groupement temporel et de Inclure les indicateurs d’entraînement ; CSV ne les inclut pas.
Dans Parcourir → Entraînements, ouvrez la feuille d’exportation de la liste ou les réglages d’exportation Version 2 d’un entraînement, puis utilisez Sélectionner les champs d’exportation pour choisir les scores d’effort avant d’exporter.
Groupement temporel des indicateurs d’entraînement
Lorsque vous utilisez la Version d’exportation 2 et que « Inclure les indicateurs d’entraînement » est activé, vous pouvez contrôler la granularité des données en série temporelle :
- Minutes : Groupe les indicateurs d’entraînement par minutes d’horloge. La première et la dernière minute peuvent inclure quelques secondes juste avant le début de l’entraînement ou juste après sa fin.
- Secondes : Groupe les indicateurs d’entraînement par secondes d’horloge, chaque horodatage marquant le début de sa seconde. La première et la dernière seconde peuvent inclure la fraction de seconde juste hors de l’entraînement. Les fichiers sont plus volumineux qu’avec le groupement par minutes.
L’énergie active et au repos utilisent les mêmes totaux combinés que les autres indicateurs d’entraînement dans chaque groupe temporel. Les lectures de plusieurs appareils ou apps sont incluses ensemble.
Entraînements Version 1 (héritée)
La Version 1 utilise une structure plus simple. Pour les nouvelles exportations, la Version 2 est recommandée.
Structure de la Version 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"
}
]
}