Egészségügyi metrikák

Az egészségügyi metrikák az Apple Health alkalmazás és a csatlakoztatott eszközök által gyűjtött mérések és adatpontok. JSON exportokban az egészségügyi metrikák a metrics tömbben tárolódnak.

Metrikanév formátum

Minden metrikanév JSON exportokban snake_case formátumot használ (kisbetű és aláhúzás). Például:

• a „Step Count” → "step_count"
• a „Blood Pressure” → "blood_pressure"
• a „Heart Rate” → "heart_rate"
• a „Walking + Running Distance” → "walking_running_distance"

Szerkezet

A metrics tömb objektumokat tartalmaz, mindegyik egy konkrét egészségügyi metrikatípust reprezentál. A legtöbb metrika közös szerkezetet követ:

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

Közös mezők

• name (String): A metrika neve snake_case formátumban (pl. "step_count", "heart_rate", "active_energy")
• units (String): Mértékegység (pl. "count", "bpm", "kcal")
• data (Array): Adatpontok tömbje, mindegyik tartalmazza:
  • qty (Number): Mennyiségi érték
  • date (Date): Időbélyeg yyyy-MM-dd HH:mm:ss Z formátumban

Speciális metrikaformátumok

Egyes egészségügyi metrikák egyedi szerkezetet használnak:

Vérnyomás

A vérnyomás mérések szisztolés és diasztolés értéket is tartalmaznak:

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

Mezők:

• systolic (Number): Szisztolés (felső) vérnyomás
• diastolic (Number): Diasztolés (alsó) vérnyomás

Pulzus

A pulzusadatok minimum, átlag és maximum értékeket tartalmaznak:

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

Mezők:

• Min (Number): Minimum pulzus a mérési időszak alatt
• Avg (Number): Átlagos pulzus a mérési időszak alatt
• Max (Number): Maximum pulzus a mérési időszak alatt

Alváselemzés

Az alvásadatok szerkezete attól függ, hogy az exportbeállításokban be van-e kapcsolva az adatösszesítés.

Összesített alvásadat

Összesítés bekapcsolásakor az alvásadatok napi összefoglalóként jelennek meg:

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

Mezők:

• totalSleep (Number): Összes alvásidő órában
• asleep (Number): Összes idő bármilyen alvásállapotban
• core (Number): Core alvás időtartama órában
• deep (Number): Mélyalvás időtartama órában
• rem (Number): REM alvás időtartama órában
• sleepStart (Date): Mikor kezdődött ténylegesen az alvás
• sleepEnd (Date): Mikor ért véget az alvás
• inBed (Number): Összes ágyban töltött idő órában
• inBedStart (Date): Mikor feküdtél le
• inBedEnd (Date): Mikor keltél fel

Nem összesített alvásadat

Ha az összesítés ki van kapcsolva, egyedi alvásszegmensek kerülnek bele:

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

Mezők:

• startDate (Date): Az alvásszegmens kezdete
• endDate (Date): Az alvásszegmens vége
• qty (Number): A szegmens időtartama órában
• value (String): Alvásállapot – az alábbiak egyike:
  • "Awake"
  • "Asleep" (kategorizálatlan alvási fázis)
  • "In Bed"
  • "Core"
  • "REM"
  • "Deep"
  • "Unspecified"

Megjegyzés: Az "Asleep" kategorizálatlan alvási fázist jelent (nem az összes alvásidőt). Ez akkor fordulhat elő, ha az adatforrás nem támogatja az alvási fázis követését.

Vércukor

A vércukor mérések étkezés időzítését is tartalmazzák:

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

Mezők:

• qty (Number): Vércukorszint
• mealTime (String): Az alábbiak egyike:
  • "Before Meal"
  • "After Meal"
  • "Unspecified"

Szexuális aktivitás

A szexuális aktivitás bejegyzések a védelemhasználatot követik:

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

Mezők:

• Unspecified (Number): Darabszám, ha a védelem állapota ismeretlen
• Protection Used (Number): Darabszám védelem használatakor
• Protection Not Used (Number): Darabszám védelem nélkül

Kézmosás

A kézmosás események a befejezettséget követik:

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

Mezők:

• qty (Number): Kézmosás események száma
• value (String): Az alábbiak egyike:
  • "Complete"
  • "Incomplete"

Fogmosás

A fogmosás események a befejezettséget követik:

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

Mezők:

• qty (Number): Fogmosás események száma
• value (String): Az alábbiak egyike:
  • "Complete"
  • "Incomplete"

Inzulin adagolás

Az inzulin adagolás bejegyzések az adagolás okát is tartalmazzák:

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

Mezők:

• qty (Number): Adagolt inzulin mennyiség
• reason (String): Az alábbiak egyike:
  • "Bolus" (étkezéshez kapcsolódó inzulin)
  • "Basal" (háttérinzulin)

Gyakori egészségügyi metrikák

Néhány gyakran exportált metrika (minden név snake_case formátumban):

• step_count – Napi lépésszám
• walking_running_distance – Megtett távolság
• active_energy – Aktivitással elégetett kalória
• resting_heart_rate – Nyugalmi pulzus
• heart_rate – Pulzusmérések
• respiratory_rate – Légzésszám
• body_temperature – Testhőmérséklet mérések
• blood_oxygen_saturation – SpO2 szintek
• weight_&_body_mass – Testsúly mérések
• body_mass_index – Számított BMI értékek
• height – Magasság mérések
• dietary_water – Folyadékbevitel
• mindful_minutes – Meditáció vagy tudatos jelenlét ideje

Tippek

• Időcsoportosítás: Az export konfigurációjában állítsd be az időcsoportosítást (másodperc, perc, óra, nap stb.) az adatok összesítésének szabályozásához
• Adatösszesítés: Kapcsold be az összesítést az alvás és más metrikák napi összefoglalójához az egyszerűbb elemzéshez
• Szelektív export: Válaszd ki, mely konkrét metrikák kerüljenek az exportba a fájlméret és feldolgozási idő csökkentéséhez

Kapcsolódó dokumentáció

• JSON exportformátum áttekintés
• Kézi export útmutató
• Automatizálások áttekintése