Zdravotní metriky

Zdravotní metriky shrnují různá měření a údaje z aplikace Zdraví a připojených zařízení. Ve výstupu JSON jsou v poli metrics.

Formát názvu metriky

Všechny názvy metrik v JSON používají formát snake_case (malá písmena a podtržítka). Například:

• „Počet kroků“ → "step_count"
• „Krevní tlak“ → "blood_pressure"
• „Tepová frekvence“ → "heart_rate"
• „Vzdálenost chůze a běhu“ → "walking_running_distance"

Struktura

Pole metrics obsahuje objekty; každý odpovídá jednomu typu metriky. Většina metrik má společnou strukturu:

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

Společná pole

• name (String): Interní název metriky ve snake_case (např. "step_count", "heart_rate", "active_energy")
• units (String): Měrná jednotka (např. "count", "bpm", "kcal")
• data (Array): Pole měření, každý záznam obsahuje:
  • qty (Number): Hodnota veličiny
  • date (Date): Časové razítko ve formátu yyyy-MM-dd HH:mm:ss Z

Zvláštní formáty metrik

Některé metriky mají vlastní strukturu, která se liší od obecného vzoru:

Krevní tlak

Záznamy krevního tlaku obsahují systolický i diastolický údaj:

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

Pole:

• systolic (Number): Systolický (horní) tlak
• diastolic (Number): Diastolický (dolní) tlak

Tepová frekvence

Data tepu obsahují minimum, průměr a maximum:

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

Pole:

• Min (Number): Nejmenší tep v daném období měření
• Avg (Number): Průměrný tep v daném období měření
• Max (Number): Nejvyšší tep v daném období měření

Analýza spánku

Struktura dat závisí na tom, zda máte v nastavení exportu zapnutou agregaci dat.

Agregovaná data spánku

Při zapnuté agregaci jsou údaje o spánku shrnuté po dnech:

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

Pole:

• totalSleep (Number): Celkový čas spánku v hodinách
• asleep (Number): Celkový čas v jakémkoli spánkovém stavu
• core (Number): Délka core spánku v hodinách
• deep (Number): Délka hlubokého spánku v hodinách
• rem (Number): Délka REM spánku v hodinách
• sleepStart (Date): Skutečný začátek spánku
• sleepEnd (Date): Skutečný konec spánku
• inBed (Number): Celkový čas v posteli v hodinách
• inBedStart (Date): Kdy jste šli do postele
• inBedEnd (Date): Kdy jste vstali z postele

Neagregovaná data spánku

Bez agregace se exportují 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"
    }
  ]
}

Pole:

• startDate (Date): Začátek segmentu spánku
• endDate (Date): Konec segmentu spánku
• qty (Number): Délka segmentu v hodinách
• value (String): Spánkový stav – jedna z hodnot:
  • "Awake"
  • "Asleep" (nezařazená fáze spánku)
  • "In Bed"
  • "Core"
  • "REM"
  • "Deep"
  • "Unspecified"

Poznámka: "Asleep" znamená nezařazenou fázi spánku (ne souhrnný čas spánku). Může se objevit, pokud zdroj dat nepodporuje rozlišení fází.

Hladina krevního cukru

Záznamy glykémie mohou obsahovat informaci o časování jídla:

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

Pole:

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

Sexuální aktivita

Záznamy sledují použití ochrany:

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

Pole:

• Unspecified (Number): Počet, kdy není stav ochrany znám
• Protection Used (Number): Počet při použité ochraně
• Protection Not Used (Number): Počet bez použité ochrany

Mytí rukou

Události mytí rukou sledují, zda bylo mytí dokončeno:

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

Pole:

• qty (Number): Počet událostí mytí rukou
• value (String): Jedna z hodnot:
  • "Complete"
  • "Incomplete"

Čištění zubů

Události čištění zubů sledují dokončení:

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

Pole:

• qty (Number): Počet událostí čištění zubů
• value (String): Jedna z hodnot:
  • "Complete"
  • "Incomplete"

Podání inzulinu

Záznamy obsahují důvod podání:

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

Pole:

• qty (Number): Množství podaného inzulinu
• reason (String): Jedna z hodnot:
  • "Bolus" (inzulin k jídlu)
  • "Basal" (bazální inzulin)

Časté zdravotní metriky

Mezi často exportované metriky patří (názvy v snake_case):

• step_count – denní počty kroků
• walking_running_distance – uražená vzdálenost
• active_energy – aktivně spálené kalorie
• resting_heart_rate – klidová tepová frekvence
• heart_rate – měření tepu
• respiratory_rate – dechová frekvence
• body_temperature – tělesná teplota
• blood_oxygen_saturation – hladina SpO2
• weight_&_body_mass – tělesná hmotnost
• body_mass_index – BMI
• height – výška
• dietary_water – příjem tekutin
• mindful_minutes – čas mindfulness / meditace

Tipy

• Časové seskupení: v konfiguraci exportu nastavte agregaci podle sekundy, minuty, hodiny, dne atd.
• Agregace dat: zapněte ji pro denní souhrn spánku a dalších metrik
• Výběrový export: omezte počet metrik, abyste zmenšili soubor a zkrátili zpracování

Související dokumentace

• Přehled formátu exportu JSON
• Průvodce ručním exportem
• Přehled automatizací