Hilfezentrum HealthyApps
Deutsch
Hilfezentrum
Hauptwebsite ↗

Hilfethemen suchen

Workouts - JSON-Exportformat

Dokumentation der Workout-Struktur in JSON-Exporten

Zuletzt aktualisiert: 31. Oktober 2026

Auf dieser Seite
Exportversionen
Workouts Version 2 Workouts Version 2 GrundstrukturPflichtfelderOptionale FelderZeitgruppierung der Workout-Metriken
Workouts Version 1 (Veraltet) Workouts Version 1 (Veraltet) Version-1-Struktur
Verwandte Dokumentation

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 Workouts
  • name (String): Workout-Typname (z. B. "Running", "Cycling", "Swimming")
  • start (Date): Workout-Startzeit im Format yyyy-MM-dd HH:mm:ss Z
  • end (Date): Workout-Endzeit im Format yyyy-MM-dd HH:mm:ss Z
  • duration (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 Kalorien
  • totalEnergy (Object): Gesamtkalorien (aktiv + Ruhe) verbrannt
  • intensity (Object): Metabolisches Äquivalent der Aufgabe (MET)

Distanz und Geschwindigkeit

{
  "distance": {
    "qty": 3.5,
    "units": "mi"
  }
}
  • distance (Object): Zurückgelegte Gesamtdistanz
  • speed (Object): Durchschnittsgeschwindigkeit aus Distanz und Dauer
  • avgSpeed (Object): Durchschnittsgeschwindigkeit über das Workout
  • maxSpeed (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): Gesamtanstieg
  • elevationDown (Object): Gesamtabstieg

Einheiten: "ft" (Fuß) oder "m" (Meter)

Umgebungsdaten

{
  "temperature": {
    "qty": 72,
    "units": "degF"
  },
  "humidity": {
    "qty": 65,
    "units": "%"
  }
}
  • temperature (Object): Umgebungstemperatur während des Workouts
  • humidity (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 Bahn
  • strokeStyle (String): Einer von:
    • "Backstroke"
    • "Breaststroke"
    • "Butterfly"
    • "Freestyle"
    • "Mixed"
    • "Kickboard"
    • "Unknown"
  • swolfScore (Number): Schwimmeffizienzscore
  • salinity (String): "Fresh Water" oder "Salt Water"
  • totalSwimmingStrokeCount (Object): Gesamtzahl der Züge
  • swimCadence (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 Zeit
  • stepCadence (Object): Schritte pro Minute
  • flightsClimbed (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 Workouts
  • maxHeartRate (Object): Maximale Herzfrequenz während des Workouts
  • avgHeartRate (Object): Durchschnittliche Herzfrequenz während des Workouts
  • heartRateData (Array): Detaillierte Messungen aus dem Workout, endend wenn das Workout endet
  • heartRateRecovery (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 Messung
  • qty (Number): Mengenwert
  • units (String): Maßeinheit
  • source (String, optional): Datenquellen-Gerät oder App

HeartRateData-Struktur:

  • date (Date): Zeitstempel der Messung
  • Min (Number): Minimale Herzfrequenz
  • Avg (Number): Durchschnittliche Herzfrequenz
  • Max (Number): Maximale Herzfrequenz
  • units (String): Einheit (count/min mit 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-Breitengrad
  • longitude (Number): GPS-Längengrad
  • altitude (Number): Höhe in Metern
  • course (Number): Bewegungsrichtung in Grad (0-360)
  • courseAccuracy (Number): Genauigkeit der Kursmessung in Grad
  • horizontalAccuracy (Number): Horizontale Positionsgenauigkeit in Metern
  • verticalAccuracy (Number): Vertikale Positionsgenauigkeit in Metern
  • timestamp (Date): Zeitpunkt der Standortaufzeichnung
  • speed (Number): Geschwindigkeit in Metern pro Sekunde
  • speedAccuracy (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"
    }
  ]
}

Verwandte Dokumentation