Welche Apple-Health-Datentypen sendet Life Dashboard?

Die iPhone-App liest 28 Apple-Health-Typen, und jeder ist aus, bis du ihn unter Was senden einschaltest, pro Kategorie oder mit Das Wesentliche oder Alle Typen. Sie sendet sie unter den Payload-Schlüsseln der Android-App, mit denselben Feldern und Einheiten: Schritte, Distanz und Kalorien, Trainings, Gewicht und Körperzusammensetzung, Herzfrequenz, Ruheherzfrequenz und HRV, Blutdruck, Blutzucker, Blutsauerstoff, Atemfrequenz, VO2max, Schlaf mit Phasen, Wasser, Ernährung, Achtsamkeit, Körpertemperatur und Zyklusprotokoll. Die Menstruation geht als zwei Schlüssel raus, ein iPhone sendet also 29 der 34 Schlüssel der Android-App.

Jeder Datensatz trägt eine uuid, die des Messwerts in Apple Health selbst, und ein source: den Namen, den Apple Health der App oder dem Gerät gibt, das ihn geschrieben hat. Die App liest nur; sie schreibt nie in Apple Health.

Von Owen Vogelaar, der Life Dashboard entwickelt 9 Min. Lesezeit

iPhone-App holen

Alle Typen im Überblick

Die Spalte Apple Watch sagt, wo Apples Dokumentation beschreibt, dass die Uhr den Typ aufzeichnet; Apple Watch in Home Assistant verlinkt jede dieser Seiten. Die anderen Typen kommen vom iPhone, aus dem, was du selbst einträgst, oder aus Apps, die in Apple Health schreiben.

TypPayload-SchlüsselWert und EinheitHome AssistantApple Watch
SchrittestepscountSumme von heuteJa, und das iPhone
DistanzdistancemetersSumme von heuteJa, und das iPhone
Aktivitätsenergieactive_caloriescalories, kcalSumme von heuteJa
Gesamtenergietotal_caloriescalories, kcalSumme von heuteJa
Trainingsexercisetype, duration_secondsLetztes Training, Minuten von heute und gesternJa
GewichtweightkilogramsLetzter WertNein
GrößeheightmetersLetzter WertNein
Körperfettanteilbody_fatpercentageLetzter WertNein
Magere Körpermasselean_body_masskilogramsLetzter WertNein
Herzfrequenzheart_ratebpmLetzter WertJa
Ruheherzfrequenzresting_heart_ratebpmLetzter WertJa
Herzfrequenzvariabilitätheart_rate_variabilityheart_rate_variability_millis, ms (SDNN)Letzter WertJa
Blutdruckblood_pressuresystolic, diastolic, mmHgZwei SensorenNein
Blutsauerstoffoxygen_saturationpercentageLetzter WertManche Modelle und Regionen
Atemfrequenzrespiratory_raterate, Atemzüge pro MinuteLetzter WertJa, im Schlaf
Körpertemperaturbody_temperaturecelsiusLetzter WertNein
Basaltemperaturbasal_body_temperaturecelsiusLetzter WertNein
Blutzuckerblood_glucosemmol_per_literLetzter WertNein
VO2maxvo2_maxvo2_ml_per_min_per_kgLetzter WertJa, bei manchen Trainings
Schlafsleepduration_seconds, stagesDauer des letzten Schlafs, Schlafzeit und Stunden pro PhaseJa, mit Phasen
Achtsamkeitmindfulnessduration_secondsMinuten pro Tag, in den StatistikenUnbekannt
WasserhydrationlitersLetztes GetränkNein
Ernährungnutritioncalories, Gramm und 34 weitere NährstoffeKalorien, Eiweiß, Kohlenhydrate und Fett, die du heute gegessen hastNein
Menstruationmenstruation_flow, menstruation_periodflow; start_time, end_timeKein SensorNein
Schmierblutungintermenstrual_bleedingNur die ZeitKein SensorNein
Ovulationstestergebnisovulation_testresultKein SensorNein
Zervixschleimcervical_mucusappearance, sensationKein SensorNein
Sexuelle Aktivitätsexual_activityprotection_usedKein SensorNein

„Nein“ und „Unbekannt“ in der Spalte Apple Watch heißen, dass Apples Dokumentation zur Uhr, wie sie auf dieser Website zitiert wird, nicht beschreibt, dass die Uhr den Typ aufzeichnet, nicht, dass es nichts gibt, was das kann. Um zu sehen, was auf deinem eigenen iPhone einen Typ schreibt, öffnest du die Health-App, suchst den Typ und siehst unter Datenquellen & Zugriff nach.

