EKG - Format Eksportu JSON

Dokumentacja dotycząca struktury EKG w eksportach JSON

Last updated: February 6, 2026

On this page

EKG (Elektrokardiogram)

Dane EKG obejmują odczyty elektrokardiogramu z kompatybilnych urządzeń Apple (takich jak Apple Watch Series 4 i nowsze). Dane EKG zapewniają szczegółową analizę rytmu serca i mogą wykrywać stany takie jak migotanie przedsionków. W eksportach JSON dane EKG są przechowywane w tablicy ecg.

Struktura

Każdy wpis EKG zawiera wyniki klasyfikacji, pomiary tętna, dane napięcia i informacje o próbkowaniu:

{
  "start": "2024-02-06 14:30:00 -0800",
  "end": "2024-02-06 14:30:30 -0800",
  "classification": "Sinus Rhythm",
  "severity": "Not Set",
  "averageHeartRate": 72,
  "numberOfVoltageMeasurements": 512,
  "voltageMeasurements": [
    {
      "date": "2024-02-06 14:30:00.000 -0800",
      "voltage": 0.123,
      "units": "V"
    }
  ],
  "samplingFrequency": 512,
  "source": "Apple Watch"
}

Pola

Pola Wymagane

  • start (Data): Czas rozpoczęcia odczytu EKG w formacie yyyy-MM-dd HH:mm:ss Z
  • end (Data): Czas zakończenia odczytu EKG w formacie yyyy-MM-dd HH:mm:ss Z
  • classification (String): Klasyfikacja rytmu serca (zobacz klasyfikacje poniżej)
  • averageHeartRate (Liczba): Średnie tętno podczas odczytu EKG w uderzeniach na minutę (bpm)
  • numberOfVoltageMeasurements (Liczba): Całkowita liczba pomiarów napięcia w próbce EKG
  • voltageMeasurements (Tablica): Tablica pomiarów napięcia (zobacz Pomiary Napięcia poniżej)
  • samplingFrequency (Liczba): Częstotliwość próbkowania w Hz (zwykle 512 Hz dla Apple Watch)
  • source (String): Urządzenie źródłowe lub aplikacja, która zarejestrowała EKG

Pola Opcjonalne

  • severity (String): Klasyfikacja ciężkości wyniku EKG (może być "Not Set", jeśli nie dotyczy)

Klasyfikacje EKG

Pole classification wskazuje wykryty rytm serca:

  • "Sinus Rhythm" - Normalny rytm serca
  • "Atrial Fibrillation" - Nieregularny rytm serca (migotanie przedsionków) wykryty
  • "High Heart Rate" - Tętno powyżej normalnego zakresu
  • "Inconclusive Low Heart Rate" - Nie można sklasyfikować z powodu niskiego tętna
  • "Inconclusive High Heart Rate" - Nie można sklasyfikować z powodu wysokiego tętna
  • "Inconclusive" - Nie można określić klasyfikacji
  • "Inconclusive Poor Recording" - Nie można sklasyfikować z powodu słabej jakości sygnału
  • "Unrecognized" - Klasyfikacja nierozpoznana

Pomiary Napięcia

Każdy wpis EKG zawiera tablicę pomiarów napięcia reprezentujących aktywność elektryczną serca w czasie:

{
  "voltageMeasurements": [
    {
      "date": "2024-02-06 14:30:00.000 -0800",
      "voltage": 0.123,
      "units": "V"
    },
    {
      "date": "2024-02-06 14:30:00.002 -0800",
      "voltage": 0.125,
      "units": "V"
    }
  ]
}

Pola Pomiaru Napięcia:

  • date (Data): Dokładny znacznik czasu pomiaru napięcia (zawiera milisekundy)
  • voltage (Liczba): Wartość napięcia w woltach
  • units (String): Jednostka pomiaru (zwykle "V" dla woltów)

Uwaga: Pomiary napięcia są próbkowane z częstotliwością określoną przez samplingFrequency (zwykle 512 Hz, co oznacza 512 pomiarów na sekundę).

Przykładowe Wpisy

Normalny Rytm Zatokowy

{
  "start": "2024-02-06 14:30:00 -0800",
  "end": "2024-02-06 14:30:30 -0800",
  "classification": "Sinus Rhythm",
  "severity": "Not Set",
  "averageHeartRate": 72,
  "numberOfVoltageMeasurements": 15360,
  "voltageMeasurements": [
    {
      "date": "2024-02-06 14:30:00.000 -0800",
      "voltage": 0.123,
      "units": "V"
    }
  ],
  "samplingFrequency": 512,
  "source": "Apple Watch"
}

