Hilfezentrum HealthyApps
Deutsch
Hilfezentrum
Hauptwebsite ↗

Hilfethemen suchen

Gesundheitsmetriken - JSON-Exportformat

Dokumentation der Struktur von Gesundheitsmetriken in JSON-Exporten

Zuletzt aktualisiert: 31. Oktober 2026

Auf dieser Seite
Metriknamenformat
Struktur Struktur Gemeinsame Felder
Spezielle Metrikformate Spezielle Metrikformate BlutdruckHerzfrequenzHerzfrequenzvariabilitätSchlafanalyseBlutzuckerErnährungSexuelle AktivitätHändewaschenZähneputzenInsulinabgabe
Verwandte Dokumentation

JSON-Exporte speichern Gesundheitsmetriken im Array metrics.

Metriknamenformat

Alle Metriknamen in JSON-Exporten verwenden das Format snake_case (Kleinbuchstaben mit Unterstrichen). Zum Beispiel:

  • "Step Count" wird zu "step_count"
  • "Blood Pressure" wird zu "blood_pressure"
  • "Heart Rate" wird zu "heart_rate"
  • "Walking + Running Distance" wird zu "walking_running_distance"

Struktur

Das Array metrics enthält Objekte, die jeweils einen bestimmten Gesundheitsmetriktyp darstellen. Die meisten Gesundheitsmetriken folgen einer gemeinsamen Struktur:

{
  "name": "step_count",
  "units": "count",
  "data": [
    {
      "qty": 8500,
      "date": "2024-02-06 14:30:00 -0800",
      "source": "Apple Watch"
    }
  ]
}

Gemeinsame Felder

  • name (String): Name der Gesundheitsmetrik im snake_case-Format (z. B. "step_count", "heart_rate", "active_energy")
  • units (String): Maßeinheit (z. B. "count", "count/min", "kcal")
  • data (Array): Array von Datenpunkten, jeweils mit:
    • qty (Number): Mengenwert
    • date (Date): Zeitstempel im Format yyyy-MM-dd HH:mm:ss Z
    • source (String, wenn verfügbar): App oder Gerät, das die Probe erfasst hat

Spezielle Metrikformate

Einige Gesundheitsmetriken haben einzigartige Strukturen, die vom gemeinsamen Format abweichen:

Blutdruck

Blutdruckmesswerte enthalten systolische und diastolische Werte:

{
  "name": "blood_pressure",
  "units": "mmHg",
  "data": [
    {
      "date": "2024-02-06 14:30:00 -0800",
      "start": "2024-02-06 14:30:00 -0800",
      "end": "2024-02-06 14:30:00 -0800",
      "systolic": 120,
      "diastolic": 80,
      "source": "Health"
    }
  ]
}

Felder:

  • systolic (Number): Systolischer (oberer) Blutdruckwert. Zusammengefasste Exporte verwenden den Durchschnitt der Messwerte in der Zeitgruppe.
  • diastolic (Number): Diastolischer (unterer) Blutdruckwert. Zusammengefasste Exporte verwenden den Durchschnitt der Messwerte in der Zeitgruppe.

Herzfrequenz

Herzfrequenzdaten enthalten Minimum-, Durchschnitts- und Maximumwerte:

{
  "name": "heart_rate",
  "units": "count/min",
  "data": [
    {
      "date": "2024-02-06 14:30:00 -0800",
      "Min": 65,
      "Avg": 72,
      "Max": 85,
      "source": "Apple Watch"
    }
  ]
}

Felder:

  • Min (Number): Minimale Herzfrequenz während des Messzeitraums
  • Avg (Number): Durchschnittliche Herzfrequenz während des Messzeitraums
  • Max (Number): Maximale Herzfrequenz während des Messzeitraums

Herzfrequenzvariabilität

Mit Daten zusammenfassen aus können JSON-Exporte der Herzfrequenzvariabilität (SDNN) verfügbare Schlag-zu-Schlag-Messwerte enthalten. Diese erfordern Lesezugriff auf Herzschlagserie in Apple Health.

