Metryki zdrowia — format eksportu JSON
Dokumentacja struktury metryk zdrowia w eksportach JSON
Ostatnia aktualizacja: 31 października 2026
Na tej stronie
Eksporty JSON przechowują metryki zdrowia w tablicy metrics.
Format nazw metryk
Wszystkie nazwy metryk w eksportach JSON używają formatu snake_case (małe litery z podkreśleniami). Na przykład:
- „Step Count” staje się
"step_count" - „Blood Pressure” staje się
"blood_pressure" - „Heart Rate” staje się
"heart_rate" - „Walking + Running Distance” staje się
"walking_running_distance"
Struktura
Tablica metrics zawiera obiekty, z których każdy reprezentuje konkretny typ metryki zdrowia. Większość metryk zdrowia ma wspólną strukturę:
{
"name": "step_count",
"units": "count",
"data": [
{
"qty": 8500,
"date": "2024-02-06 14:30:00 -0800",
"source": "Apple Watch"
}
]
}
Wspólne pola
name(String): Nazwa metryki zdrowia w formacie snake_case (np. „step_count”, „heart_rate”, „active_energy”)units(String): Jednostka miary (np. „count”, „count/min”, „kcal”)data(Array): Tablica punktów danych, z których każdy zawiera:qty(Number): Wartość ilościowadate(Date): Znacznik czasu w formacieyyyy-MM-dd HH:mm:ss Zsource(String, gdy dostępne): Aplikacja lub urządzenie, które zarejestrowało próbkę
Specjalne formaty metryk
Niektóre metryki zdrowia mają unikalne struktury różniące się od wspólnego formatu:
Ciśnienie krwi
Odczyty ciśnienia krwi obejmują wartości skurczowe i rozkurczowe:
{
"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"
}
]
}
Pola:
systolic(Number): Odczyt skurczowego (górnego) ciśnienia krwi. Eksporty podsumowane używają średniej odczytów w grupie czasowej.diastolic(Number): Odczyt rozkurczowego (dolnego) ciśnienia krwi. Eksporty podsumowane używają średniej odczytów w grupie czasowej.
Tętno
Dane tętna obejmują wartości minimalne, średnie i maksymalne:
{
"name": "heart_rate",
"units": "count/min",
"data": [
{
"date": "2024-02-06 14:30:00 -0800",
"Min": 65,
"Avg": 72,
"Max": 85,
"source": "Apple Watch"
}
]
}
Pola:
Min(Number): Minimalne tętno w okresie pomiaruAvg(Number): Średnie tętno w okresie pomiaruMax(Number): Maksymalne tętno w okresie pomiaru
Zmienność rytmu serca
Przy wyłączonym Sumuj dane eksporty JSON zmienności rytmu serca (SDNN) mogą zawierać dostępne odczyty beat-to-beat. Wymagają one dostępu do odczytu Serii uderzeń serca w Apple Health.
Eksporty podsumowane, eksporty CSV oraz Recovery HRV nie zawierają odczytów beat-to-beat.
Analiza snu
Struktura danych snu zależy od tego, czy Sumuj dane jest włączone, czy wyłączone.
Sumuj dane włączone
Przy włączonym Sumuj dane dane snu są podsumowywane według dnia. Czasy w tej samej fazie są dodawane. Całkowity sen to suma asleep, core, deep i REM. JSON zachowuje każdy dzień. W CSV grubsza grupa czasowa pokazuje najpóźniejszy dzień w tej grupie:
{
"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"
}
]
}
Pola:
totalSleep(Number): Całkowity czas snu w godzinachasleep(Number): Czas snu bez zarejestrowanej fazy snu, w godzinachcore(Number): Czas snu core w godzinachdeep(Number): Czas snu głębokiego w godzinachrem(Number): Czas snu REM w godzinachawake(Number): Czas czuwania w godzinachsleepStart(Date): Kiedy sen faktycznie się rozpocząłsleepEnd(Date): Kiedy sen faktycznie się zakończyłinBed(Number): Całkowity czas w łóżku w godzinachinBedStart(Date): Kiedy położyłeś się do łóżkainBedEnd(Date): Kiedy wstałeś z łóżka
Sumuj dane wyłączone
Przy wyłączonym Sumuj dane dołączane są poszczególne segmenty snu:
{
"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"
}
]
}
Pola:
date,start,startDate(Date): Czas rozpoczęcia segmentu snuend,endDate(Date): Czas zakończenia segmentu snusource(String): Aplikacja lub urządzenie, które zarejestrowało segmentqty(Number): Czas trwania segmentu w godzinachvalue(String): Stan snu — jeden z:"Awake""Asleep"(nieskategoryzowana faza snu)"In Bed""Core""REM""Deep""Unspecified"
Uwaga: "Asleep" oznacza nieskategoryzowaną fazę snu (a nie całkowity czas snu). Może wystąpić, jeśli źródło danych nie obsługuje śledzenia faz snu.
Glukoza we krwi
Odczyty glukozy we krwi obejmują informacje o czasie posiłku:
{
"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"
}
]
}
Pola:
qty(Number): Poziom glukozy we krwimealTime(String): Jeden z:"Before Meal""After Meal""Unspecified"
Odżywianie
Gdy Sumuj dane jest wyłączone, poszczególne próbki ilościowe odżywiania (na przykład Energia żywieniowa lub Węglowodany) mogą zawierać szczegóły żywności zapisane w Apple Health. Na przykład:
{
"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"
}
]
}
Pola:
qty(Number): Ilość składnika odżywczego dla próbkifoodType(String, opcjonalne): Nazwa żywności zarejestrowana przez aplikację źródłową, gdy jest dostępna
Przy włączonym Sumuj dane sumy odżywiania nie zawierają foodType.
Aktywność seksualna
Wpisy aktywności seksualnej śledzą użycie ochrony:
{
"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"
}
]
}
Pola:
Unspecified(Number): Liczba zdarzeń tego dnia, gdy status ochrony jest nieznanyProtection Used(Number): Liczba zdarzeń tego dnia, gdy użyto ochronyProtection Not Used(Number): Liczba zdarzeń tego dnia, gdy nie użyto ochrony
Eksporty podsumowane zliczają każdy dzień kalendarzowy. JSON zachowuje każdy dzień. W CSV grubsza grupa czasowa pokazuje najpóźniejszy dzień w tej grupie.
Mycie rąk
Zdarzenia mycia rąk śledzą status ukończenia:
{
"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"
}
]
}
Pola:
qty(Number): Czas trwania w sekundach. Eksporty podsumowane używają średniego czasu trwania w grupie czasowej.value(String):"Completed", gdy sesja trwa dłużej niż 20 sekund, w przeciwnym razie"Incomplete"
Szczotkowanie zębów
Zdarzenia szczotkowania zębów śledzą status ukończenia:
{
"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"
}
]
}
Pola:
qty(Number): Czas trwania w sekundach. Eksporty podsumowane używają średniego czasu trwania w grupie czasowej.value(String):"Completed", gdy sesja trwa co najmniej 2 minuty, w przeciwnym razie"Incomplete"
Podawanie insuliny
Wpisy podawania insuliny obejmują powód podania:
{
"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"
}
]
}
Pola:
qty(Number): Ilość podanej insuliny. Eksporty podsumowane dodają ilości w grupie czasowej.reason(String): Jeden z:"Bolus"(insulina przy posiłku)"Basal"(insulina bazowa)