·15 min lezen

Integratie met de Gezondheid-app: een praktische gids

Integratie met de Gezondheid-app: een praktische gids
Vertaald uit het EngelsLees het origineel

Maya is 28 en probeert erachter te komen of haar duizeligheidsaanvallen met POTS te maken kunnen hebben. Na een episode scrolt ze door de hartslaggrafiek van haar Apple Watch en ziet ze 142 bpm, dan 58 bpm en dan weer 131 bpm. De getallen kloppen, maar ze geven geen antwoord op de vragen die ze met een cardioloog moet bespreken: hing de stijging samen met opstaan? Hoe lang duurde het? Was ze vlak daarvoor aan het sporten, aan het herstellen, uitgedroogd of in slaap?

Precies dat gat is waar het bij integratie met de Gezondheid-app om draait. Apple-apparaten kunnen veel biometrische gegevens verzamelen, maar losse metingen spreken zelden voor zich. Voor zinvolle monitoring is een tweede laag nodig die tijdstip en context toevoegt, patronen herkent en alles zo presenteert dat iemand anders het kan beoordelen.

Wat integratie met de Gezondheid-app echt betekent

Integratie met de Gezondheid-app is niet één schakelaar of een losse functie. Het gaat om de technische koppelingen, gebaseerd op toestemming, waarmee goedgekeurde apps gegevens kunnen lezen uit de onderliggende gegevensopslag van de Gezondheid-app en er in sommige gevallen ook gegevens naartoe kunnen schrijven. Dat ecosysteem bestaat uit de Gezondheid-app op de iPhone, het HealthKit-framework, de sensoren in de iPhone en Apple Watch, en apps van derden die om specifieke toegang vragen.

Apple introduceerde HealthKit tijdens WWDC op 2 juni 2014 en bracht de Gezondheid-app op 17 september 2014 voor iedereen uit met iOS 8. Later beschreef Apple de Gezondheid-app en de Apple Watch, die in 2015 uitkwam, in het Health Report van Apple als onderdelen van een breder platform dat steeds verder is uitgebreid over iPhone, iPad, Apple Watch en compatibele apps. Die geschiedenis is belangrijk, omdat ontwikkelaars niet aansluiten op een gloednieuw experiment. Ze bouwen voort op een gezondheidsgegevenslaag die al jaren bestaat.

Voor Maya komt het belangrijkste onderscheid hierop neer:

  • De Apple Watch doet metingen of levert er een bijdrage aan.
  • HealthKit ordent die metingen veilig op het apparaat.
  • De Gezondheid-app is de plek waar ze bronnen kan bekijken en toestemmingen kan beheren.
  • Een gespecialiseerde app kan geselecteerde gegevens interpreteren en er episodes, trends of rapporten van maken.

De Gezondheid-app kan laten zien dat haar hartslag veranderde. Een analyse-app kan nagaan of die veranderingen een betekenisvol patroon vormen.

Een diagram dat laat zien hoe integratie met de Gezondheid-app de nodige context toevoegt aan ruwe hartslaggegevens van een Apple Watch.

Ruwe metingen zijn pas het begin

Een hartslagwaarde krijgt pas betekenis in samenhang met de details eromheen. Het tijdstip van de meting, of iemand in beweging was, de uitgangswaarde daarvoor, hoe lang de verhoging aanhield en bijbehorende klachten kunnen allemaal bepalen hoe je de waarde interpreteert.

Dat betekent niet dat een app een aandoening kan vaststellen aan de hand van een grafiek. Het betekent dat integratie het handwerk kan verminderen dat nodig is om een samenhangend verloop op te bouwen. In plaats van dat Maya elke episode moet onthouden, kan een app met alleen-lezentoegang de toegestane HealthKit-metingen doorzoeken, patronen herkennen en de resultaten aan haar voorleggen.

Vuistregel: De Gezondheid-app bewaart het bewijs. Een verantwoorde app hoort het patroon uit te leggen zonder te doen alsof dat patroon een diagnose is.