Welche Quelle welchen Typ schreibt

  • Apple Watch: Schritte, Distanz, Aktivitäts- und Ruheenergie, Trainings, Herzfrequenz, Ruheherzfrequenz, HRV, Schlaf mit Phasen, Atemfrequenz im Schlaf, VO2max bei manchen Outdoor-Trainings und Blutsauerstoff auf Modellen und in Regionen, die ihn haben. Apple Watch in Home Assistant hat die Details und Apples Seiten.
  • iPhone: Schritte und Distanz. Ein iPhone ohne Uhr zeichnet meist keine Ruheenergie auf, total_calories gibt es deshalb meist nur mit einer Uhr.
  • Andere Apps und Geräte: Die Apps anderer Uhren, Ringe und Waagen, etwa Garmin Connect, Oura und Withings, können in Apple Health schreiben, ebenso Apps, in denen du Essen, Wasser, deinen Zyklus oder Meditation erfasst. Was sie schreiben, hängt von der App und deinen Einstellungen dort ab; jeder Datensatz nennt die App in source.

Apple Health behält einen Spaziergang, den iPhone und Uhr beide aufgezeichnet haben, doppelt, einmal pro Gerät. Die daily_totals in jedem Payload zählen ihn einmal, in der Reihenfolge der Datenquellen, die du in der Health-App festlegst. Nimm also sie für Tagessummen.

Aktivität

Schritte

Schlüssel steps: count, eine ganze Zahl, über einen Zeitraum von start_time bis end_time. Bis zu 1000 neue Datensätze pro Synchronisierung.

Distanz

Schlüssel distance: meters, über einen Zeitraum. Apple Health führt einen Distanztyp pro Art von Aktivität, und die App liest sie alle: Gehen und Laufen, Radfahren, Schwimmen, Rollstuhl, alpiner Schneesport und ab iOS 18 Rudern, Paddeln, Skilanglauf und Skaten. Sie überschneiden sich nicht, beim Addieren zählt also nichts doppelt. Ein Datensatz sagt nicht, aus welcher Aktivität er stammt.

Aktivitätsenergie

Schlüssel active_calories: calories in kcal, über einen Zeitraum. Die Aktivitätsenergie von Apple Health.

Gesamtenergie

Schlüssel total_calories: calories in kcal, über einen Zeitraum. Apple Health hat keinen Typ für die Gesamtenergie, das hier sind also seine Datensätze für Ruhe- und Aktivitätsenergie zusammen. Ein Messwert der Aktivitätsenergie ist deshalb Teil von active_calories und von total_calories. Bis zu 1000 neue Datensätze pro Synchronisierung. In daily_totals wird der Wert nur an Tagen mit Ruheenergie gesendet.

Trainings

Schlüssel exercise: type, start_time, end_time und duration_seconds, aus den Trainings von Apple Health. type ist die Aktivität in snake_case, etwa running, walking, downhill_skiing oder hiit; other ist Apples eigenes „Sonstiges“ oder eine Aktivität aus einem iOS, das neuer ist als die App. duration_seconds enthält Pausen und kann deshalb länger sein als die Trainingszeit, die die Health-App zeigt. Android sendet hier stattdessen eine Nummer als Zeichenkette, etwa "56" für Laufen.

Körper

Gewicht

Schlüssel weight: kilograms, zu einem Zeitpunkt (time), mit bis zu 2 Nachkommastellen, damit ein in Pfund eingetragenes Gewicht die Umrechnung übersteht.

Größe

Schlüssel height: meters, zu einem Zeitpunkt.

Körperfettanteil

Schlüssel body_fat: percentage, 0 bis 100, zu einem Zeitpunkt.

Magere Körpermasse

Schlüssel lean_body_mass: kilograms, zu einem Zeitpunkt.

Herz und Vitalparameter

Herzfrequenz

Schlüssel heart_rate: bpm, eine ganze Zahl, zu einem Zeitpunkt, ein Datensatz pro Messwert. Bis zu 1000 neue Datensätze pro Synchronisierung. Jeder Messwert hat seine eigene uuid; die Form <uuid>#<time> von Android gilt hier nicht.

Ruheherzfrequenz

Schlüssel resting_heart_rate: bpm, eine ganze Zahl, zu einem Zeitpunkt.

Herzfrequenzvariabilität

Schlüssel heart_rate_variability: heart_rate_variability_millis, zu einem Zeitpunkt. Das ist SDNN, der Wert, den Apple Health speichert. Android sendet unter demselben Schlüssel RMSSD, den Wert, den Health Connect speichert; die beiden sind nicht dieselbe Zahl, halte sie also getrennt. Bis zu 500 neue Datensätze pro Synchronisierung.

Blutdruck

