Centre d'aide HealthyApps
Français
Centre d'aide
Site principal ↗

Rechercher dans l’aide

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
Versions d’exportation
Entraînements Version 2 Entraînements Version 2 Structure de baseChamps obligatoiresChamps facultatifsGroupement temporel des indicateurs d’entraînement
Entraînements Version 1 (héritée) Entraînements Version 1 (héritée) Structure de la Version 1
Documentation associée

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înement
  • name (String) : Nom du type d’entraînement (p. ex. "Running", "Cycling", "Swimming")
  • start (Date) : Heure de début de l’entraînement au format yyyy-MM-dd HH:mm:ss Z
  • end (Date) : Heure de fin de l’entraînement au format yyyy-MM-dd HH:mm:ss Z
  • duration (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înement
  • totalEnergy (Object) : Calories totales (actives + au repos) brûlées
  • intensity (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 parcourue
  • speed (Object) : Vitesse moyenne calculée à partir de la distance et de la durée
  • avgSpeed (Object) : Vitesse moyenne tout au long de l’entraînement
  • maxSpeed (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ée
  • elevationDown (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înement
  • humidity (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 longueur
  • strokeStyle (String) : L’un de :
    • "Backstroke"
    • "Breaststroke"
    • "Butterfly"
    • "Freestyle"
    • "Mixed"
    • "Kickboard"
    • "Unknown"
  • swolfScore (Number) : Score d’efficacité de nage
  • salinity (String) : "Fresh Water" ou "Salt Water"
  • totalSwimmingStrokeCount (Object) : Nombre total de mouvements
  • swimCadence (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 temps
  • stepCadence (Object) : Pas par minute
  • flightsClimbed (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înement
  • maxHeartRate (Object) : Fréquence cardiaque maximale pendant l’entraînement
  • avgHeartRate (Object) : Fréquence cardiaque moyenne pendant l’entraînement
  • heartRateData (Array) : Mesures détaillées de l’entraînement, se terminant à la fin de l’entraînement
  • heartRateRecovery (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 mesure
  • qty (Number) : Valeur de quantité
  • units (String) : Unité de mesure
  • source (String, facultatif) : Appareil ou app source des données

Structure HeartRateData :

  • date (Date) : Horodatage de la mesure
  • Min (Number) : Fréquence cardiaque minimale
  • Avg (Number) : Fréquence cardiaque moyenne
  • Max (Number) : Fréquence cardiaque maximale
  • units (String) : Unité (count/min avec 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 latitude
  • longitude (Number) : Coordonnée GPS de longitude
  • altitude (Number) : Élévation en mètres
  • course (Number) : Direction de déplacement en degrés (0-360)
  • courseAccuracy (Number) : Précision de la mesure de cap en degrés
  • horizontalAccuracy (Number) : Précision de la position horizontale en mètres
  • verticalAccuracy (Number) : Précision de la position verticale en mètres
  • timestamp (Date) : Heure à laquelle la localisation a été enregistrée
  • speed (Number) : Vitesse en mètres par seconde
  • speedAccuracy (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"
    }
  ]
}

Documentation associée