Hoe HealthKit en de Gezondheid-app samenwerken

Zie het systeem als een bibliotheek. De Gezondheid-app is de balie, waar je je account bekijkt, bronnen controleert en bepaalt welke informatie een app mag inzien. HealthKit is het magazijn met de catalogus erachter: het framework dat gezondheidsmetingen van goedgekeurde apps en apparaten opslaat en ordent.

Deze vergelijking helpt om twee dingen uit elkaar te houden die vaak door elkaar worden gehaald. Dat je de Gezondheid-app opent, betekent niet dat elke andere app alles kan zien wat daar staat. Elke app moet om bepaalde soorten gegevens vragen, en iOS legt die verzoeken aan jou voor, zodat je ze kunt goedkeuren of weigeren.

Het gegevensmodel achter de grafieken

HealthKit behandelt hartslag niet als één ongedifferentieerde lijn. Het slaat metingen op per type, zoals hartslag, aantal stappen, slaapanalyse of trainingsgegevens. Een meting kan een begintijd, een eindtijd, een bronapparaat en extra metadata bevatten.

Door die opbouw kan een app gerichte vragen stellen. Hij kan bijvoorbeeld hartslagmetingen binnen een bepaald tijdvak opvragen, nagaan welk apparaat ze heeft geregistreerd, of metingen vergelijken met trainingsperiodes. Een app krijgt geen toestemming om de hele kluis rond te snuffelen alleen omdat hij één categorie mag lezen.

Een diagram dat aan de hand van een bibliotheekvergelijking het verschil tussen de Gezondheid-app en HealthKit uitlegt.

Toestemming is onderdeel van de opbouw

Volgens Apple worden HealthKit-gegevens op het apparaat zelf opgeslagen en versleuteld, zodat ze alleen met de toegangscode, Touch ID of Face ID van de gebruiker toegankelijk zijn. Apple stelt ook dat de waarden in de Gezondheid-app volledig op het apparaat worden berekend uit sensorgegevens van de Apple Watch en iPhone, zoals beschreven in de whitepaper over privacy in de Gezondheid-app.

Er zijn daarom twee soorten toestemmingsbeslissingen nodig. Eerst moet de app aangeven welke gegevenscategorieën hij wil gebruiken. Daarna bepaal jij welke van de gevraagde categorieën je toestaat. Die keuzes kun je later bekijken of intrekken in de instellingen van de Gezondheid-app.

Lezen en schrijven zijn aparte toestemmingen

Met leestoegang kan een app bepaalde bestaande metingen inzien. Met schrijftoegang kan hij toegestane metingen aan HealthKit toevoegen. Een app kan om het een, het ander of allebei vragen.

Dat onderscheid is belangrijk als je wilt inschatten of je een app kunt vertrouwen. Een monitoringapp die alleen bestaande hartslaggegevens nodig heeft, heeft geen schrijftoegang nodig om ze te analyseren. Hoe beperkter het verzoek, hoe makkelijker het is om te begrijpen wat de app kan.

Welke gegevens apps kunnen lezen en waarom alleen-lezen belangrijk is

HealthKit kan veel categorieën gezondheidsinformatie beschikbaar stellen, maar wat beschikbaar is, hangt af van het apparaat, de bron, je toestemmingen en de manier waarop een app om toegang vraagt. Een app voor hartslagmonitoring kan vragen om hartslag, hartslagvariabiliteit, rusthartslag, trainingen of compatibele ECG-gegevens. Een andere app kan zich richten op slaap, stappen, ademhalingsfrequentie, zuurstofgehalte in het bloed of medische dossiers, waar die beschikbaar zijn.

Toestemmingen zijn heel specifiek. Je kunt een app toestaan je hartslag te lezen en tegelijk slaapgegevens weigeren; de app kan dan geen categorie inzien die je niet hebt goedgekeurd. Hetzelfde geldt voor schrijven. Een app die één soort gegevens mag schrijven, krijgt niet automatisch toestemming om alle andere soorten te schrijven.

