EKG - Format Eksportu JSON
Dokumentacja dotycząca struktury EKG w eksportach JSON
Last updated: February 6, 2026
On this page
- Struktura
- Pola
- Pola Wymagane
- Pola Opcjonalne
- Klasyfikacje EKG
- Pomiary Napięcia
- Przykładowe Wpisy
- Normalny Rytm Zatokowy
- Wykrycie Migotania Przedsionków
- Niejednoznaczny Odczy
- Zrozumienie Danych EKG
- Częstotliwość Próbkowania
- Pomiary Napięcia
- Interpretacja Klasyfikacji
- Zgodność Urządzeń
- Przypadki Użycia
- Ważne Uwagi
- Wskazówki
- Powiązana Dokumentacja
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 formacieyyyy-MM-dd HH:mm:ss Zend(Data): Czas zakończenia odczytu EKG w formacieyyyy-MM-dd HH:mm:ss Zclassification(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 EKGvoltageMeasurements(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 woltachunits(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
- Przegląd Formatu Eksportu JSON
- Powiadomienia o Tętnie - Dla alertów wysokiego/niskiego tętna
- Przewodnik Eksportu Ręcznego
- Przegląd Automatyzacji