Gezondheidsmetrieken - JSON-exportformaat
Documentatie voor de structuur van gezondheidsmetrieken in JSON-exporten
Laatst bijgewerkt: 31 oktober 2026
Op deze pagina
JSON-exporten slaan gezondheidsmetrieken op in de array metrics.
Indeling metrieknaam
Alle metrieknamen in JSON-exporten gebruiken de indeling snake_case (kleine letters met underscores). Bijvoorbeeld:
- "Step Count" wordt
"step_count" - "Blood Pressure" wordt
"blood_pressure" - "Heart Rate" wordt
"heart_rate" - "Walking + Running Distance" wordt
"walking_running_distance"
Structuur
De array metrics bevat objecten, elk voor een specifiek type gezondheidsmetriek. De meeste gezondheidsmetrieken volgen een gemeenschappelijke structuur:
{
"name": "step_count",
"units": "count",
"data": [
{
"qty": 8500,
"date": "2024-02-06 14:30:00 -0800",
"source": "Apple Watch"
}
]
}
Gemeenschappelijke velden
name(String): De naam van de gezondheidsmetriek in snake_case (bijv. "step_count", "heart_rate", "active_energy")units(String): De meeteenheid (bijv. "count", "count/min", "kcal")data(Array): Een array van datapunten, elk met:qty(Number): De hoeveelheidswaardedate(Date): Tijdstempel in de indelingyyyy-MM-dd HH:mm:ss Zsource(String, wanneer beschikbaar): De app of het apparaat dat het monster heeft vastgelegd
Speciale metriekindelingen
Sommige gezondheidsmetrieken hebben unieke structuren die afwijken van het gemeenschappelijke formaat:
Bloeddruk
Bloeddrukmetingen omvatten zowel systolische als diastolische waarden:
{
"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"
}
]
}
Velden:
systolic(Number): De systolische (bovenste) bloeddrukmeting. Samengevatte exporten gebruiken het gemiddelde van de metingen in de tijdgroep.diastolic(Number): De diastolische (onderste) bloeddrukmeting. Samengevatte exporten gebruiken het gemiddelde van de metingen in de tijdgroep.
Hartslag
Hartslaggegevens omvatten minimum-, gemiddelde en maximumwaarden:
{
"name": "heart_rate",
"units": "count/min",
"data": [
{
"date": "2024-02-06 14:30:00 -0800",
"Min": 65,
"Avg": 72,
"Max": 85,
"source": "Apple Watch"
}
]
}
Velden:
Min(Number): Minimale hartslag tijdens de meetperiodeAvg(Number): Gemiddelde hartslag tijdens de meetperiodeMax(Number): Maximale hartslag tijdens de meetperiode
Hartslagvariabiliteit
Met Gegevens samenvatten uit kunnen JSON-exporten van hartslagvariabiliteit (SDNN) beschikbare beat-to-beat-metingen bevatten. Deze vereisen leestoegang tot Hartslagreeks in Apple Health.
Samengevatte exporten, CSV-exporten en Herstel-HRV bevatten geen beat-to-beat-metingen.
Slaapanalyse
De structuur van slaapgegevens hangt af van of Gegevens samenvatten aan of uit staat.
Gegevens samenvatten aan
Met Gegevens samenvatten aan worden slaapgegevens per dag samengevat. Duraties in dezelfde fase worden opgeteld. Totale slaap is asleep, core, deep en REM bij elkaar. JSON bewaart elke dag. In CSV toont een grovere tijdgroep de laatste dag in die groep:
{
"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"
}
]
}
Velden:
totalSleep(Number): Totale slaaptijd in urenasleep(Number): Tijd slapend zonder geregistreerde slaapfase, in urencore(Number): Core-slaapduur in urendeep(Number): Diepe slaapduur in urenrem(Number): REM-slaapduur in urenawake(Number): Tijd wakker in urensleepStart(Date): Wanneer de slaap werkelijk begonsleepEnd(Date): Wanneer de slaap werkelijk eindigdeinBed(Number): Totale tijd in bed in ureninBedStart(Date): Wanneer je naar bed ginginBedEnd(Date): Wanneer je uit bed ging
Gegevens samenvatten uit
Met Gegevens samenvatten uit worden individuele slaapsegmenten opgenomen:
{
"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"
}
]
}
Velden:
date,start,startDate(Date): Starttijd van het slaapsegmentend,endDate(Date): Eindtijd van het slaapsegmentsource(String): De app of het apparaat dat het segment heeft vastgelegdqty(Number): Duur van het segment in urenvalue(String): Slaapstatus - een van:"Awake""Asleep"(niet-gecategoriseerde slaapfase)"In Bed""Core""REM""Deep""Unspecified"
Opmerking: "Asleep" verwijst naar een niet-gecategoriseerde slaapfase (niet naar de totale slaaptijd). Dit kan voorkomen als de gegevensbron geen tracking van slaapfasen ondersteunt.
Bloedglucose
Bloedglucosemetingen bevatten informatie over maaltijdtiming:
{
"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"
}
]
}
Velden:
qty(Number): BloedglucoseniveaumealTime(String): Een van:"Before Meal""After Meal""Unspecified"
Voeding
Wanneer Gegevens samenvatten uit staat, kunnen individuele voedingshoeveelheidsmonsters (bijvoorbeeld Voedingsenergie of Koolhydraten) voedseldetails bevatten die in Apple Health zijn vastgelegd. Bijvoorbeeld:
{
"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"
}
]
}
Velden:
qty(Number): Voedingshoeveelheid van het monsterfoodType(String, optioneel): Voedselnaam vastgelegd door de bron-app, wanneer beschikbaar
Met Gegevens samenvatten aan bevatten voedingstotalen geen foodType.
Seksuele activiteit
Vermeldingen van seksuele activiteit registreren beschermingsgebruik:
{
"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"
}
]
}
Velden:
Unspecified(Number): Aantal gebeurtenissen die dag wanneer de beschermingsstatus onbekend isProtection Used(Number): Aantal gebeurtenissen die dag wanneer bescherming is gebruiktProtection Not Used(Number): Aantal gebeurtenissen die dag wanneer geen bescherming is gebruikt
Samengevatte exporten tellen elke kalenderdag. JSON bewaart elke dag. In CSV toont een grovere tijdgroep de laatste dag in die groep.
Handen wassen
Gebeurtenissen van handen wassen registreren de voltooiingsstatus:
{
"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"
}
]
}
Velden:
qty(Number): Duur in seconden. Samengevatte exporten gebruiken de gemiddelde duur in de tijdgroep.value(String):"Completed"wanneer de sessie langer dan 20 seconden duurt; anders"Incomplete"
Tanden poetsen
Gebeurtenissen van tanden poetsen registreren de voltooiingsstatus:
{
"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"
}
]
}
Velden:
qty(Number): Duur in seconden. Samengevatte exporten gebruiken de gemiddelde duur in de tijdgroep.value(String):"Completed"wanneer de sessie minstens 2 minuten duurt; anders"Incomplete"
Insulinetoediening
Vermeldingen van insulinetoediening bevatten de reden van toediening:
{
"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"
}
]
}
Velden:
qty(Number): Hoeveelheid toegediende insuline. Samengevatte exporten tellen de hoeveelheden in de tijdgroep op.reason(String): Een van:"Bolus"(maaltijdinsuline)"Basal"(basisinsuline)