Zdravotné metriky

Predstavujú merania a údaje z Apple Health a pripojených zariadení. V JSON exportoch sú v poli metrics.

Formát názvov metrík

Názvy metrík v JSON používajú formát snake_case (malé písmená a podčiarkovníky). Napríklad:

• „Step Count“ sa v JSON stane "step_count"
• „Blood Pressure“ sa stane "blood_pressure"
• „Heart Rate“ sa stane "heart_rate"
• „Walking + Running Distance“ sa stane "walking_running_distance"

Štruktúra

Pole metrics obsahuje objekty pre jednotlivé typy metrík. Väčšina metrík má spoločnú štruktúru:

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

Spoločné polia

• name (String): Názov zdravotnej metriky vo formáte snake_case (napr. „step_count“, „heart_rate“, „active_energy“)
• units (String): Jednotka merania (napr. „count“, „bpm“, „kcal“)
• data (Array): Pole dátových bodov, každý obsahuje:
  • qty (Number): Hodnota množstva
  • date (Date): Časová značka vo formáte yyyy-MM-dd HH:mm:ss Z

Špeciálne formáty metrík

Niektoré zdravotné metriky majú jedinečnú štruktúru, ktorá sa líši od bežného formátu:

Krvný tlak

Merania krvného tlaku zahŕňajú systolickú aj diastolickú hodnotu:

{
  "name": "blood_pressure",
  "units": "mmHg",
  "data": [
    {
      "date": "2024-02-06 14:30:00 -0800",
      "systolic": 120,
      "diastolic": 80
    }
  ]
}

Polia:

• systolic (Number): Systolické (horné) meranie krvného tlaku
• diastolic (Number): Diastolické (dolné) meranie krvného tlaku

Srdcová frekvencia

Údaje o srdcovej frekvencii zahŕňajú minimálnu, priemernú a maximálnu hodnotu:

{
  "name": "heart_rate",
  "units": "bpm",
  "data": [
    {
      "date": "2024-02-06 14:30:00 -0800",
      "Min": 65,
      "Avg": 72,
      "Max": 85
    }
  ]
}

Polia:

• Min (Number): Minimálna srdcová frekvencia počas merania
• Avg (Number): Priemerná srdcová frekvencia počas merania
• Max (Number): Maximálna srdcová frekvencia počas merania

Analýza spánku

Štruktúra údajov o spánku závisí od toho, či je v nastaveniach exportu zapnutá agregácia dát.

Agregované údaje o spánku

Keď je agregácia zapnutá, údaje o spánku sa zhrnú podľa dňa:

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

Polia:

• totalSleep (Number): Celkový čas spánku v hodinách
• asleep (Number): Celkový čas v akomkoľvek spánkovom stave
• core (Number): Trvanie spánku „core“ v hodinách
• deep (Number): Trvanie hlbokého spánku v hodinách
• rem (Number): Trvanie REM spánku v hodinách
• sleepStart (Date): Skutočný začiatok spánku
• sleepEnd (Date): Skutočný koniec spánku
• inBed (Number): Celkový čas v posteli v hodinách
• inBedStart (Date): Kedy ste išli do postele
• inBedEnd (Date): Kedy ste vstali z postele

Neagregované údaje o spánku

Keď je agregácia vypnutá, zahrnú sa jednotlivé segmenty spánku:

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

Polia:

• startDate (Date): Začiatok segmentu spánku
• endDate (Date): Koniec segmentu spánku
• qty (Number): Trvanie segmentu v hodinách
• value (String): Spánkový stav – jedna z hodnôt:
  • "Awake"
  • "Asleep" (nekategorizovaná fáza spánku)
  • "In Bed"
  • "Core"
  • "REM"
  • "Deep"
  • "Unspecified"

Poznámka: "Asleep" označuje nekategorizovanú fázu spánku (nie celkový čas spánku). Môže sa vyskytnúť, ak zdroj dát nepodporuje sledovanie fáz spánku.