Gegevenstype Lezen Schrijven
Hartslag Ja Mogelijk met toestemming
Hartslagvariabiliteit Ja Mogelijk met toestemming
Rusthartslag Ja Mogelijk met toestemming
ECG-opnames Waar ondersteund en toegestaan Beperkt door het gegevenstype en de mogelijkheden van de app
Zuurstofgehalte in het bloed Waar ondersteund en toegestaan Alleen mogelijk als HealthKit dit type toestaat
Slaapanalyse en slaapfasen Ja, waar beschikbaar Mogelijk met toestemming
Stappen Ja Mogelijk met toestemming
Trainingen Ja Mogelijk met toestemming
Ademhalingsfrequentie Ja, waar beschikbaar Mogelijk met toestemming
Medische dossiers Waar beschikbaar en toegestaan Afhankelijk van het type dossier en de ondersteuning door het framework

Waarom beperktere toegang meer vertrouwen geeft

Een ontwerp met alleen leestoegang trekt een duidelijke grens. Een app met alleen leestoegang kan bestaande gegevens analyseren, maar kan geen metingen toevoegen om een dashboard vollediger te laten lijken, en kan een logboek niet aanpassen zodat het bij een bepaalde interpretatie past. Hij kan ook geen aandoening registreren die je zelf nooit hebt ingevoerd.

Die grens is belangrijk bij het monitoren van POTS en dysautonomie, omdat de kwaliteit van de conclusie afhangt van de betrouwbaarheid van de onderliggende tijdlijn. Als een app de brongegevens wijzigt, is een latere beoordeling minder goed te vertrouwen. Bij een werkwijze met alleen leestoegang blijven de oorspronkelijke gegevens in de Gezondheid-app staan en vindt de interpretatie plaats in een aparte laag.

Een nuttige vraag: moet de app iets schrijven, of hoeft hij alleen te begrijpen wat er al in de Gezondheid-app staat?

Alleen-lezen maakt een app niet automatisch nauwkeurig of medisch geschikt. Het maakt de gegevensstroom wel makkelijker uit te leggen. De app leest goedgekeurde metingen, voert de analyse uit die hij belooft en laat jou bepalen wat er daarna gebeurt.

Integratie met de Gezondheid-app stap voor stap instellen

Het instellen begint wanneer een app zoals Cardiogram om toegang tot de Gezondheid-app vraagt. Het toestemmingsscherm van het systeem toont de categorieën die de app wil lezen of schrijven. Keur het verzoek niet zomaar goed. Bekijk elke categorie en geef alleen toegang tot wat past bij het doel van de app.

Begin bij het toestemmingsscherm van het systeem

Voor het analyseren van hartslagpatronen kunnen de volgende verzoeken relevant zijn:

  1. Hartslag, met de geregistreerde metingen in slagen per minuut.
  2. Hartslagvariabiliteit, die een extra signaal kan toevoegen voor trendanalyse.
  3. Rusthartslag, die helpt om je persoonlijke uitgangswaarde vast te stellen.
  4. Trainingen, die context bieden om verhogingen door inspanning te onderscheiden van andere gebeurtenissen.

De app kan alleen de categorieën gebruiken die jij goedkeurt. Als je toegang tot slaap of trainingen overslaat, heeft de analyse die aanvullende gegevens niet tot haar beschikking.

Een infographic in drie stappen die laat zien hoe de Cardiogram-app toestemming vraagt en krijgt om gegevens uit de Gezondheid-app te gebruiken.

Controleer de toegang na het instellen

Je kunt je toestemmingen later terugvinden via Instellingen > Privacy en beveiliging > Gezondheid. Het scherm in de app en het instellingenscherm van iOS hebben elk een ander doel. Met het eerste systeemscherm geef je toegang, terwijl je in de instellingen die keuze later kunt bekijken of wijzigen.

