Zdravstvene metrike - format izvoza JSON

JSON izvozi pohranjuju zdravstvene metrike u polje metrics.

Format naziva metrike

Svi nazivi metrika u JSON izvozima koriste format snake_case (mala slova s podvlakama). Na primjer:

• "Step Count" postaje "step_count"
• "Blood Pressure" postaje "blood_pressure"
• "Heart Rate" postaje "heart_rate"
• "Walking + Running Distance" postaje "walking_running_distance"

Struktura

Polje metrics sadrži objekte, od kojih svaki predstavlja određeni tip zdravstvene metrike. Većina zdravstvenih metrika slijedi zajedničku strukturu:

{
  "name": "step_count",
  "units": "count",
  "data": [
    {
      "qty": 8500,
      "date": "2024-02-06 14:30:00 -0800",
      "source": "Apple Watch"
    }
  ]
}

Zajednička polja

• name (String): Naziv zdravstvene metrike u formatu snake_case (npr. "step_count", "heart_rate", "active_energy")
• units (String): Jedinica mjere (npr. "count", "count/min", "kcal")
• data (Array): Polje podatkovnih točaka, od kojih svaka sadrži:
  • qty (Number): Vrijednost količine
  • date (Date): Vremenska oznaka u formatu yyyy-MM-dd HH:mm:ss Z
  • source (String, kada je dostupno): Aplikacija ili uređaj koji je zabilježio uzorak

Posebni formati metrika

Neke zdravstvene metrike imaju jedinstvene strukture koje se razlikuju od zajedničkog formata:

Krvni tlak

Očitanja krvnog tlaka uključuju i sistoličke i dijastoličke vrijednosti:

{
  "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"
    }
  ]
}

Polja:

• systolic (Number): Sistoličko (gornje) očitanje krvnog tlaka. Sažeti izvozi koriste prosjek očitanja u vremenskoj grupi.
• diastolic (Number): Dijastoličko (donje) očitanje krvnog tlaka. Sažeti izvozi koriste prosjek očitanja u vremenskoj grupi.

Frekvencija otkucaja srca

Podaci frekvencije otkucaja srca uključuju minimalne, prosječne i maksimalne vrijednosti:

{
  "name": "heart_rate",
  "units": "count/min",
  "data": [
    {
      "date": "2024-02-06 14:30:00 -0800",
      "Min": 65,
      "Avg": 72,
      "Max": 85,
      "source": "Apple Watch"
    }
  ]
}

Polja:

• Min (Number): Minimalna frekvencija otkucaja srca tijekom razdoblja mjerenja
• Avg (Number): Prosječna frekvencija otkucaja srca tijekom razdoblja mjerenja
• Max (Number): Maksimalna frekvencija otkucaja srca tijekom razdoblja mjerenja

Varijabilnost frekvencije otkucaja srca

S isključenim Sažmi podatke JSON izvozi Varijabilnosti frekvencije otkucaja srca (SDNN) mogu uključivati dostupna beat-to-beat očitanja. Ona zahtijevaju pristup čitanju Serija otkucaja srca u Apple Healthu.

Sažeti izvozi, CSV izvozi i Recovery HRV ne uključuju beat-to-beat očitanja.

Analiza sna

Struktura podataka sna ovisi o tome je li Sažmi podatke uključeno ili isključeno.

Sažmi podatke uključeno

S uključenim Sažmi podatke podaci sna sažimaju se po danu. Trajanja u istoj fazi zbrajaju se. Ukupni san je zbroj asleep, core, deep i REM. JSON zadržava svaki dan. U CSV-u grublja vremenska grupa prikazuje najnoviji dan u toj grupi:

{
  "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"
    }
  ]
}

Polja:

• totalSleep (Number): Ukupno vrijeme sna u satima
• asleep (Number): Vrijeme sna bez zabilježene faze sna, u satima
• core (Number): Trajanje core sna u satima
• deep (Number): Trajanje dubokog sna u satima
• rem (Number): Trajanje REM sna u satima
• awake (Number): Vrijeme budnosti u satima
• sleepStart (Date): Kada je san stvarno počeo
• sleepEnd (Date): Kada je san stvarno završio
• inBed (Number): Ukupno vrijeme u krevetu u satima
• inBedStart (Date): Kada ste legli u krevet
• inBedEnd (Date): Kada ste ustali iz kreveta

Sažmi podatke isključeno

S isključenim Sažmi podatke uključeni su pojedinačni segmenti sna:

{
  "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"
    }
  ]
}

Polja:

• date, start, startDate (Date): Vrijeme početka segmenta sna
• end, endDate (Date): Vrijeme kraja segmenta sna
• source (String): Aplikacija ili uređaj koji je zabilježio segment
• qty (Number): Trajanje segmenta u satima
• value (String): Stanje sna — jedno od:
  • "Awake"
  • "Asleep" (nekategorizirana faza sna)
  • "In Bed"
  • "Core"
  • "REM"
  • "Deep"
  • "Unspecified"

Napomena: "Asleep" označava nekategoriziranu fazu sna (a ne ukupno vrijeme sna). To se može dogoditi ako izvor podataka ne podržava praćenje faza sna.

Glukoza u krvi

Očitanja glukoze u krvi uključuju informacije o vremenu obroka:

{
  "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"
    }
  ]
}

Polja:

• qty (Number): Razina glukoze u krvi
• mealTime (String): Jedno od:
  • "Before Meal"
  • "After Meal"
  • "Unspecified"

Prehrana

S isključenim Sažmi podatke pojedinačni uzorci količine prehrane (na primjer Dietary Energy ili Carbohydrates) mogu uključivati detalje hrane zabilježene u Apple Healthu. Na primjer:

{
  "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"
    }
  ]
}

Polja:

• qty (Number): Količina hranjive tvari za uzorak
• foodType (String, opcionalno): Naziv hrane koji je zabilježila izvorna aplikacija, kada je dostupno

S uključenim Sažmi podatke ukupni zbrojevi prehrane ne uključuju foodType.

Spolna aktivnost

Unosi spolne aktivnosti prate uporabu zaštite:

{
  "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"
    }
  ]
}

Polja:

• Unspecified (Number): Broj događaja tog dana kada je status zaštite nepoznat
• Protection Used (Number): Broj događaja tog dana kada je zaštita korištena
• Protection Not Used (Number): Broj događaja tog dana kada zaštita nije korištena

Sažeti izvozi broje svaki kalendarski dan. JSON zadržava svaki dan. U CSV-u grublja vremenska grupa prikazuje najnoviji dan u toj grupi.

Pranje ruku

Događaji pranja ruku prate status dovršetka:

{
  "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"
    }
  ]
}

Polja:

• qty (Number): Trajanje u sekundama. Sažeti izvozi koriste prosječno trajanje u vremenskoj grupi.
• value (String): "Completed" kada sesija traje više od 20 sekundi, inače "Incomplete"

Četkanje zubi

Događaji četkanja zubi prate status dovršetka:

{
  "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"
    }
  ]
}

Polja:

• qty (Number): Trajanje u sekundama. Sažeti izvozi koriste prosječno trajanje u vremenskoj grupi.
• value (String): "Completed" kada sesija traje najmanje 2 minute, inače "Incomplete"

Primjena inzulina

Unosi primjene inzulina uključuju razlog primjene:

{
  "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"
    }
  ]
}

Polja:

• qty (Number): Količina primijenjenog inzulina. Sažeti izvozi zbrajaju količine u vremenskoj grupi.
• reason (String): Jedno od:
  • "Bolus" (inzulin uz obrok)
  • "Basal" (bazalni inzulin)

Povezana dokumentacija

• Pregled izvoza JSON
• Podržani podaci
• Preferencije izvora
• Vodič za ručni izvoz
• Pregled automatizacija