Wykrycie Migotania Przedsionków

{
  "start": "2024-02-06 16:45:00 -0800",
  "end": "2024-02-06 16:45:30 -0800",
  "classification": "Atrial Fibrillation",
  "severity": "Not Set",
  "averageHeartRate": 95,
  "numberOfVoltageMeasurements": 15360,
  "voltageMeasurements": [
    {
      "date": "2024-02-06 16:45:00.000 -0800",
      "voltage": 0.145,
      "units": "V"
    }
  ],
  "samplingFrequency": 512,
  "source": "Apple Watch"
}

Niejednoznaczny Odczy

{
  "start": "2024-02-06 18:00:00 -0800",
  "end": "2024-02-06 18:00:30 -0800",
  "classification": "Inconclusive Poor Recording",
  "severity": "Not Set",
  "averageHeartRate": 68,
  "numberOfVoltageMeasurements": 15360,
  "voltageMeasurements": [
    {
      "date": "2024-02-06 18:00:00.000 -0800",
      "voltage": 0.098,
      "units": "V"
    }
  ],
  "samplingFrequency": 512,
  "source": "Apple Watch"
}

Zrozumienie Danych EKG

Częstotliwość Próbkowania

samplingFrequency (zwykle 512 Hz) wskazuje, ile pomiarów napięcia jest wykonywanych na sekundę. Dla 30-sekundowego odczytu EKG:

  • Całkowite pomiary = 512 × 30 = 15.360 pomiarów
  • Każdy pomiar reprezentuje około 0,002 sekundy (2 milisekundy) aktywności serca

Pomiary Napięcia

Pomiary napięcia reprezentują aktywność elektryczną serca:

  • Wartości dodatnie: Depolaryzacja (skurcz mięśnia sercowego)
  • Wartości ujemne: Repolaryzacja (rozluźnienie mięśnia sercowego)
  • Analiza wzorca: Wzorzec zmian napięcia w czasie wskazuje rytm serca

Interpretacja Klasyfikacji

  • Rytm Zatokowy: Normalny, zdrowy rytm serca
  • Migotanie Przedsionków: Nieregularny rytm, który może wymagać uwagi medycznej
  • Niejednoznaczny: Może wskazywać na słabą jakość sygnału, ruch podczas odczytu lub inne czynniki
  • Wysokie/Niskie Tętno: Tętno poza normalnym zakresem dla dokładnej klasyfikacji

Zgodność Urządzeń

Funkcjonalność EKG wymaga:

  • Apple Watch Series 4 lub nowszy (z aplikacją EKG)
  • iOS 12.1.1 lub nowszy na sparowanym iPhone
  • Aplikacja EKG zainstalowana i skonfigurowana

Przypadki Użycia

Dane EKG mogą być przydatne do:

  • Monitorowanie rytmu serca: Śledzenie wzorców rytmu serca w czasie
  • Wykrywanie migotania przedsionków: Monitorowanie epizodów migotania przedsionków
  • Dokumentacja medyczna: Udostępnianie danych EKG dostawcom opieki zdrowotnej
  • Analiza trendów: Identyfikacja wzorców lub zmian w rytmie serca
  • Korelacja objawów: Porównywanie odczytów EKG z objawami lub aktywnościami

Ważne Uwagi

  • Nie jest urządzeniem medycznym: EKG Apple Watch nie jest przeznaczone do zastąpienia profesjonalnej diagnozy medycznej
  • Konsultuj się z dostawcami opieki zdrowotnej: Zawsze konsultuj się z profesjonalistami medycznymi dotyczącymi wyników EKG, szczególnie jeśli wykryto migotanie przedsionków
  • Regularne monitorowanie: Regularne odczyty EKG mogą pomóc w identyfikacji wzorców, ale nie powinny zastępować profesjonalnej opieki medycznej
  • Rozmiar pliku: Eksporty EKG z pełnymi pomiarami napięcia mogą być duże ze względu na wysoką częstotliwość próbkowania

Wskazówki

  • Spójne odczyty: Wykonuj odczyty EKG w spójnych porach dla lepszej analizy trendów
  • Właściwe ułożenie: Zapewnij właściwe umieszczenie zegarka i bezruch podczas odczytów dla dokładnych wyników
  • Eksportuj selektywnie: Rozważ zakres dat podczas eksportowania danych EKG, ponieważ pliki mogą być duże z pełnymi pomiarami napięcia

Powiązana Dokumentacja