Alle types in één oogopslag
De kolom Apple Watch zegt waar de documentatie van Apple beschrijft dat het horloge het type vastlegt; Apple Watch in Home Assistant linkt naar elke pagina. De andere types komen van de iPhone, van wat je zelf invoert, of van apps die naar Apple Health schrijven.
| Type | Payload-sleutel | Waarde en eenheid | Home Assistant | Apple Watch |
|---|---|---|---|---|
| Stappen | steps | count | Het totaal van vandaag | Ja, en de iPhone |
| Afstand | distance | meters | Het totaal van vandaag | Ja, en de iPhone |
| Actieve energie | active_calories | calories, kcal | Het totaal van vandaag | Ja |
| Totale energie | total_calories | calories, kcal | Het totaal van vandaag | Ja |
| Work-outs | exercise | type, duration_seconds | Laatste work-out, de minuten van vandaag en gisteren | Ja |
| Gewicht | weight | kilograms | Laatste waarde | Nee |
| Lengte | height | meters | Laatste waarde | Nee |
| Percentage lichaamsvet | body_fat | percentage | Laatste waarde | Nee |
| Vetvrije massa | lean_body_mass | kilograms | Laatste waarde | Nee |
| Hartslag | heart_rate | bpm | Laatste waarde | Ja |
| Hartslag in rust | resting_heart_rate | bpm | Laatste waarde | Ja |
| Hartritmevariabiliteit | heart_rate_variability | heart_rate_variability_millis, ms (SDNN) | Laatste waarde | Ja |
| Bloeddruk | blood_pressure | systolic, diastolic, mmHg | Twee sensoren | Nee |
| Saturatie | oxygen_saturation | percentage | Laatste waarde | Sommige modellen en regio's |
| Ademfrequentie | respiratory_rate | rate, ademhalingen per minuut | Laatste waarde | Ja, terwijl je slaapt |
| Lichaamstemperatuur | body_temperature | celsius | Laatste waarde | Nee |
| Basale lichaamstemperatuur | basal_body_temperature | celsius | Laatste waarde | Nee |
| Bloedsuikerspiegel | blood_glucose | mmol_per_liter | Laatste waarde | Nee |
| VO2max | vo2_max | vo2_ml_per_min_per_kg | Laatste waarde | Ja, tijdens sommige work-outs |
| Slaap | sleep | duration_seconds, stages | De duur van de laatste slaap, de slaaptijd en de uren per fase | Ja, met fasen |
| Mindfulness | mindfulness | duration_seconds | Minuten per dag, in de statistieken | Onbekend |
| Water | hydration | liters | Laatste drankje | Nee |
| Voeding | nutrition | calories, grammen en 34 andere voedingsstoffen | De calorieën, eiwitten, koolhydraten en vetten die je vandaag hebt gegeten | Nee |
| Menstruatie | menstruation_flow, menstruation_period | flow; start_time, end_time | Geen sensor | Nee |
| Spotting | intermenstrual_bleeding | Alleen het tijdstip | Geen sensor | Nee |
| Uitslag ovulatietest | ovulation_test | result | Geen sensor | Nee |
| Kwaliteit van cervixslijm | cervical_mucus | appearance, sensation | Geen sensor | Nee |
| Seksuele activiteit | sexual_activity | protection_used | Geen sensor | Nee |
"Nee" en "Onbekend" in de kolom Apple Watch betekenen dat de horlogedocumentatie van Apple, zoals die op deze site wordt aangehaald, niet beschrijft dat het horloge het type vastlegt, niet dat niets dat kan. Wil je zien wat een type op je eigen iPhone schrijft, open dan de app Gezondheid, zoek het type op en kijk onder Gegevensbronnen en toegang.
Welke bron welk type schrijft
- Apple Watch: stappen, afstand, actieve energie en energie in rust, work-outs, hartslag, hartslag in rust, HRV, slaap met fasen, ademfrequentie terwijl je slaapt, VO2 max tijdens sommige work-outs buiten, en zuurstofsaturatie op modellen en in regio's die het hebben. Apple Watch in Home Assistant heeft de details en de pagina's van Apple.
- iPhone: stappen en afstand. Een iPhone zonder horloge legt meestal geen energie in rust vast, dus
total_calorieskrijg je vooral met een horloge. - Andere apps en apparaten: de apps van andere horloges, ringen en weegschalen, zoals Garmin Connect, Oura en Withings, kunnen naar Apple Health schrijven, net als apps waarin je eten, water, je cyclus of meditatie bijhoudt. Wat ze schrijven hangt af van de app en je instellingen daar; elke meting noemt de app in
source.
Apple Health bewaart een wandeling die zowel de iPhone als het horloge heeft vastgelegd twee keer, één keer per apparaat. De daily_totals in elke payload tellen haar één keer, in de volgorde van de gegevensbronnen die je in de app Gezondheid instelt. Gebruik die dus voor dagtotalen.
Activiteit
Stappen
Sleutel steps: count, een geheel getal, over een interval van start_time tot end_time. Tot 1000 nieuwe metingen per sync.
Afstand
Sleutel distance: meters, over een interval. Apple Health heeft een afstandstype per soort activiteit, en de app leest ze allemaal: wandelen en hardlopen, fietsen, zwemmen, rolstoel, wintersport bergafwaarts, en vanaf iOS 18 roeien, peddelen, langlaufen en schaatsen. Ze overlappen niet, dus als je ze optelt, tel je niets dubbel. Een meting zegt niet van welke activiteit ze komt.
Actieve energie
Sleutel active_calories: calories in kcal, over een interval. De actieve energie van Apple Health.
Totale energie
Sleutel total_calories: calories in kcal, over een interval. Apple Health heeft geen type voor totale energie, dus dit zijn de metingen van energie in rust en actieve energie samen. Eén sample van actieve energie zit daardoor zowel in active_calories als in total_calories. Tot 1000 nieuwe metingen per sync. In daily_totals wordt het alleen verstuurd op dagen met energie in rust.
Work-outs
Sleutel exercise: type, start_time, end_time en duration_seconds, uit de work-outs van Apple Health. type is de activiteit in snake_case, zoals running, walking, downhill_skiing of hiit; other is de eigen categorie Other van Apple, of een activiteit uit een iOS-versie die nieuwer is dan de app. duration_seconds telt pauzes mee, dus het kan langer zijn dan de work-outtijd die de app Gezondheid toont. Android stuurt hier in plaats daarvan een getal als string, zoals "56" voor hardlopen.
Lichaam
Gewicht
Sleutel weight: kilograms, op een moment (time), met maximaal 2 decimalen, zodat een gewicht dat in ponden is ingevoerd de omrekening doorstaat.
Lengte
Sleutel height: meters, op een moment.
Percentage lichaamsvet
Sleutel body_fat: percentage, 0 tot 100, op een moment.
Vetvrije massa
Sleutel lean_body_mass: kilograms, op een moment.
Hart en vitale functies
Hartslag
Sleutel heart_rate: bpm, een geheel getal, op een moment, één meting per sample. Tot 1000 nieuwe metingen per sync. Elke sample heeft zijn eigen uuid; de vorm <uuid>#<time> van Android geldt hier niet.
Hartslag in rust
Sleutel resting_heart_rate: bpm, een geheel getal, op een moment.
Hartritmevariabiliteit
Sleutel heart_rate_variability: heart_rate_variability_millis, op een moment. Dit is SDNN, de maat die Apple Health bewaart. Android stuurt onder dezelfde sleutel RMSSD, de maat die Health Connect bewaart; de twee zijn niet hetzelfde getal, dus houd ze uit elkaar. Tot 500 nieuwe metingen per sync.
Bloeddruk
Sleutel blood_pressure: systolic en diastolic in mmHg, op een moment, per meting: de twee waarden die een app samen heeft bewaard. De zeldzame app die ze los bewaart, krijgt ze gekoppeld wanneer ze binnen een seconde van elkaar liggen. Een waarde zonder haar andere helft wordt niet verstuurd. uuid is die van de systolische sample.
Lichaamstemperatuur
Sleutel body_temperature: celsius, op een moment.
Basale lichaamstemperatuur
Sleutel basal_body_temperature: celsius, op een moment.
Bloedsuikerspiegel
Sleutel blood_glucose: mmol_per_liter, op een moment.
Saturatie
Sleutel oxygen_saturation: percentage, 0 tot 100, op een moment.
Ademfrequentie
Sleutel respiratory_rate: rate in ademhalingen per minuut, op een moment. Tot 500 nieuwe metingen per sync.
VO2max
Sleutel vo2_max: vo2_ml_per_min_per_kg, op een moment.
Slaap en mindfulness
Slaap
Sleutel sleep: session_end_time, duration_seconds en stages, elke fase met haar eigen stage, tijden, uuid en source. Apple Health kent geen slaapsessie, dus de app groepeert de samples van fasen tot nachten, en een gat van meer dan een uur begint een nieuwe nacht.
- Fasen:
light(Kern, Core bij Apple),deep,rem,awake,sleepingenunknown, die Android ook stuurt, enin_bed, die alleen een iPhone stuurt: de tijd in bed rond de fasen, zelf geen fase. - De
uuidvan een nacht komt van haar vroegste fase, dus die blijft gelijk terwijl de nacht groeit. Vervang de nacht wanneer ze langer terugkomt. Een fase die later wordt toegevoegd, verstuurt de hele nacht opnieuw. - De
sourcevan de nacht is de app of het apparaat dat de meeste fasen ervan heeft vastgelegd.
Mindfulness
Sleutel mindfulness: start_time, end_time en duration_seconds, van apps die mindfulness-sessies naar Apple Health schrijven. Geen title, die Android wel kan sturen.
Eten en drinken
Water
Sleutel hydration: liters, over een interval. Het water van Apple Health.
Voeding
Sleutel nutrition: calories, protein_grams, carbs_grams, fat_grams, name en 34 andere voedingsstoffen onder de sleutels van Android, zoals dietary_fibre_g, sugars_g, sodium_mg en caffeine_mg, over een interval. Elk veld is optioneel.
- Een voedingsmiddel dat een app heeft vastgelegd, met elke voedingsstof erin, is één record, met de naam als de app die heeft meegegeven.
- De 34 andere voedingsstoffen worden alleen gelezen van een voedingsmiddel dat ook energie, eiwitten, koolhydraten of vetten heeft. Een koffie die alleen met cafeïne is vastgelegd, wordt dus niet verstuurd.
- Apple Health heeft geen type voor transvet, onverzadigd vet, energie uit vet, foliumzuur of
meal_type, dus die komen nooit van een iPhone.
Cyclus bijhouden
Menstruatie
Eén schakelaar, twee sleutels. menstruation_flow heeft flow op een moment, met de waarden uit het gedeelde schema: light, medium, heavy of unknown. menstruation_period heeft alleen start_time en end_time: Apple Health kent geen record voor een periode, dus de app leidt periodes af uit opeenvolgende dagen met bloedverlies, en een gat tot 48 uur overbrugt één gemiste dag. De uuid van een periode komt van haar eerste dag met bloedverlies, dus vervang de periode wanneer ze langer terugkomt.
Spotting
Sleutel intermenstrual_bleeding: alleen de time.
Uitslag ovulatietest
Sleutel ovulation_test: result op een moment: positive (LH-piek), high (oestrogeenpiek), negative, inconclusive of unknown.
Kwaliteit van cervixslijm
Sleutel cervical_mucus: appearance en sensation op een moment. Apple Health legt geen gevoel vast, dus sensation is altijd unknown.
Seksuele activiteit
Sleutel sexual_activity: protection_used op een moment: protected of unprotected als de schrijvende app het heeft vastgelegd, anders unknown.
Via MQTT worden de cyclusgegevens niet gepubliceerd, omdat een retained topic geen plek is voor gegevens over voortplanting; basale lichaamstemperatuur wel. De integratie van Home Assistant en een webhook krijgen ze allemaal.
De vijf Android-sleutels die een iPhone nooit verstuurt
| Android-sleutel | Waarom niet |
|---|---|
speed | De iPhone-app leest snelheid nog niet. |
bone_mass | Apple Health heeft geen type voor botmassa. |
body_water_mass | Apple Health heeft geen type voor lichaamswater. |
skin_temperature | Apple Health bewaart de absolute polstemperatuur tijdens de slaap, niet de afwijking ten opzichte van een basislijn die deze sleutel bevat. |
basal_metabolic_rate | Apple Health bewaart energie in rust per interval, niet als waarde per dag. Ze gaat mee als onderdeel van total_calories. |
Getallen, limieten en resolutie
- Decimalen. 3 voor meters en liters; 2 voor kilogrammen, calorieën, Celsius, mmol/L en de voedingsstoffen; 1 voor percentages, bloeddruk, ademfrequentie, HRV en VO2 max. Nullen aan het eind vallen weg, dus 97.0 komt aan als
97. Aantallen, slagen per minuut en tijdsduren zijn gehele getallen. - Per sync. Tot 1000 nieuwe metingen voor hartslag, stappen en totale calorieën, 500 voor HRV en ademfrequentie, en 200 voor elk ander type. De volgende sync gaat verder waar deze stopte.
- Dataresolutie. Onder Wat versturen kun je hartslag, HRV, zuurstofsaturatie en ademfrequentie laten versturen als één gemiddelde per 1, 5 of 15 minuten of per uur, met een minimum en maximum; stappen, afstand en beide calorieën als som. Elk type begint op elke meting.
De payload-pagina voor iOS heeft elk detail, en het JSON Schema van de Android-app dekt beide apps. Voor Android: zie Health Connect-datatypes, app voor app.
Life Dashboard voor iPhone
Zet je types aan onder Wat versturen en tik op Voorbeeld van payload om te zien wat de volgende sync zou versturen.
Download de iPhone-app Payload-referentie voor iOS
De open-source iPhone-app die deze gids gebruikt. Geen account, en de data gaat alleen naar de plek die jij aanwijst. Meer over de app.
Veelgestelde vragen
Hoeveel Apple Health-types leest de iPhone-app?
28, elk uit tot je het aanzet onder Wat versturen. Menstruatie verstuurt twee sleutels, bloedverlies en periodes, dus een iPhone verstuurt 29 payload-sleutels.
Waarom verstuurt de iPhone geen botmassa of huidtemperatuur?
Apple Health heeft geen type voor botmassa of lichaamswater, en het bewaart de absolute polstemperatuur tijdens de slaap in plaats van de afwijking ten opzichte van een basislijn die de gedeelde payload bevat. Het basaal metabolisme gaat mee in total_calories.
Is HRV van een iPhone hetzelfde als van Android?
Nee. Apple Health bewaart SDNN en Health Connect bewaart RMSSD. Beide komen binnen in heart_rate_variability_millis, maar het zijn verschillende maten, dus middel of vergelijk ze niet.
Welke types worden sensoren in Home Assistant?
20 van de 28, met bloeddruk als twee sensoren. Work-outs krijgen een sensor voor de laatste work-out en de minuten van vandaag en gisteren, en work-outs en mindfulness tellen mee in de dagstatistieken, in uren. Vanaf versie 1.2.0 van de integratie tellen je maaltijden op tot de calorieën, eiwitten, koolhydraten en vetten die je vandaag hebt gegeten. Losse maaltijden en cyclusgegevens krijgen geen sensor; een webhook krijgt ze volledig.
Leest de app Schermtijd of het ecg?
Nee. Schermtijd kan de iPhone niet verlaten: iOS toont het alleen binnen een sandbox die niets naar buiten kan sturen. Alles buiten de 28 types blijft in Apple Health.