ECG - Formato di Esportazione JSON

Documentazione sulla struttura ECG nelle esportazioni JSON

Last updated: February 6, 2026

On this page

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 formato yyyy-MM-dd HH:mm:ss Z
  • end (Data): Ora di fine della lettura ECG nel formato yyyy-MM-dd HH:mm:ss Z
  • classification (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 ECG
  • voltageMeasurements (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 volt
  • units (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