Hjelpsenter HealthyApps
Norsk Bokmål
Hjelpsenter
Hovednettsted ↗

Søk i hjelpeemner

Helsemål - JSON-eksportformat

Dokumentasjon for strukturen for helsemål i JSON-eksporter

Sist oppdatert: 31. oktober 2026

På denne siden
Format for målnavn
Struktur Struktur Felles felt
Spesielle målformater Spesielle målformater BlodtrykkHjertefrekvensHjertefrekvensvariabilitetSøvnanalyseBlodsukkerErnæringSeksuell aktivitetHåndvaskTannpussInsulinlevering
Relatert dokumentasjon

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): Mengdeverdi
    • date (Date): Tidsstempel i formatet yyyy-MM-dd HH:mm:ss Z
    • source (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åleperioden
  • Avg (Number): Gjennomsnittlig hjertefrekvens i måleperioden
  • Max (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 timer
  • asleep (Number): Tid i søvn uten registrert søvnfase, i timer
  • core (Number): Core-søvnens lengde i timer
  • deep (Number): Dyp søvns lengde i timer
  • rem (Number): REM-søvnens lengde i timer
  • awake (Number): Tid våken 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 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øvnsegmentet
  • end, endDate (Date): Sluttid for søvnsegmentet
  • source (String): Appen eller enheten som registrerte segmentet
  • qty (Number): Segmentets lengde i timer
  • value (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øven
  • foodType (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 ukjent
  • Protection Used (Number): Antall hendelser den dagen når beskyttelse ble brukt
  • Protection 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)

Relatert dokumentasjon