Zet Ververs op achtergrond aan als de app afhankelijk is van updates op de achtergrond, en sta meldingen toe als je een waarschuwing wilt krijgen wanneer de app een relevante gebeurtenis signaleert. Deze instellingen maken van HealthKit geen continue livestream, maar kunnen de app wel helpen nieuwe informatie te verwerken wanneer het besturingssysteem dat toelaat.

Voor een uitgebreidere werkwijze om je gegevens klaar te maken voor een beoordeling, zie deze gids over gegevens exporteren uit de Gezondheid-app.

Ontbrekende gegevens oplossen

Als er geen gegevens verschijnen, controleer dan eerst de bron voordat je aanneemt dat de integratie niet werkt:

  • Controleer de verbinding met je horloge. Zorg dat de Apple Watch gekoppeld is aan de juiste iPhone.
  • Controleer polsdetectie. Het verzamelen van sensorgegevens kan worden beïnvloed als je het horloge niet draagt of als polsdetectie is uitgeschakeld.
  • Bekijk de bronnen in de Gezondheid-app. Open de betreffende meetwaarde in de Gezondheid-app en kijk welke bronnen gegevens aanleveren.
  • Controleer je toestemmingen opnieuw. Een app kan toegang hebben tot je hartslag, maar niet tot trainingen of HRV.
  • Geef het even de tijd. Levering op de achtergrond kan vertraagd zijn, dus een app reageert misschien niet meteen op een nieuwe meting.

Een uitgewerkt voorbeeld bij POTS en dysautonomie

Neem een app met alleen leestoegang die de hartslaggegevens analyseert van iemand die duizelig wordt na het opstaan. De Gezondheid-app levert de onderliggende metingen. De app heeft als taak die metingen in een tijdlijn te zetten die antwoord geeft op nuttigere vragen dan "Wat was mijn hartslag?"

Een werkwijze die op de aandoening is toegespitst, kan een uitgangswaarde bepalen, zoeken naar een flinke stijging binnen korte tijd en de piek en de aanhoudende duur vastleggen. Cardiogram beschrijft automatische detectie van stijgingen van 30+ bpm binnen 5 minuten, waarbij tijdstip, uitgangswaarde, piek en duur van de episode worden vastgelegd zodat je ze kunt terugkijken. Dat criterium is een regel voor screening en monitoring, geen diagnose, en een arts moet het beoordelen in combinatie met je klachten en andere medische informatie.

Context onderscheidt patronen van ruis

Een hoge waarde tijdens een training moet je niet op dezelfde manier behandelen als een stijging terwijl je in de keuken staat. Trainingsgegevens en herstelperiodes kunnen daarom worden uitgesloten bij het tellen van episodes, waardoor een veelvoorkomende bron van misleidende waarschuwingen wegvalt.

Slaap, klachten, vochtinname, zoutinname, medicatie en context over je activiteit kunnen nog een laag toevoegen. Je kunt bijvoorbeeld duizeligheid of hartkloppingen rond een episode noteren en daarna nagaan of vergelijkbare gebeurtenissen optreden na slecht slapen of op bepaalde momenten van de dag. Het resultaat is geen medische conclusie. Het is een beter geordende verzameling observaties voor een gesprek met je arts.

Voor uitleg over hoe ruwe gegevens kunnen uitgroeien tot patronen over langere tijd, zie deze gids over trendanalyse van gezondheidsgegevens.

Verwerking op het apparaat verandert de werkwijze

Volgens Apple blijven HealthKit-gegevens beschermd op het apparaat, en apps kunnen zo worden ontworpen dat ze lokale samenvattingen lezen zonder dat een server toegang nodig heeft tot je ruwe gezondheidsgeschiedenis. Bij een model waarin alles op het apparaat gebeurt, analyseert de app de toegestane metingen lokaal en synchroniseert hij via je eigen iCloud, in plaats van ruwe gegevens naar de servers van een leverancier te sturen.

