Welke Apple Health-datatypes verstuurt Life Dashboard?

De iPhone-app leest 28 Apple Health-types, en elk type staat uit tot je het aanzet onder Wat versturen, per categorie of met De basis of Alle types. Hij verstuurt ze onder de payload-sleutels van de Android-app, met dezelfde velden en eenheden: stappen, afstand en calorieën, work-outs, gewicht en lichaamssamenstelling, hartslag, hartslag in rust en HRV, bloeddruk, glucose, zuurstofsaturatie, ademfrequentie, VO2 max, slaap met fasen, water, voeding, mindfulness, lichaamstemperatuur en cyclusgegevens. Menstruatie gaat als twee sleutels de deur uit, dus een iPhone verstuurt 29 van de 34 sleutels van de Android-app.

Elke meting heeft een uuid, die van de Apple Health-sample zelf, en een source: de naam die Apple Health geeft aan de app of het apparaat dat haar schreef. De app leest alleen; hij schrijft nooit naar Apple Health.

Door Owen Vogelaar, de maker van Life Dashboard 9 min leestijd

Download de iPhone-app

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.

TypePayload-sleutelWaarde en eenheidHome AssistantApple Watch
StappenstepscountHet totaal van vandaagJa, en de iPhone
AfstanddistancemetersHet totaal van vandaagJa, en de iPhone
Actieve energieactive_caloriescalories, kcalHet totaal van vandaagJa
Totale energietotal_caloriescalories, kcalHet totaal van vandaagJa
Work-outsexercisetype, duration_secondsLaatste work-out, de minuten van vandaag en gisterenJa
GewichtweightkilogramsLaatste waardeNee
LengteheightmetersLaatste waardeNee
Percentage lichaamsvetbody_fatpercentageLaatste waardeNee
Vetvrije massalean_body_masskilogramsLaatste waardeNee
Hartslagheart_ratebpmLaatste waardeJa
Hartslag in rustresting_heart_ratebpmLaatste waardeJa
Hartritmevariabiliteitheart_rate_variabilityheart_rate_variability_millis, ms (SDNN)Laatste waardeJa
Bloeddrukblood_pressuresystolic, diastolic, mmHgTwee sensorenNee
Saturatieoxygen_saturationpercentageLaatste waardeSommige modellen en regio's
Ademfrequentierespiratory_raterate, ademhalingen per minuutLaatste waardeJa, terwijl je slaapt
Lichaamstemperatuurbody_temperaturecelsiusLaatste waardeNee
Basale lichaamstemperatuurbasal_body_temperaturecelsiusLaatste waardeNee
Bloedsuikerspiegelblood_glucosemmol_per_literLaatste waardeNee
VO2maxvo2_maxvo2_ml_per_min_per_kgLaatste waardeJa, tijdens sommige work-outs
Slaapsleepduration_seconds, stagesDe duur van de laatste slaap, de slaaptijd en de uren per faseJa, met fasen
Mindfulnessmindfulnessduration_secondsMinuten per dag, in de statistiekenOnbekend
WaterhydrationlitersLaatste drankjeNee
Voedingnutritioncalories, grammen en 34 andere voedingsstoffenDe calorieën, eiwitten, koolhydraten en vetten die je vandaag hebt gegetenNee
Menstruatiemenstruation_flow, menstruation_periodflow; start_time, end_timeGeen sensorNee
Spottingintermenstrual_bleedingAlleen het tijdstipGeen sensorNee
Uitslag ovulatietestovulation_testresultGeen sensorNee
Kwaliteit van cervixslijmcervical_mucusappearance, sensationGeen sensorNee
Seksuele activiteitsexual_activityprotection_usedGeen sensorNee

"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_calories krijg 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, sleeping en unknown, die Android ook stuurt, en in_bed, die alleen een iPhone stuurt: de tijd in bed rond de fasen, zelf geen fase.
  • De uuid van 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 source van 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-sleutelWaarom niet
speedDe iPhone-app leest snelheid nog niet.
bone_massApple Health heeft geen type voor botmassa.
body_water_massApple Health heeft geen type voor lichaamswater.
skin_temperatureApple Health bewaart de absolute polstemperatuur tijdens de slaap, niet de afwijking ten opzichte van een basislijn die deze sleutel bevat.
basal_metabolic_rateApple 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 in de App Store

€ 6,99 eenmalig in de App Store, geen abonnement.

Zelf bouwen met Xcode

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.