ECG - Formato di Esportazione JSON
Documentazione sulla struttura ECG nelle esportazioni JSON
Last updated: February 6, 2026
On this page
- Struttura
- Campi
- Campi Richiesti
- Campi Opzionali
- Classificazioni ECG
- Misurazioni di Tensione
- Esempi di Voci
- Ritmo Sinusale Normale
- Rilevamento di Fibrillazione Atriale
- Lettura Inconcludente
- Comprensione dei Dati ECG
- Frequenza di Campionamento
- Misurazioni di Tensione
- Interpretazione della Classificazione
- Compatibilità dei Dispositivi
- Casi d'Uso
- Note Importanti
- Suggerimenti
- Documentazione Correlata
ECG (Elettrocardiogramma)
I dati ECG includono letture di elettrocardiogramma da dispositivi Apple compatibili (come Apple Watch Series 4 e successivi). I dati ECG forniscono un'analisi dettagliata del ritmo cardiaco e possono rilevare condizioni come la fibrillazione atriale. Nelle esportazioni JSON, i dati ECG sono memorizzati nell'array ecg.
Struttura
Ogni voce ECG include risultati di classificazione, misurazioni della frequenza cardiaca, dati di tensione e informazioni di campionamento:
{
"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"
}
Campi
Campi Richiesti
start(Data): Ora di inizio della lettura ECG nel formatoyyyy-MM-dd HH:mm:ss Zend(Data): Ora di fine della lettura ECG nel formatoyyyy-MM-dd HH:mm:ss Zclassification(Stringa): Classificazione del ritmo cardiaco (vedi classificazioni sotto)averageHeartRate(Numero): Frequenza cardiaca media durante la lettura ECG in battiti al minuto (bpm)numberOfVoltageMeasurements(Numero): Numero totale di misurazioni di tensione nel campione ECGvoltageMeasurements(Array): Array di misurazioni di tensione (vedi Misurazioni di Tensione sotto)samplingFrequency(Numero): Frequenza di campionamento in Hz (tipicamente 512 Hz per Apple Watch)source(Stringa): Dispositivo o app sorgente che ha registrato l'ECG
Campi Opzionali
severity(Stringa): Classificazione della gravità del risultato ECG (può essere "Not Set" se non applicabile)
Classificazioni ECG
Il campo classification indica il ritmo cardiaco rilevato:
"Sinus Rhythm"- Ritmo cardiaco normale"Atrial Fibrillation"- Ritmo cardiaco irregolare (FA) rilevato"High Heart Rate"- Frequenza cardiaca sopra il range normale"Inconclusive Low Heart Rate"- Impossibile classificare a causa di una frequenza cardiaca bassa"Inconclusive High Heart Rate"- Impossibile classificare a causa di una frequenza cardiaca alta"Inconclusive"- Impossibile determinare la classificazione"Inconclusive Poor Recording"- Impossibile classificare a causa di una scarsa qualità del segnale"Unrecognized"- Classificazione non riconosciuta
Misurazioni di Tensione
Ogni voce ECG include un array di misurazioni di tensione che rappresentano l'attività elettrica del cuore nel tempo:
{
"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"
}
]
}
Campi di Misurazione di Tensione:
date(Data): Timestamp preciso della misurazione di tensione (include millisecondi)voltage(Numero): Valore di tensione in voltunits(Stringa): Unità di misura (tipicamente"V"per volt)
Nota: Le misurazioni di tensione sono campionate alla frequenza specificata da samplingFrequency (tipicamente 512 Hz, ovvero 512 misurazioni al secondo).
Esempi di Voci
Ritmo Sinusale Normale
{
"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"
}
Rilevamento di Fibrillazione Atriale
{
"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"
}
Lettura Inconcludente
{
"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"
}
Comprensione dei Dati ECG
Frequenza di Campionamento
La samplingFrequency (tipicamente 512 Hz) indica quante misurazioni di tensione vengono effettuate al secondo. Per una lettura ECG di 30 secondi:
- Misurazioni totali = 512 × 30 = 15.360 misurazioni
- Ogni misurazione rappresenta circa 0,002 secondi (2 millisecondi) di attività cardiaca
Misurazioni di Tensione
Le misurazioni di tensione rappresentano l'attività elettrica del cuore:
- Valori positivi: Depolarizzazione (contrazione del muscolo cardiaco)
- Valori negativi: Ripolarizzazione (rilassamento del muscolo cardiaco)
- Analisi del pattern: Il pattern dei cambiamenti di tensione nel tempo indica il ritmo cardiaco
Interpretazione della Classificazione
- Ritmo Sinusale: Ritmo cardiaco normale e sano
- Fibrillazione Atriale: Ritmo irregolare che può richiedere attenzione medica
- Inconcludente: Può indicare scarsa qualità del segnale, movimento durante la lettura o altri fattori
- Frequenza Cardiaca Alta/Bassa: Frequenza cardiaca fuori dal range normale per una classificazione accurata
Compatibilità dei Dispositivi
La funzionalità ECG richiede:
- Apple Watch Series 4 o successivi (con app ECG)
- iOS 12.1.1 o successivi sull'iPhone abbinato
- App ECG installata e configurata
Casi d'Uso
I dati ECG possono essere utili per:
- Monitoraggio del ritmo cardiaco: Tracciare i pattern del ritmo cardiaco nel tempo
- Rilevamento FA: Monitorare episodi di fibrillazione atriale
- Cartelle cliniche: Condividere dati ECG con fornitori di assistenza sanitaria
- Analisi delle tendenze: Identificare pattern o cambiamenti nel ritmo cardiaco
- Correlazione dei sintomi: Incrociare le letture ECG con sintomi o attività
Note Importanti
- Non è un dispositivo medico: L'ECG di Apple Watch non è destinato a sostituire la diagnosi medica professionale
- Consultare i fornitori di assistenza sanitaria: Consultare sempre i professionisti sanitari riguardo ai risultati ECG, specialmente se viene rilevata FA
- Monitoraggio regolare: Le letture ECG regolari possono aiutare a identificare pattern, ma non dovrebbero sostituire l'assistenza medica professionale
- Dimensione del file: Le esportazioni ECG con misurazioni di tensione complete possono essere grandi a causa dell'elevata frequenza di campionamento
Suggerimenti
- Letture consistenti: Eseguire letture ECG a orari consistenti per una migliore analisi delle tendenze
- Posizionamento corretto: Assicurarsi del corretto posizionamento dell'orologio e dell'immobilità durante le letture per risultati accurati
- Esportare selettivamente: Considerare l'intervallo di date quando si esportano dati ECG, poiché i file possono essere grandi con misurazioni di tensione complete
Documentazione Correlata
- Panoramica del Formato di Esportazione JSON
- Notifiche della Frequenza Cardiaca - Per avvisi di frequenza cardiaca alta/bassa
- Guida all'Esportazione Manuale
- Panoramica delle Automazioni