Súgóközpont HealthyApps
Magyar
Súgóközpont
Fő webhely ↗

Súgótémák keresése

Egészségügyi metrikák - JSON exportformátum

Dokumentáció az egészségügyi metrikák szerkezetéről JSON-exportokban

Utoljára frissítve: 2026. október 31.

Ezen az oldalon
Metrikanév formátum
Szerkezet Szerkezet Közös mezők
Speciális metrikaformátumok Speciális metrikaformátumok VérnyomásPulzusSzívritmus-variabilitásAlváselemzésVércukorTáplálkozásSzexuális aktivitásKézmosásFogmosásInzulinadagolás
Kapcsolódó dokumentáció

A JSON-exportok az egészségügyi metrikákat a metrics tömbben tárolják.

Metrikanév formátum

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

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

Szerkezet

A metrics tömb objektumokat tartalmaz, amelyek mindegyike egy adott egészségügyi metrikátípust képvisel. A legtöbb egészségügyi metrika közös szerkezetet követ:

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

Közös mezők

  • name (String): Az egészségügyi metrika neve snake_case formátumban (pl. "step_count", "heart_rate", "active_energy")
  • units (String): A mértékegység (pl. "count", "count/min", "kcal")
  • data (Array): Adatpontok tömbje, amelyek mindegyike tartalmazza:
    • qty (Number): A mennyiségérték
    • date (Date): Időbélyeg yyyy-MM-dd HH:mm:ss Z formátumban
    • source (String, ha elérhető): A mintát rögzítő alkalmazás vagy eszköz

Speciális metrikaformátumok

Egyes egészségügyi metrikáknak egyedi szerkezetük van, amely eltér a közös formátumtól:

Vérnyomás

A vérnyomás-leolvasások szisztolés és diasztolés értékeket is tartalmaznak:

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

Mezők:

  • systolic (Number): A szisztolés (felső) vérnyomás-leolvasás. Az összegzett exportok az időcsoport leolvasásainak átlagát használják.
  • diastolic (Number): A diasztolés (alsó) vérnyomás-leolvasás. Az összegzett exportok az időcsoport leolvasásainak átlagát használják.

Pulzus

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

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

Mezők:

  • Min (Number): Minimális pulzus a mérési időszak alatt
  • Avg (Number): Átlagos pulzus a mérési időszak alatt
  • Max (Number): Maximális pulzus a mérési időszak alatt

Szívritmus-variabilitás

Ha az Adatok összegzése ki van kapcsolva, a Szívritmus-variabilitás (SDNN) JSON-exportjai tartalmazhatnak elérhető ütésről ütésre leolvasásokat. Ezekhez Szívverés-sorozat olvasási hozzáférés szükséges az Apple Healthben.

Az összegzett exportok, a CSV-exportok és a Recovery HRV nem tartalmaznak ütésről ütésre leolvasásokat.

Alváselemzés

Az alvásadatok szerkezete attól függ, hogy az Adatok összegzése be vagy ki van kapcsolva.

Adatok összegzése bekapcsolva

Ha az Adatok összegzése be van kapcsolva, az alvásadatok naponta összegződnek. Az azonos fázisú időtartamok összeadódnak. A teljes alvás az asleep, core, deep és REM összege. A JSON minden napot megtart. CSV-ben a durvább időcsoport a csoport legutóbbi napját mutatja:

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

Mezők:

  • totalSleep (Number): Teljes alvásidő órákban
  • asleep (Number): Alvás rögzített alvásfázis nélkül, órákban
  • core (Number): Core alvás időtartama órákban
  • deep (Number): Mélyalvás időtartama órákban
  • rem (Number): REM alvás időtartama órákban
  • awake (Number): Ébren töltött idő órákban
  • sleepStart (Date): Amikor az alvás ténylegesen elkezdődött
  • sleepEnd (Date): Amikor az alvás ténylegesen véget ért
  • inBed (Number): Összes ágyban töltött idő órákban
  • inBedStart (Date): Amikor lefeküdt
  • inBedEnd (Date): Amikor felkelt

Adatok összegzése kikapcsolva

Ha az Adatok összegzése ki van kapcsolva, az egyedi alvásszegmensek szerepelnek:

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

Mezők:

  • date, start, startDate (Date): Az alvásszegmens kezdőideje
  • end, endDate (Date): Az alvásszegmens záróideje
  • source (String): A szegmenst rögzítő alkalmazás vagy eszköz
  • qty (Number): A szegmens időtartama órákban
  • value (String): Alvásállapot — az alábbiak egyike:
    • "Awake"
    • "Asleep" (kategorizálatlan alvásfázis)
    • "In Bed"
    • "Core"
    • "REM"
    • "Deep"
    • "Unspecified"

Megjegyzés: Az "Asleep" kategorizálatlan alvásfázist jelent (nem a teljes alvásidőt). Ez előfordulhat, ha az adatforrás nem támogatja az alvásfázis-követést.

Vércukor

A vércukor-leolvasások étkezési időzítési információt tartalmaznak:

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

Mezők:

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

Táplálkozás

Ha az Adatok összegzése ki van kapcsolva, az egyedi táplálkozási mennyiségminták (például Dietary Energy vagy Carbohydrates) tartalmazhatják az Apple Healthben rögzített ételadatokat. Például:

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

Mezők:

  • qty (Number): Tápanyagmennyiség a mintához
  • foodType (String, opcionális): A forrásalkalmazás által rögzített ételnév, ha elérhető

Ha az Adatok összegzése be van kapcsolva, a táplálkozási összegek nem tartalmazzák a foodType mezőt.

Szexuális aktivitás

A szexuális aktivitás bejegyzések a védelem használatát követik:

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

Mezők:

  • Unspecified (Number): Azon események száma aznap, amikor a védelem állapota ismeretlen
  • Protection Used (Number): Azon események száma aznap, amikor védelmet használtak
  • Protection Not Used (Number): Azon események száma aznap, amikor nem használtak védelmet

Az összegzett exportok minden naptári napot számolnak. A JSON minden napot megtart. CSV-ben a durvább időcsoport a csoport legutóbbi napját mutatja.

Kézmosás

A kézmosási események a befejezési állapotot követik:

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

Mezők:

  • qty (Number): Időtartam másodpercben. Az összegzett exportok az időcsoport átlagos időtartamát használják.
  • value (String): "Completed", ha a munkamenet 20 másodpercnél hosszabb, egyébként "Incomplete"

Fogmosás

A fogmosási események a befejezési állapotot követik:

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

Mezők:

  • qty (Number): Időtartam másodpercben. Az összegzett exportok az időcsoport átlagos időtartamát használják.
  • value (String): "Completed", ha a munkamenet legalább 2 perc, egyébként "Incomplete"

Inzulinadagolás

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

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

Mezők:

  • qty (Number): Az adagolt inzulin mennyisége. Az összegzett exportok az időcsoport mennyiségeit összeadják.
  • reason (String): Az alábbiak egyike:
    • "Bolus" (étkezési inzulin)
    • "Basal" (háttér-inzulin)

Kapcsolódó dokumentáció