Sundhedsmålinger - JSON-eksportformat
Dokumentation for strukturen for sundhedsmålinger i JSON-eksporter
Senest opdateret: 31. oktober 2026
På denne side
JSON-eksporter gemmer sundhedsmålinger i arrayet metrics.
Format for målingsnavne
Alle målingsnavne i JSON-eksporter bruger formatet snake_case (små bogstaver med underscores). For eksempel:
- "Step Count" bliver
"step_count" - "Blood Pressure" bliver
"blood_pressure" - "Heart Rate" bliver
"heart_rate" - "Walking + Running Distance" bliver
"walking_running_distance"
Struktur
Arrayet metrics indeholder objekter, der hver repræsenterer en specifik type sundhedsmåling. De fleste sundhedsmålinger følger en fælles struktur:
{
"name": "step_count",
"units": "count",
"data": [
{
"qty": 8500,
"date": "2024-02-06 14:30:00 -0800",
"source": "Apple Watch"
}
]
}
Fælles felter
name(String): Navnet på sundhedsmålingen i snake_case-format (f.eks. "step_count", "heart_rate", "active_energy")units(String): Måleenheden (f.eks. "count", "count/min", "kcal")data(Array): Et array af datapunkter, der hver indeholder:qty(Number): Mængdeværdiendate(Date): Tidsstempel i formatetyyyy-MM-dd HH:mm:ss Zsource(String, når tilgængelig): Appen eller enheden, der registrerede prøven
Særlige målingsformater
Nogle sundhedsmålinger har unikke strukturer, der adskiller sig fra det fælles format:
Blodtryk
Blodtryksmålinger inkluderer både systoliske og diastoliske værdier:
{
"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"
}
]
}
Felter:
systolic(Number): Den systoliske (øvre) blodtryksmåling. Opsummerede eksporter bruger gennemsnittet af målingerne i tidsgruppen.diastolic(Number): Den diastoliske (nedre) blodtryksmåling. Opsummerede eksporter bruger gennemsnittet af målingerne i tidsgruppen.
Puls
Pulsdata inkluderer minimum-, gennemsnits- og maksimumværdier:
{
"name": "heart_rate",
"units": "count/min",
"data": [
{
"date": "2024-02-06 14:30:00 -0800",
"Min": 65,
"Avg": 72,
"Max": 85,
"source": "Apple Watch"
}
]
}
Felter:
Min(Number): Minimumspuls i måleperiodenAvg(Number): Gennemsnitspuls i måleperiodenMax(Number): Maximumspuls i måleperioden
Hjertefrekvensvariabilitet
Med Opsummer data slået fra kan JSON-eksporter af hjertefrekvensvariabilitet (SDNN) inkludere tilgængelige beat-to-beat-målinger. Disse kræver læseadgang til Hjerteslags-serie i Apple Health.
Opsummerede eksporter, CSV-eksporter og Recovery HRV inkluderer ikke beat-to-beat-målinger.
Søvnanalyse
Strukturen for søvndata afhænger af, om Opsummer data er slået til eller fra.
Opsummer data til
Med Opsummer data til opsummeres søvndata pr. dag. Varigheder i samme fase lægges sammen. Total søvn er asleep, core, deep og REM lagt sammen. JSON beholder hver dag. I CSV viser en grovere tidsgruppe den seneste dag i den gruppe:
{
"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"
}
]
}
Felter:
totalSleep(Number): Samlet tid i søvn i timerasleep(Number): Tid i søvn uden registreret søvnfase, i timercore(Number): Core-søvnvarighed i timerdeep(Number): Dyb søvnvarighed i timerrem(Number): REM-søvnvarighed i timerawake(Number): Tid vågen i timersleepStart(Date): Hvornår søvnen faktisk startedesleepEnd(Date): Hvornår søvnen faktisk sluttedeinBed(Number): Samlet tid i seng i timerinBedStart(Date): Hvornår du gik i senginBedEnd(Date): Hvornår du stod op
Opsummer data fra
Med Opsummer data fra inkluderes individuelle søvnsegmenter:
{
"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"
}
]
}
Felter:
date,start,startDate(Date): Starttidspunkt for søvnsegmentetend,endDate(Date): Sluttidspunkt for søvnsegmentetsource(String): Appen eller enheden, der registrerede segmentetqty(Number): Segmentets varighed i timervalue(String): Søvntilstand - en af:"Awake""Asleep"(ukategoriseret søvnfase)"In Bed""Core""REM""Deep""Unspecified"
Bemærk: "Asleep" refererer til en ukategoriseret søvnfase (ikke samlet tid i søvn). Dette kan forekomme, hvis datakilden ikke understøtter sporing af søvnfaser.
Blodsukker
Blodsukkermålinger inkluderer oplysninger om måltidstiming:
{
"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"
}
]
}
Felter:
qty(Number): BlodsukkerniveaumealTime(String): En af:"Before Meal""After Meal""Unspecified"
Ernæring
Når Opsummer data er slået fra, kan individuelle ernæringsmængdeprøver (for eksempel Kostenergi eller Kulhydrater) inkludere madoplysninger registreret i Apple Health. For eksempel:
{
"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"
}
]
}
Felter:
qty(Number): Næringsmængde for prøvenfoodType(String, valgfri): Madnavn registreret af kildeappen, når det er tilgængeligt
Med Opsummer data til inkluderer ernæringstotaler ikke foodType.
Seksuel aktivitet
Poster for seksuel aktivitet sporer brug af beskyttelse:
{
"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"
}
]
}
Felter:
Unspecified(Number): Antal begivenheder den dag, hvor beskyttelsesstatus er ukendtProtection Used(Number): Antal begivenheder den dag, hvor beskyttelse blev brugtProtection Not Used(Number): Antal begivenheder den dag, hvor beskyttelse ikke blev brugt
Opsummerede eksporter tæller hver kalenderdag. JSON beholder hver dag. I CSV viser en grovere tidsgruppe den seneste dag i den gruppe.
Håndvask
Håndvasksbegivenheder sporer fuldførelsesstatus:
{
"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"
}
]
}
Felter:
qty(Number): Varighed i sekunder. Opsummerede eksporter bruger den gennemsnitlige varighed i tidsgruppen.value(String):"Completed", når sessionen varer mere end 20 sekunder; ellers"Incomplete"
Tandbørstning
Tandbørstningsbegivenheder sporer fuldførelsesstatus:
{
"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"
}
]
}
Felter:
qty(Number): Varighed i sekunder. Opsummerede eksporter bruger den gennemsnitlige varighed i tidsgruppen.value(String):"Completed", når sessionen varer mindst 2 minutter; ellers"Incomplete"
Insulinlevering
Poster for insulinlevering inkluderer årsagen til levering:
{
"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"
}
]
}
Felter:
qty(Number): Mængde leveret insulin. Opsummerede eksporter summerer mængderne i tidsgruppen.reason(String): En af:"Bolus"(måltidsinsulin)"Basal"(basisinsulin)