Hladina glukózy v krvi

Merania glukózy zahŕňajú informáciu o čase jedla:

{
  "name": "blood_glucose",
  "units": "mg/dL",
  "data": [
    {
      "date": "2024-02-06 08:00:00 -0800",
      "qty": 95,
      "mealTime": "Before Meal"
    }
  ]
}

Polia:

• qty (Number): Hladina glukózy v krvi
• mealTime (String): Jedna z hodnôt:
  • "Before Meal"
  • "After Meal"
  • "Unspecified"

Sexuálna aktivita

Záznamy sexuálnej aktivity sledujú použitie ochrany:

{
  "name": "sexual_activity",
  "units": "count",
  "data": [
    {
      "date": "2024-02-06 20:00:00 -0800",
      "Unspecified": 0,
      "Protection Used": 1,
      "Protection Not Used": 0
    }
  ]
}

Polia:

• Unspecified (Number): Počet, keď je stav ochrany neznámy
• Protection Used (Number): Počet pri použití ochrany
• Protection Not Used (Number): Počet bez použitia ochrany

Umývanie rúk

Udalosti umývania rúk sledujú stav dokončenia:

{
  "name": "handwashing",
  "units": "count",
  "data": [
    {
      "date": "2024-02-06 12:00:00 -0800",
      "qty": 1,
      "value": "Complete"
    }
  ]
}

Polia:

• qty (Number): Počet udalostí umývania rúk
• value (String): Jedna z hodnôt:
  • "Complete"
  • "Incomplete"

Čistenie zubov

Udalosti čistenia zubov sledujú stav dokončenia:

{
  "name": "toothbrushing",
  "units": "count",
  "data": [
    {
      "date": "2024-02-06 08:00:00 -0800",
      "qty": 1,
      "value": "Complete"
    }
  ]
}

Polia:

• qty (Number): Počet udalostí čistenia zubov
• value (String): Jedna z hodnôt:
  • "Complete"
  • "Incomplete"

Podávanie inzulínu

Záznamy podávania inzulínu zahŕňajú dôvod podania:

{
  "name": "insulin_delivery",
  "units": "IU",
  "data": [
    {
      "date": "2024-02-06 08:00:00 -0800",
      "qty": 5,
      "reason": "Bolus"
    }
  ]
}

Polia:

• qty (Number): Množstvo podaného inzulínu
• reason (String): Jedna z hodnôt:
  • "Bolus" (inzulín pri jedle)
  • "Basal" (bazálny inzulín)

Bežné zdravotné metriky

Medzi často exportované zdravotné metriky patria (všetky názvy sú vo formáte snake_case):

• step_count – denný počet krokov
• walking_running_distance – prejdená vzdialenosť
• active_energy – kalórie spálené aktivitou
• resting_heart_rate – srdcová frekvencia v pokoji
• heart_rate – merania srdcovej frekvencie
• respiratory_rate – frekvencia dýchania
• body_temperature – merania telesnej teploty
• blood_oxygen_saturation – hladiny SpO₂
• weight_&_body_mass – merania telesnej hmotnosti
• body_mass_index – vypočítané hodnoty BMI
• height – merania výšky
• dietary_water – príjem tekutín
• mindful_minutes – čas meditácie alebo všímavosti

Tipy

• Časové zoskupenie: V nastaveniach exportu použite zoskupenie podľa času na ovládanie agregácie (sekunda, minúta, hodina, deň atď.)
• Agregácia dát: Zapnite agregáciu na zhrnutie spánku a ďalších metrík podľa dňa pre jednoduchšiu analýzu
• Selektívny export: Môžete vybrať konkrétne zdravotné metriky na zníženie veľkosti súboru a času spracovania

Súvisiaca dokumentácia

• Prehľad formátu exportu JSON
• Príručka manuálneho exportu
• Prehľad automatizácií