Workouts - JSON-Exportformat
Dokumentation der Workout-Struktur in JSON-Exporten
Zuletzt aktualisiert: 31. Oktober 2026
Auf dieser Seite
JSON-Exporte speichern Workouts im Array workouts.
Exportversionen
Health Auto Export unterstützt zwei Workout-Exportversionen:
- Version 2 (empfohlen): Erweitertes Format mit detaillierteren Metadaten und strukturierten Daten
- Version 1 (Veraltet): Älteres Format für Kompatibilität mit bestehenden Workflows
Workouts Version 2
Version 2 enthält die folgenden Pflichtfelder und optionale Daten. Beispiele verwenden Einheiten lokalisieren aus; das Aktivieren kann Einheitsetiketten in Metrikserien ändern.
Grundstruktur
{
"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
}
Pflichtfelder
id(String): Eindeutige Kennung des Workoutsname(String): Workout-Typname (z. B. "Running", "Cycling", "Swimming")start(Date): Workout-Startzeit im Formatyyyy-MM-dd HH:mm:ss Zend(Date): Workout-Endzeit im Formatyyyy-MM-dd HH:mm:ss Zduration(Number): Workout-Dauer in Sekunden
Optionale Felder
Optionale Felder hängen von verfügbaren Daten und deinen Exportauswahlen ab:
Aufzeichnungsquelle
{
"source": {
"name": "Workout App",
"identifier": "com.example.workouts"
}
}
source(Object): App oder Gerät, das das Workout erfasst hat, mit Name und App-Kennung. Einzelne Metrik-Messwerte haben separate Quellenzeichenketten und können von einer anderen App oder einem anderen Gerät stammen.
Standortinformationen
{
"location": "Outdoor",
"isIndoor": false
}
location(String): Einer von"Indoor","Outdoor","Pool","Open Water"isIndoor(Boolean): Ob das Workout indoor durchgeführt wurde
Energie und Intensität
{
"activeEnergyBurned": {
"qty": 350,
"units": "kcal"
},
"totalEnergy": {
"qty": 450,
"units": "kcal"
},
"intensity": {
"qty": 8.5,
"units": "kcal/hr\u00b7kg"
}
}
activeEnergyBurned(Object): Während des Workouts verbrannte aktive KalorientotalEnergy(Object): Gesamtkalorien (aktiv + Ruhe) verbranntintensity(Object): Metabolisches Äquivalent der Aufgabe (MET)
Distanz und Geschwindigkeit
{
"distance": {
"qty": 3.5,
"units": "mi"
}
}
distance(Object): Zurückgelegte Gesamtdistanzspeed(Object): Durchschnittsgeschwindigkeit aus Distanz und DaueravgSpeed(Object): Durchschnittsgeschwindigkeit über das WorkoutmaxSpeed(Object): Erreichte Höchstgeschwindigkeit
Jedes Objekt enthält qty und units.
Höhenmeter
{
"elevationUp": {
"qty": 500,
"units": "ft"
},
"elevationDown": {
"qty": 450,
"units": "ft"
}
}
elevationUp(Object): GesamtanstiegelevationDown(Object): Gesamtabstieg
Einheiten: "ft" (Fuß) oder "m" (Meter)
Umgebungsdaten
{
"temperature": {
"qty": 72,
"units": "degF"
},
"humidity": {
"qty": 65,
"units": "%"
}
}
temperature(Object): Umgebungstemperatur während des Workoutshumidity(Object): Relative Luftfeuchtigkeit in Prozent
Temperatureinheiten: "degF" (Fahrenheit) oder "degC" (Celsius)
Schwimmspezifische Felder
{
"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): Länge jeder BahnstrokeStyle(String): Einer von:"Backstroke""Breaststroke""Butterfly""Freestyle""Mixed""Kickboard""Unknown"
swolfScore(Number): Schwimmeffizienzscoresalinity(String):"Fresh Water"oder"Salt Water"totalSwimmingStrokeCount(Object): Gesamtzahl der ZügeswimCadence(Object): Züge pro Minute
Schritt- und Kadenzdaten
{
"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 von Schrittzählmessungen über die ZeitstepCadence(Object): Schritte pro MinuteflightsClimbed(Object): Anzahl der Etagen
Herzfrequenzdaten
{
"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): Zusammenfassung mit min., avg. und max. Herzfrequenz während des WorkoutsmaxHeartRate(Object): Maximale Herzfrequenz während des WorkoutsavgHeartRate(Object): Durchschnittliche Herzfrequenz während des WorkoutsheartRateData(Array): Detaillierte Messungen aus dem Workout, endend wenn das Workout endetheartRateRecovery(Array): Separate Messungen aus den zwei Minuten unmittelbar nach Workout-Ende
Zusammenfassungs-Herzfrequenzen verwenden erfasste Workout-Werte wenn verfügbar, sonst die Herzfrequenz-Messwerte des Workouts. Exportierte Messwerte enthalten Messungen während Pausen, sodass Spitzen und Durchschnitte von der Zusammenfassung abweichen können.
Zeitreihen-Datenarrays
Viele Metriken können als Zeitreihen-Arrays einbezogen werden, wenn „Workout-Metriken einbeziehen“ aktiviert ist:
{
"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"
}
]
}
QuantityData-Struktur:
date(Date): Zeitstempel der Messungqty(Number): Mengenwertunits(String): Maßeinheitsource(String, optional): Datenquellen-Gerät oder App
HeartRateData-Struktur:
date(Date): Zeitstempel der MessungMin(Number): Minimale HerzfrequenzAvg(Number): Durchschnittliche HerzfrequenzMax(Number): Maximale Herzfrequenzunits(String): Einheit (count/minmit Einheiten lokalisieren aus)source(String, optional): Datenquellen-Gerät oder App
Routendaten
Wenn „Routendaten einbeziehen“ aktiviert ist und das Workout GPS-Daten hat:
{
"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
}
]
}
Standortfelder:
latitude(Number): GPS-Breitengradlongitude(Number): GPS-Längengradaltitude(Number): Höhe in Meterncourse(Number): Bewegungsrichtung in Grad (0-360)courseAccuracy(Number): Genauigkeit der Kursmessung in GradhorizontalAccuracy(Number): Horizontale Positionsgenauigkeit in MeternverticalAccuracy(Number): Vertikale Positionsgenauigkeit in Meterntimestamp(Date): Zeitpunkt der Standortaufzeichnungspeed(Number): Geschwindigkeit in Metern pro SekundespeedAccuracy(Number): Genauigkeit der Geschwindigkeitsmessung in m/s
Metadaten
{
"metadata": {
"customField": {
"label": "value",
"quantity": 123
},
"anotherField": [
1,
2,
3
]
}
}
metadata(Object): Zusätzliche benutzerdefinierte Metadaten zum Workout
Ereignisse, Aktivitäten und Splits
Version-2-JSON- und Markdown-Exporte können von der Workout-App erfasste events, segments, laps und activities enthalten. Diese bleiben verfügbar, wenn Workout-Metriken einbeziehen aus ist. CSV und GPX enthalten diese Datensätze nicht.
Mit Workout-Metriken einbeziehen ein und relevanten ausgewählten Metriken können Intervalle auch Distanz, aktive Energie, Herzfrequenz-Zusammenfassungen und Pace oder Geschwindigkeit der aktiven Zeit enthalten. Werte unterscheiden erfasste Messungen von Schätzungen; nicht verfügbare Werte werden weggelassen.
Mit ausgewählter Distanz kann splits geschätzte Kilometer- und Meilen-Splits enthalten. Sie können von den Splits der Aufzeichnungs-App abweichen, und der letzte Split wird als teilweise markiert, wenn er kürzer als die Zieldistanz ist. Fehlende Distanzmesswerte oder nicht unterstützte Workout-Typen können die Split-Berechnung verhindern.
Workout-Effort-Scores
Version-2-JSON- und Markdown-Exporte können ausgewählte Workout Effort Score- (effortScore) und Geschätzter Workout Effort Score-Werte (estimatedEffortScore) enthalten. Jeder ist ein Objekt mit qty und units: "appleEffortScore".
Scores erfordern iOS 18 oder neuer und Zugriff auf die entsprechenden Daten in Apple Health. Scores des gesamten Workouts und der Aktivität sind getrennt. Sie sind unabhängig von Zeitgruppierung und Workout-Metriken einbeziehen; CSV enthält sie nicht.
Unter Durchsuchen → Workouts öffne das Exportblatt der Liste oder die Version-2-Exporteinstellungen eines Workouts und verwende Exportfelder auswählen, um Effort-Scores vor dem Export zu wählen.
Zeitgruppierung der Workout-Metriken
Bei Exportversion 2 und aktiviertem „Workout-Metriken einbeziehen“ kannst du die Granularität der Zeitreihendaten steuern:
- Minuten: Gruppiert Workout-Metriken nach Uhrzeitminuten. Die erste und letzte Minute können einige Sekunden direkt vor Workout-Start oder direkt danach enthalten.
- Sekunden: Gruppiert Workout-Metriken nach Uhrzeitsekunden, wobei jeder Zeitstempel den Beginn seiner Sekunde markiert. Die erste und letzte Sekunde können den Sekundenbruchteil direkt außerhalb des Workouts enthalten. Dateien sind größer als bei Minutengruppierung.
Aktive und Ruheenergie verwenden dieselben kombinierten Totale wie andere Workout-Metriken in jeder Zeitgruppe. Messwerte von mehr als einem Gerät oder einer App werden zusammen einbezogen.
Workouts Version 1 (Veraltet)
Version 1 verwendet eine einfachere Struktur. Für neue Exporte wird Version 2 empfohlen.
Version-1-Struktur
{
"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"
}
]
}