Helsemål - JSON-eksportformat
Dokumentasjon for strukturen for helsemål i JSON-eksporter
Sist oppdatert: 31. oktober 2026
På denne siden
JSON-eksporter lagrer helsemål i arrayen metrics.
Format for målnavn
Alle målnavn i JSON-eksporter bruker formatet snake_case (små bokstaver med understreker). For eksempel:
- "Step Count" blir
"step_count" - "Blood Pressure" blir
"blood_pressure" - "Heart Rate" blir
"heart_rate" - "Walking + Running Distance" blir
"walking_running_distance"
Struktur
Arrayen metrics inneholder objekter, der hvert objekt representerer en spesifikk type helsemål. De fleste helsemål følger en felles struktur:
{
"name": "step_count",
"units": "count",
"data": [
{
"qty": 8500,
"date": "2024-02-06 14:30:00 -0800",
"source": "Apple Watch"
}
]
}
Felles felt
name(String): Navnet på helsemålet i snake_case-format (f.eks. "step_count", "heart_rate", "active_energy")units(String): Måleenheten (f.eks. "count", "count/min", "kcal")data(Array): En array med datapunkter, som hver inneholder:qty(Number): Mengdeverdidate(Date): Tidsstempel i formatetyyyy-MM-dd HH:mm:ss Zsource(String, når tilgjengelig): Appen eller enheten som registrerte prøven
Spesielle målformater
Noen helsemål har unike strukturer som skiller seg fra det felles formatet:
Blodtrykk
Blodtrykksmålinger inkluderer både systoliske og diastoliske verdier:
{
"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"
}
]
}
Felt:
systolic(Number): Den systoliske (øvre) blodtrykksmålingen. Summerte eksporter bruker gjennomsnittet av målingene i tidsgruppen.diastolic(Number): Den diastoliske (nedre) blodtrykksmålingen. Summerte eksporter bruker gjennomsnittet av målingene i tidsgruppen.
Hjertefrekvens
Hjertefrekvensdata inkluderer minimum-, gjennomsnitts- og maksimumsverdier:
{
"name": "heart_rate",
"units": "count/min",
"data": [
{
"date": "2024-02-06 14:30:00 -0800",
"Min": 65,
"Avg": 72,
"Max": 85,
"source": "Apple Watch"
}
]
}
Felt:
Min(Number): Minimum hjertefrekvens i måleperiodenAvg(Number): Gjennomsnittlig hjertefrekvens i måleperiodenMax(Number): Maksimum hjertefrekvens i måleperioden
Hjertefrekvensvariabilitet
Med Summer data av kan JSON-eksporter av hjertefrekvensvariabilitet (SDNN) inkludere tilgjengelige beat-to-beat-målinger. Disse krever lesetilgang for Hjertefrekvensserie i Apple Health.
Summerte eksporter, CSV-eksporter og Recovery HRV inkluderer ikke beat-to-beat-målinger.
Søvnanalyse
Strukturen for søvndata avhenger av om Summer data er på eller av.
Summer data på
Med Summer data på summeres søvndata per dag. Varigheter i samme fase legges sammen. Total søvn er asleep, core, deep og REM lagt sammen. JSON beholder hver dag. I CSV viser en grovere tidsgruppe den siste dagen i den gruppen:
{
"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"
}
]
}
Felt:
totalSleep(Number): Total tid i søvn i timerasleep(Number): Tid i søvn uten registrert søvnfase, i timercore(Number): Core-søvnens lengde i timerdeep(Number): Dyp søvns lengde i timerrem(Number): REM-søvnens lengde i timerawake(Number): Tid våken i timersleepStart(Date): Når søvnen faktisk startetsleepEnd(Date): Når søvnen faktisk sluttetinBed(Number): Total tid i sengen i timerinBedStart(Date): Når du gikk til sengsinBedEnd(Date): Når du sto opp
Summer data av
Med Summer data av 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"
}
]
}
Felt:
date,start,startDate(Date): Starttid for søvnsegmentetend,endDate(Date): Sluttid for søvnsegmentetsource(String): Appen eller enheten som registrerte segmentetqty(Number): Segmentets lengde i timervalue(String): Søvntilstand - én av:"Awake""Asleep"(ukategorisert søvnfase)"In Bed""Core""REM""Deep""Unspecified"
Merk: "Asleep" refererer til en ukategorisert søvnfase (ikke total tid i søvn). Dette kan forekomme hvis datakilden ikke støtter sporing av søvnfaser.
Blodsukker
Blodsukkermålinger inkluderer informasjon 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"
}
]
}
Felt:
qty(Number): BlodsukkernivåmealTime(String): Én av:"Before Meal""After Meal""Unspecified"
Ernæring
Når Summer data er av, kan individuelle ernæringsmengdeprøver (for eksempel Dietary Energy eller Carbohydrates) inkludere matdetaljer registrert 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"
}
]
}
Felt:
qty(Number): Næringsmengde for prøvenfoodType(String, valgfritt): Matnavn registrert av kildeappen, når det finnes
Med Summer data på inkluderer ernæringstotaler ikke foodType.
Seksuell aktivitet
Oppføringer for seksuell aktivitet sporer bruk av 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"
}
]
}
Felt:
Unspecified(Number): Antall hendelser den dagen når beskyttelsesstatus er ukjentProtection Used(Number): Antall hendelser den dagen når beskyttelse ble bruktProtection Not Used(Number): Antall hendelser den dagen når beskyttelse ikke ble brukt
Summerte eksporter teller hver kalenderdag. JSON beholder hver dag. I CSV viser en grovere tidsgruppe den siste dagen i den gruppen.
Håndvask
Håndvaskhendelser sporer fullføringsstatus:
{
"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"
}
]
}
Felt:
qty(Number): Lengde i sekunder. Summerte eksporter bruker gjennomsnittlig lengde i tidsgruppen.value(String):"Completed"når økten varer mer enn 20 sekunder, ellers"Incomplete"
Tannpuss
Tannpusshendelser sporer fullføringsstatus:
{
"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"
}
]
}
Felt:
qty(Number): Lengde i sekunder. Summerte eksporter bruker gjennomsnittlig lengde i tidsgruppen.value(String):"Completed"når økten varer minst 2 minutter, ellers"Incomplete"
Insulinlevering
Oppføringer for insulinlevering inkluderer årsaken til leveringen:
{
"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"
}
]
}
Felt:
qty(Number): Mengde levert insulin. Summerte eksporter summerer mengdene i tidsgruppen.reason(String): Én av:"Bolus"(måltidsinsulin)"Basal"(basisinsulin)