Het resultaat kan een wekelijks overzicht zijn, een heatmap van wanneer episodes optreden, of een pdf waarin het detectiecriterium staat en episodes, klachten en trends worden samengevat. Dat lost het praktische probleem op waar Maya aan het begin tegenaan liep. Haar arts heeft niets aan eindeloos scrollen door losse punten in een grafiek. Wat nodig is, is een beknopt overzicht van wat er gebeurde, wanneer het gebeurde en welke context de patiënt zelf heeft opgemerkt.

Waar integratie met de Gezondheid-app nog tekortschiet

Integratie met de Gezondheid-app kan gegevensbronnen met elkaar verbinden, maar zorgt er niet automatisch voor dat ze overeenkomen. De Gezondheid-app wordt vaak gezien als één samenhangend dossier, maar de gegevens kunnen nog steeds verschillen in tijdstip, dekking, metadata en de prioriteit van bronnen.

Onafhankelijke berichtgeving wijst op een belangrijke beperking: HealthKit stemt gegevens van verschillende merken wearables niet op elkaar af en biedt geen ingebouwde trend- of paraatheidssignalen. Wie meerdere apparaten gebruikt, kan overlappende gegevens, gaten of tegenstrijdige metingen tegenkomen. De integratie kan technisch prima werken, terwijl jij nog steeds moet bepalen welke bron leidend is voor een trend.

Ruwe gegevens worden niet vanzelf inzicht

HealthKit levert gestructureerde gezondheidsmetingen, geen interpretatielaag die op een bepaalde aandoening is afgestemd. Het herkent zelf geen orthostatische episode, legt niet uit waarom je hartslag steeg en maakt geen samenvatting van POTS-klachten die klaar is voor je arts.

Dat werk ligt bij de app die de gegevens leest. Als de app geen geschikte filters, contextregistratie of rapportage biedt, blijft het jouw taak om een lange geschiedenis om te zetten in iets wat een zorgteam kan beoordelen.

De telefoon blijft in de praktijk de toegangspoort

Omdat HealthKit is opgezet rond lokale opslag op het apparaat en expliciete toestemming, zijn veel integraties afhankelijk van een app op de iPhone die de informatie leest en verpakt voordat een ander systeem ermee aan de slag kan. Dat beschermt jouw zeggenschap, maar kan de samenwerking tussen systemen minder gemakkelijk maken.

Dezelfde spanning zie je wanneer mensen gezondheidsgegevens uit verschillende ecosystemen willen combineren. Recente berichtgeving geeft aan dat synchronisatie tussen ecosystemen in aanverwante markten beter wordt, maar dat de beschikbaarheid en de ondersteunde gegevenstypen kunnen verschillen. De nuttige vraag is niet alleen of een app "werkt met de Gezondheid-app". Vraag ook welke gegevenstypen hij leest, hoeveel geschiedenis hij importeert, hoe hij met dubbele gegevens omgaat en welke bron voorrang krijgt.

Sterke privacy kan ten koste gaan van gemak. Die afweging is alleen acceptabel als de app exporteren, beoordelen en het beheren van toestemmingen duidelijk maakt.

Er zijn nog andere gaten die de interpretatie kunnen beïnvloeden. HRV kan op sommige apparaten ontbreken of onregelmatig zijn, slaapfasen kunnen versnipperd zijn, en informatie over klachten moet vaak bewust met de hand worden bijgehouden. Die beperkingen kosten de patiënt tijd, vooral wanneer een arts context nodig heeft in plaats van nog een grafiek zonder toelichting.

Best practices voor ontwikkelaars die met HealthKit bouwen

Ontwikkelaars die met HealthKit werken, moeten levering op de achtergrond zien als een meldingssysteem dat op gebeurtenissen reageert, niet als een continue stroom hartslaggegevens. Apple documenteert dat voor de meeste gegevenstypen in watchOS de levering op de achtergrond beperkt is in frequentie, terwijl bepaalde gebeurtenistypen, waaronder meldingen over een hoge hartslag, een lage hartslag en een onregelmatig ritme, direct kunnen worden geleverd. Een betrouwbaar ontwerp houdt rekening met gebundelde levering en met een app die slechts af en toe wordt geactiveerd.