Zusammengefasste Exporte, CSV-Exporte und Recovery-HRV enthalten keine Schlag-zu-Schlag-Messwerte.

Schlafanalyse

Die Struktur der Schlafdaten hängt davon ab, ob Daten zusammenfassen ein- oder ausgeschaltet ist.

Daten zusammenfassen ein

Mit Daten zusammenfassen ein werden Schlafdaten nach Tag zusammengefasst. Dauern derselben Phase werden addiert. Gesamtschlaf ist die Summe aus asleep, core, deep und REM. JSON behält jeden Tag. In CSV zeigt eine gröbere Zeitgruppe den letzten Tag in dieser Gruppe:

{
  "name": "sleep_analysis",
  "units": "hr",
  "data": [
    {
      "date": "2024-02-06 00:00:00 -0800",
      "totalSleep": 7.5,
      "asleep": 0.5,
      "core": 3.5,
      "deep": 1.5,
      "rem": 2.0,
      "sleepStart": "2024-02-05 23:00:00 -0800",
      "sleepEnd": "2024-02-06 06:30:00 -0800",
      "inBed": 8.0,
      "inBedStart": "2024-02-05 22:45:00 -0800",
      "inBedEnd": "2024-02-06 06:45:00 -0800",
      "awake": 0.0,
      "source": "Apple Watch"
    }
  ]
}

Felder:

  • totalSleep (Number): Gesamtschlafzeit in Stunden
  • asleep (Number): Schlafzeit ohne erfasste Schlafphase, in Stunden
  • core (Number): Core-Schlafdauer in Stunden
  • deep (Number): Tiefschlafdauer in Stunden
  • rem (Number): REM-Schlafdauer in Stunden
  • awake (Number): Wachzeit in Stunden
  • sleepStart (Date): Wann der Schlaf tatsächlich begann
  • sleepEnd (Date): Wann der Schlaf tatsächlich endete
  • inBed (Number): Gesamtzeit im Bett in Stunden
  • inBedStart (Date): Wann du ins Bett gegangen bist
  • inBedEnd (Date): Wann du aufgestanden bist

Daten zusammenfassen aus

Mit Daten zusammenfassen aus werden einzelne Schlafsegmente einbezogen:

{
  "name": "sleep_analysis",
  "units": "hr",
  "data": [
    {
      "date": "2024-02-05 23:00:00 -0800",
      "start": "2024-02-05 23:00:00 -0800",
      "end": "2024-02-05 23:30:00 -0800",
      "startDate": "2024-02-05 23:00:00 -0800",
      "endDate": "2024-02-05 23:30:00 -0800",
      "qty": 0.5,
      "value": "Core",
      "source": "Apple Watch"
    }
  ]
}

Felder:

  • date, start, startDate (Date): Startzeit des Schlafsegments
  • end, endDate (Date): Endzeit des Schlafsegments
  • source (String): App oder Gerät, das das Segment erfasst hat
  • qty (Number): Dauer des Segments in Stunden
  • value (String): Schlafzustand - einer von:
    • "Awake"
    • "Asleep" (unkategorisierte Schlafphase)
    • "In Bed"
    • "Core"
    • "REM"
    • "Deep"
    • "Unspecified"

Hinweis: "Asleep" bezeichnet eine unkategorisierte Schlafphase (nicht die Gesamtschlafzeit). Das kann vorkommen, wenn die Datenquelle keine Schlafphasenerfassung unterstützt.

Blutzucker

Blutzuckermesswerte enthalten Informationen zum Mahlzeitzeitpunkt:

{
  "name": "blood_glucose",
  "units": "mg/dL",
  "data": [
    {
      "date": "2024-02-06 08:00:00 -0800",
      "start": "2024-02-06 08:00:00 -0800",
      "end": "2024-02-06 08:00:00 -0800",
      "qty": 95,
      "mealTime": "Before Meal",
      "source": "Health"
    }
  ]
}

Felder:

  • qty (Number): Blutzuckerspiegel
  • mealTime (String): Einer von:
    • "Before Meal"
    • "After Meal"
    • "Unspecified"

Ernährung

