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): Mengdeverdien
    • date (Date): Tidsstempel i formatet yyyy-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ålingen
  • diastolic (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åleperioden
  • Avg (Number): Gjennomsnittlig hjertefrekvens i måleperioden
  • Max (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 timer
  • asleep (Number): Total tid i hvilken som helst søvntilstand
  • core (Number): Lett søvn varighet i timer
  • deep (Number): Dyp søvn varighet i timer
  • rem (Number): REM-søvn varighet i timer
  • sleepStart (Date): Når søvnen faktisk startet
  • sleepEnd (Date): Når søvnen faktisk sluttet
  • inBed (Number): Total tid i sengen i timer
  • inBedStart (Date): Når du gikk til sengs
  • inBedEnd (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øvnsegmentet
  • endDate (Date): Sluttid for søvnsegmentet
  • qty (Number): Varighet av segmentet i timer
  • value (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 ukjent
  • Protection Used (Number): Antall når beskyttelse ble brukt
  • Protection 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-hendelser
  • value (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-hendelser
  • value (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øres
  • reason (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

Relatert Dokumentasjon