Schlüssel blood_pressure: systolic und diastolic in mmHg, zu einem Zeitpunkt, pro Messung: die zwei Werte, die eine App zusammen gespeichert hat. Bei der seltenen App, die sie getrennt speichert, werden sie gepaart, wenn sie innerhalb einer Sekunde aufeinanderfolgen. Ein Wert ohne seine andere Hälfte wird nicht gesendet. Die uuid ist die des systolischen Messwerts.

Körpertemperatur

Schlüssel body_temperature: celsius, zu einem Zeitpunkt.

Basaltemperatur

Schlüssel basal_body_temperature: celsius, zu einem Zeitpunkt.

Blutzucker

Schlüssel blood_glucose: mmol_per_liter, zu einem Zeitpunkt.

Blutsauerstoff

Schlüssel oxygen_saturation: percentage, 0 bis 100, zu einem Zeitpunkt.

Atemfrequenz

Schlüssel respiratory_rate: rate in Atemzügen pro Minute, zu einem Zeitpunkt. Bis zu 500 neue Datensätze pro Synchronisierung.

VO2max

Schlüssel vo2_max: vo2_ml_per_min_per_kg, zu einem Zeitpunkt.

Schlaf und Achtsamkeit

Schlaf

Schlüssel sleep: session_end_time, duration_seconds und stages, jede Phase mit eigenem stage, eigenen Zeiten, eigener uuid und eigenem source. Apple Health kennt keine Schlafeinheit. Die App fasst die Messwerte der Phasen deshalb zu Nächten zusammen, und eine Lücke von mehr als einer Stunde beginnt eine neue.

  • Phasen: light (Apples Kernschlaf), deep, rem, awake, sleeping und unknown, die auch Android sendet, und in_bed, das nur ein iPhone sendet: die Zeit im Bett rund um die Phasen, selbst keine Phase.
  • Die uuid einer Nacht stammt von ihrer frühesten Phase, sie bleibt also gleich, während die Nacht wächst. Ersetze die Nacht, wenn sie länger zurückkommt. Kommt später eine Phase dazu, wird die ganze Nacht noch einmal gesendet.
  • Das source der Nacht ist die App oder das Gerät, das die meisten ihrer Phasen aufgezeichnet hat.

Achtsamkeit

Schlüssel mindfulness: start_time, end_time und duration_seconds, aus Apps, die Achtsamkeitseinheiten in Apple Health schreiben. Kein title, den Android senden kann.

Essen und Trinken

Wasser

Schlüssel hydration: liters, über einen Zeitraum. Das Wasser von Apple Health.

Ernährung

Schlüssel nutrition: calories, protein_grams, carbs_grams, fat_grams, name und 34 weitere Nährstoffe unter den Schlüsseln von Android, etwa dietary_fibre_g, sugars_g, sodium_mg und caffeine_mg, über einen Zeitraum. Jedes Feld ist optional.

  • Ein Lebensmittel, das eine App erfasst hat, ist mit allen Nährstoffen darin ein Datensatz, mit seinem Namen, wenn die App einen angegeben hat.
  • Die 34 weiteren Nährstoffe werden nur aus einem Lebensmittel gelesen, das auch Energie, Eiweiß, Kohlenhydrate oder Fett hat. Ein Kaffee, der nur mit Koffein erfasst wurde, wird also nicht gesendet.
  • Für Transfett, ungesättigtes Fett, Energie aus Fett, Folsäure und meal_type hat Apple Health keinen Typ, sie kommen also nie von einem iPhone.

Zyklusprotokoll

Menstruation

Ein Schalter, zwei Schlüssel. menstruation_flow hat flow zu einem Zeitpunkt, mit den Werten des gemeinsamen Schemas light, medium, heavy oder unknown. menstruation_period hat nur start_time und end_time: Apple Health hat keinen Datensatz für die Periode. Die App leitet Perioden deshalb aus aufeinanderfolgenden Tagen mit Blutung ab, und eine Lücke von bis zu 48 Stunden überbrückt einen ausgelassenen Tag. Die uuid einer Periode stammt von ihrem ersten Tag mit Blutung. Ersetze die Periode also, wenn sie länger zurückkommt.

Schmierblutung

Schlüssel intermenstrual_bleeding: nur die Zeit in time.

Ovulationstestergebnis

Schlüssel ovulation_test: result zu einem Zeitpunkt: positive (LH-Anstieg), high (Östrogen-Anstieg), negative, inconclusive oder unknown.

Zervixschleim

Schlüssel cervical_mucus: appearance und sensation zu einem Zeitpunkt. Apple Health zeichnet kein Empfinden auf, sensation ist also immer unknown.

Sexuelle Aktivität

Schlüssel sexual_activity: protection_used zu einem Zeitpunkt: protected oder unprotected, wenn die schreibende App es festgehalten hat, sonst unknown.