Wenn Daten zusammenfassen aus ist, können einzelne Ernährungsmengenproben (z. B. Nahrungsenergie oder Kohlenhydrate) in Apple Health erfasste Lebensmitteldetails enthalten. Zum Beispiel:

{
  "name": "dietary_energy",
  "units": "kcal",
  "data": [
    {
      "date": "2024-02-06 08:00:00 -0800",
      "start": "2024-02-06 08:00:00 -0800",
      "end": "2024-02-06 08:00:00 -0800",
      "qty": 240,
      "source": "Lose It!",
      "foodType": "Boneless, Skinless Grilled Chicken Breast"
    }
  ]
}

Felder:

  • qty (Number): Nährstoffmenge der Probe
  • foodType (String, optional): Von der Quell-App erfasster Lebensmittelname, wenn verfügbar

Mit Daten zusammenfassen ein enthalten Ernährungstotale kein foodType.

Sexuelle Aktivität

Einträge zu sexueller Aktivität erfassen die Schutzverwendung:

{
  "name": "sexual_activity",
  "units": "count",
  "data": [
    {
      "date": "2024-02-06 00:00:00 -0800",
      "Unspecified": 0,
      "Protection Used": 1,
      "Protection Not Used": 0,
      "source": "Health"
    }
  ]
}

Felder:

  • Unspecified (Number): Anzahl der Ereignisse an diesem Tag, wenn der Schutzstatus unbekannt ist
  • Protection Used (Number): Anzahl der Ereignisse an diesem Tag, wenn Schutz verwendet wurde
  • Protection Not Used (Number): Anzahl der Ereignisse an diesem Tag, wenn kein Schutz verwendet wurde

Zusammengefasste Exporte zählen jeden Kalendertag. JSON behält jeden Tag. In CSV zeigt eine gröbere Zeitgruppe den letzten Tag in dieser Gruppe.

Händewaschen

Händewasch-Ereignisse erfassen den Abschlussstatus:

{
  "name": "handwashing",
  "units": "s",
  "data": [
    {
      "date": "2024-02-06 12:00:00 -0800",
      "start": "2024-02-06 12:00:00 -0800",
      "end": "2024-02-06 12:00:25 -0800",
      "qty": 25,
      "value": "Completed",
      "source": "Apple Watch"
    }
  ]
}

Felder:

  • qty (Number): Dauer in Sekunden. Zusammengefasste Exporte verwenden die durchschnittliche Dauer in der Zeitgruppe.
  • value (String): "Completed", wenn die Sitzung länger als 20 Sekunden dauert, sonst "Incomplete"

Zähneputzen

Zähneputz-Ereignisse erfassen den Abschlussstatus:

{
  "name": "toothbrushing",
  "units": "s",
  "data": [
    {
      "date": "2024-02-06 08:00:00 -0800",
      "start": "2024-02-06 08:00:00 -0800",
      "end": "2024-02-06 08:02:10 -0800",
      "qty": 130,
      "value": "Completed",
      "source": "Health"
    }
  ]
}

Felder:

  • qty (Number): Dauer in Sekunden. Zusammengefasste Exporte verwenden die durchschnittliche Dauer in der Zeitgruppe.
  • value (String): "Completed", wenn die Sitzung mindestens 2 Minuten dauert, sonst "Incomplete"

Insulinabgabe

Insulinabgabe-Einträge enthalten den Grund der Abgabe:

{
  "name": "insulin_delivery",
  "units": "IU",
  "data": [
    {
      "date": "2024-02-06 08:00:00 -0800",
      "start": "2024-02-06 08:00:00 -0800",
      "end": "2024-02-06 08:00:00 -0800",
      "qty": 5,
      "reason": "Bolus",
      "source": "Health"
    }
  ]
}

Felder:

  • qty (Number): Abgegebene Insulinmenge. Zusammengefasste Exporte addieren die Mengen in der Zeitgruppe.
  • reason (String): Einer von:
    • "Bolus" (Mahlzeiteninsulin)
    • "Basal" (Hintergrundinsulin)

Verwandte Dokumentation