Gesundheitsmetriken - JSON-Exportformat
Dokumentation der Struktur von Gesundheitsmetriken in JSON-Exporten
Zuletzt aktualisiert: 31. Oktober 2026
Auf dieser Seite
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): Mengenwertdate(Date): Zeitstempel im Formatyyyy-MM-dd HH:mm:ss Zsource(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 MesszeitraumsAvg(Number): Durchschnittliche Herzfrequenz während des MesszeitraumsMax(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 Stundenasleep(Number): Schlafzeit ohne erfasste Schlafphase, in Stundencore(Number): Core-Schlafdauer in Stundendeep(Number): Tiefschlafdauer in Stundenrem(Number): REM-Schlafdauer in Stundenawake(Number): Wachzeit in StundensleepStart(Date): Wann der Schlaf tatsächlich begannsleepEnd(Date): Wann der Schlaf tatsächlich endeteinBed(Number): Gesamtzeit im Bett in StundeninBedStart(Date): Wann du ins Bett gegangen bistinBedEnd(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 Schlafsegmentsend,endDate(Date): Endzeit des Schlafsegmentssource(String): App oder Gerät, das das Segment erfasst hatqty(Number): Dauer des Segments in Stundenvalue(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): BlutzuckerspiegelmealTime(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 ProbefoodType(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 istProtection Used(Number): Anzahl der Ereignisse an diesem Tag, wenn Schutz verwendet wurdeProtection 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)