Über MQTT werden die Einträge des Zyklusprotokolls nicht veröffentlicht, denn ein Topic mit Retain-Flag ist kein Ort für Daten zur Fortpflanzung; die Basaltemperatur wird veröffentlicht. Die Integration von Home Assistant und ein Webhook bekommen alle.

Die fünf Android-Schlüssel, die ein iPhone nie sendet

Android-SchlüsselWarum nicht
speedDie iPhone-App liest die Geschwindigkeit noch nicht.
bone_massApple Health hat keinen Typ für die Knochenmasse.
body_water_massApple Health hat keinen Typ für das Körperwasser.
skin_temperatureApple Health speichert die absolute Temperatur am Handgelenk im Schlaf, nicht die Abweichung von einem Basiswert, die dieser Schlüssel vorsieht.
basal_metabolic_rateApple Health speichert die Ruheenergie pro Zeitraum, keine Rate pro Tag. Sie geht als Teil von total_calories raus.

Zahlen, Grenzen und Auflösung

  • Nachkommastellen. 3 für Meter und Liter; 2 für Kilogramm, Kalorien, Celsius, mmol/L und die Nährstoffe; 1 für Prozentwerte, Blutdruck, Atemfrequenz, HRV und VO2max. Nullen am Ende fallen weg, 97.0 kommt also als 97 an. Anzahlen, Schläge pro Minute und Dauern sind ganze Zahlen.
  • Pro Synchronisierung. Bis zu 1000 neue Datensätze für Herzfrequenz, Schritte und Gesamtkalorien, 500 für HRV und Atemfrequenz und 200 für jeden anderen Typ. Die nächste Synchronisierung macht dort weiter, wo diese aufgehört hat.
  • Datenauflösung. Unter Was senden können Herzfrequenz, HRV, Blutsauerstoff und Atemfrequenz als ein Mittelwert pro 1, 5 oder 15 Minuten oder pro Stunde gesendet werden, mit Minimum und Maximum; Schritte, Distanz und beide Kalorienwerte als Summe. Jeder Typ beginnt bei jedem Datensatz.

Die iOS-Payload-Seite hat jedes Detail, und das JSON-Schema der Android-App gilt für beide Apps. Für Android siehe Health-Connect-Datentypen, App für App.

Life Dashboard für iPhone

Schalte deine Typen unter Was senden ein und tippe auf Payload-Vorschau. So siehst du, was die nächste Synchronisierung senden würde.

Laden im App Store

6,99 € einmalig im App Store, ohne Abo.

Mit Xcode bauen

iPhone-App holen iOS-Payload-Referenz

Die Open-Source-App für das iPhone, die diese Anleitung verwendet. Kein Konto, und die Daten gehen nur dorthin, wohin du sie schickst. Mehr zur App.

Häufige Fragen

Wie viele Apple-Health-Typen liest die iPhone-App?

28, jeder aus, bis du ihn unter Was senden einschaltest. Die Menstruation sendet zwei Schlüssel, Blutung und Perioden, ein iPhone sendet also 29 Payload-Schlüssel.

Warum sendet das iPhone keine Knochenmasse und keine Hauttemperatur?

Apple Health hat keinen Typ für Knochenmasse oder Körperwasser, und es speichert die absolute Temperatur am Handgelenk im Schlaf statt der Abweichung von einem Basiswert, die der gemeinsame Payload vorsieht. Der Grundumsatz geht innerhalb von total_calories raus.

Ist die HRV von einem iPhone dieselbe wie von Android?

Nein. Apple Health speichert SDNN und Health Connect speichert RMSSD. Beide kommen in heart_rate_variability_millis an, sind aber verschiedene Messgrößen. Bilde also keinen Mittelwert aus ihnen und vergleich sie nicht.

Welche Typen werden zu Sensoren in Home Assistant?

20 der 28, der Blutdruck als zwei Sensoren. Trainings bekommen einen Sensor für das letzte Training und die Minuten von heute und gestern, und Trainings und Achtsamkeit zählen in den Tagesstatistiken mit, in Stunden. Ab Version 1.2.0 der Integration summieren sich deine Mahlzeiten zu den Kalorien, dem Eiweiß, den Kohlenhydraten und dem Fett, die du heute gegessen hast. Einzelne Mahlzeiten und das Zyklusprotokoll bekommen keinen Sensor; ein Webhook bekommt sie vollständig.

Liest die App die Bildschirmzeit oder das EKG?

Nein. Die Bildschirmzeit kann das iPhone nicht verlassen: iOS zeigt sie nur in einer Sandbox, die nichts nach außen senden kann. Alles außerhalb der 28 Typen bleibt in Apple Health.