Helseindikatorer - JSON Eksportformat
Dokumentasjon om helseindikatorstrukturen i JSON-eksporter
Last updated: February 6, 2026
On this page
Helseindikatorer
Helseindikatorer representerer de ulike målingene og datapunktene som samles inn av Apple Health-appen din og tilkoblede enheter. I JSON-eksporter lagres helseindikatorer i arrayet metrics.
Format for Indikatorenavn
Alle indikatorenavn i JSON-eksporter bruker snake_case-format (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
Arrayet metrics inneholder objekter, hvor hvert objekt representerer en spesifikk type helseindikator. De fleste helseindikatorer følger en felles struktur:
{
"name": "step_count",
"units": "count",
"data": [
{
"qty": 8500,
"date": "2024-02-06 14:30:00 -0800"
}
]
}
Felles Felter
name(String): Navnet på helseindikatoren i snake_case-format (f.eks. "step_count", "heart_rate", "active_energy")units(String): Måleenheten (f.eks. "count", "bpm", "kcal")data(Array): Et array av datapunkter, hvor hvert punkt inneholder:qty(Number): Mengdeverdiendate(Date): Tidsstempel i formatetyyyy-MM-dd HH:mm:ss Z
Spesielle Indikatorformater
Noen helseindikatorer har unike strukturer som avviker fra det felles formatet:
Blodtrykk
Blodtrykkmålinger inkluderer både systoliske og diastoliske verdier:
{
"name": "blood_pressure",
"units": "mmHg",
"data": [
{
"date": "2024-02-06 14:30:00 -0800",
"systolic": 120,
"diastolic": 80
}
]
}
Felter:
systolic(Number): Den systoliske (øvre) blodtrykkmålingendiastolic(Number): Den diastoliske (nedre) blodtrykkmålingen
Hjertefrekvens
Hjertefrekvensdata inkluderer minimums-, gjennomsnitts- og maksimumsverdier:
{
"name": "heart_rate",
"units": "bpm",
"data": [
{
"date": "2024-02-06 14:30:00 -0800",
"Min": 65,
"Avg": 72,
"Max": 85
}
]
}
Felter:
Min(Number): Minimum hjertefrekvens i måleperiodenAvg(Number): Gjennomsnittlig hjertefrekvens i måleperiodenMax(Number): Maksimum hjertefrekvens i måleperioden
Søvnanalyse
Søvndatastrukturen varierer avhengig av om dataaggregering er aktivert i eksportinnstillingene dine.
Aggregerte Søvndata
Når aggregering er aktivert, oppsummeres søvndata per dag:
{
"name": "sleep_analysis",
"units": "hr",
"data": [
{
"date": "2024-02-06",
"totalSleep": 7.5,
"asleep": 7.0,
"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"
}
]
}
Felter:
totalSleep(Number): Total søvntid i timerasleep(Number): Total tid i hvilken som helst søvntilstandcore(Number): Lett søvn varighet i timerdeep(Number): Dyp søvn varighet i timerrem(Number): REM-søvn varighet 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 stod opp
Ikke-agregerte Søvndata
Når aggregering er deaktivert, inkluderes individuelle søvnsegmenter:
{
"name": "sleep_analysis",
"units": "hr",
"data": [
{
"startDate": "2024-02-05 23:00:00 -0800",
"endDate": "2024-02-05 23:30:00 -0800",
"qty": 0.5,
"value": "Core",
"deep": 0.0,
"rem": 0.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"
}
]
}
Felter:
startDate(Date): Starttid for søvnsegmentetendDate(Date): Sluttid for søvnsegmentetqty(Number): Varighet av segmentet i timervalue(String): Søvntilstand - en av:"Awake""Asleep"(ukategorisert søvnfase)"In Bed""Core""REM""Deep""Unspecified"
Merk: "Asleep" refererer til en ukategorisert søvnfase (snarere enn total søvntid). Dette kan oppstå hvis datakilden ikke støtter søvnfasesporing.
Blodsukker
Blodsukkermålinger inkluderer informasjon om måltidstiming:
{
"name": "blood_glucose",
"units": "mg/dL",
"data": [
{
"date": "2024-02-06 08:00:00 -0800",
"qty": 95,
"mealTime": "Before Meal"
}
]
}
Felter:
qty(Number): BlodsukkernivåmealTime(String): En av:"Before Meal""After Meal""Unspecified"
Seksuell Aktivitet
Seksuell aktivitet-poster sporer bruk av beskyttelse:
{
"name": "sexual_activity",
"units": "count",
"data": [
{
"date": "2024-02-06 20:00:00 -0800",
"Unspecified": 0,
"Protection Used": 1,
"Protection Not Used": 0
}
]
}
Felter:
Unspecified(Number): Antall når beskyttelsesstatus er ukjentProtection Used(Number): Antall når beskyttelse ble bruktProtection Not Used(Number): Antall når beskyttelse ikke ble brukt
Håndvask
Håndvask-hendelser sporer fullføringsstatus:
{
"name": "handwashing",
"units": "count",
"data": [
{
"date": "2024-02-06 12:00:00 -0800",
"qty": 1,
"value": "Complete"
}
]
}
Felter:
qty(Number): Antall håndvask-hendelservalue(String): En av:"Complete""Incomplete"
Tannpuss
Tannpuss-hendelser sporer fullføringsstatus:
{
"name": "toothbrushing",
"units": "count",
"data": [
{
"date": "2024-02-06 08:00:00 -0800",
"qty": 1,
"value": "Complete"
}
]
}
Felter:
qty(Number): Antall tannpuss-hendelservalue(String): En av:"Complete""Incomplete"
Insulintilførsel
Insulintilførsel-poster inkluderer årsaken til tilførsel:
{
"name": "insulin_delivery",
"units": "IU",
"data": [
{
"date": "2024-02-06 08:00:00 -0800",
"qty": 5,
"reason": "Bolus"
}
]
}
Felter:
qty(Number): Mengde insulin som tilføresreason(String): En av:"Bolus"(måltidsinsulin)"Basal"(bakgrunnsinsulin)
Vanlige Helseindikatorer
Noen vanlig eksporterte helseindikatorer inkluderer (alle indikatorenavn er i snake_case-format):
- step_count - Daglige skrittellinger
- walking_running_distance - Tilbakelagt distanse
- active_energy - Kalorier forbrent gjennom aktivitet
- resting_heart_rate - Hjertefrekvens i hvile
- heart_rate - Hjertefrekvensmålinger
- respiratory_rate - Pustefrekvens
- body_temperature - Kroppstemperaturmålinger
- blood_oxygen_saturation - SpO2-nivåer
- weight_&_body_mass - Kroppsvektmålinger
- body_mass_index - Beregnede BMI-verdier
- height - Høyde målinger
- dietary_water - Væskeinntak
- mindful_minutes - Meditasjon eller mindfulness-tid
Tips
- Tidsgruppering: Bruk tidsgrupperingsinnstillinger i eksportkonfigurasjonen din for å kontrollere hvordan data aggregeres (per sekund, minutt, time, dag, osv.)
- Dataaggregering: Aktiver dataaggregering for å oppsummere søvn og andre indikatorer per dag for enklere analyse
- Selektiv Eksport: Du kan velge hvilke spesifikke helseindikatorer som skal inkluderes i eksporten din for å redusere filstørrelsen og behandlingstiden