Vraag wijzigingen op, niet het hele archief

Gebruik een observer query met enableBackgroundDelivery om te weten te komen dat relevante gegevens mogelijk zijn gewijzigd, en gebruik daarna een anchored query om alleen de metingen op te halen die sinds het laatste controlepunt zijn toegevoegd. Zo voorkom je dat dezelfde geschiedenis steeds opnieuw wordt verwerkt, en wordt de lokale toestand van de app beter te overzien.

Filter trainingsmetingen en herstelperiodes eruit voordat je trends in de rusthartslag berekent. Anders kunnen verhogingen door inspanning de uitgangswaarde vertekenen waar een episodedetector op steunt.

Houd opslag en autorisatie beperkt

Bundel schrijfacties via HKHealthStore.save wanneer schrijven nodig is. Als het product alleen bestaande gegevens analyseert, kies dan voor autorisatie met alleen leestoegang en vraag geen schrijfrechten aan die geen duidelijk doel voor de gebruiker dienen.

Sla afgeleide inzichten op het apparaat op met een geschikte lokale opslaglaag, zoals SwiftData of Core Data. Leg elke gevraagde categorie in begrijpelijke taal uit voordat je het toestemmingsscherm van het systeem toont. De uitleg bij de toestemming moet overeenkomen met de code.

Zorg er ten slotte voor dat de privacyverklaring klopt met de werkelijkheid. Als de app zegt dat de analyse lokaal plaatsvindt, moeten de implementatie en de gegevensstroom dat ook waarmaken. Een privacylabel is geen marketingtekst. Het is een afspraak met de gebruiker.

Integraties kiezen die je kunt vertrouwen

Stel jezelf vier praktische vragen voordat je op Sta toe tikt:

  • Wat kan de app lezen en schrijven? Alleen leestoegang is beperkter dan lees- en schrijftoegang.
  • Waar vindt de verwerking plaats? Analyse op het apparaat voorkomt dat gevoelige gegevens onnodig worden verplaatst.
  • Komt de privacyuitleg overeen met het toestemmingsscherm? De beschrijving van de app moet dezelfde categorieën noemen als waar de app om vraagt.
  • Kun je exporteren en de toegang intrekken? Je moet zonder verwarring een bruikbaar rapport kunnen maken, toestemmingen kunnen wijzigen en kunnen stoppen met delen.

Een betrouwbare integratie met de Gezondheid-app vraagt om zo weinig mogelijk toegang, legt het doel uit voordat je toestemming geeft en houdt ruwe gegevens gescheiden van de interpretatie die ervan is afgeleid. Voor meer hulp bij het beoordelen van keuzes rond opslag en toestemming, lees deze gids over privacy van gezondheidsgegevens.

De nuttigste integratie is niet de integratie die de meeste informatie verzamelt. Het is de integratie die goedgekeurde gegevens omzet in een transparant resultaat dat je kunt nakijken, terwijl de oorspronkelijke gegevens en jouw zeggenschap behouden blijven.


Cardiogram leest toegestane hartslaggegevens uit de Gezondheid-app met alleen leestoegang, analyseert patronen op het apparaat en ordent episodes, trends, context en rapporten voor je arts, voor mensen die klachten van POTS of dysautonomie bijhouden. Ga naar Cardiogram om te zien hoe je de Apple Watch en de Gezondheid-app die je al gebruikt kunt inzetten om je gegevens makkelijker te bekijken en te delen.

Alle berichten
Cardiogram Pro

Maak van je hartslaggegevens antwoorden

Automatische episodedetectie, notities over symptomen, trends en pdf-rapporten voor je cardioloog in één privé-app.

Probeer Cardiogram gratis3 dagen gratis, altijd opzegbaar.