Centrum pomocy HealthyApps
Polski
Centrum pomocy
Strona główna ↗

Szukaj tematów pomocy

Metryki zdrowia — format eksportu JSON

Dokumentacja struktury metryk zdrowia w eksportach JSON

Ostatnia aktualizacja: 31 października 2026

Na tej stronie
Format nazw metryk
Struktura Struktura Wspólne pola
Specjalne formaty metryk Specjalne formaty metryk Ciśnienie krwiTętnoZmienność rytmu sercaAnaliza snuGlukoza we krwiOdżywianieAktywność seksualnaMycie rąkSzczotkowanie zębówPodawanie insuliny
Powiązana dokumentacja

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ściowa
    • date (Date): Znacznik czasu w formacie yyyy-MM-dd HH:mm:ss Z
    • source (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 pomiaru
  • Avg (Number): Średnie tętno w okresie pomiaru
  • Max (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 godzinach
  • asleep (Number): Czas snu bez zarejestrowanej fazy snu, w godzinach
  • core (Number): Czas snu core w godzinach
  • deep (Number): Czas snu głębokiego w godzinach
  • rem (Number): Czas snu REM w godzinach
  • awake (Number): Czas czuwania w godzinach
  • sleepStart (Date): Kiedy sen faktycznie się rozpoczął
  • sleepEnd (Date): Kiedy sen faktycznie się zakończył
  • inBed (Number): Całkowity czas w łóżku w godzinach
  • inBedStart (Date): Kiedy położyłeś się do łóżka
  • inBedEnd (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 snu
  • end, endDate (Date): Czas zakończenia segmentu snu
  • source (String): Aplikacja lub urządzenie, które zarejestrowało segment
  • qty (Number): Czas trwania segmentu w godzinach
  • value (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 krwi
  • mealTime (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óbki
  • foodType (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 nieznany
  • Protection Used (Number): Liczba zdarzeń tego dnia, gdy użyto ochrony
  • Protection 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)

Powiązana dokumentacja