ECG - Formato de Exportación JSON

Documentación sobre la estructura de ECG en exportaciones JSON

Last updated: February 6, 2026

On this page

ECG (Electrocardiograma)

Los datos de ECG incluyen lecturas de electrocardiograma de dispositivos Apple compatibles (como Apple Watch Series 4 y posteriores). Los datos de ECG proporcionan un análisis detallado del ritmo cardíaco y pueden detectar condiciones como la fibrilación auricular. En las exportaciones JSON, los datos de ECG se almacenan en el array ecg.

Estructura

Cada entrada de ECG incluye resultados de clasificación, mediciones de frecuencia cardíaca, datos de voltaje e información de muestreo:

{
  "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"
}

Campos

Campos Requeridos

  • start (Fecha): Hora de inicio de la lectura del ECG en formato yyyy-MM-dd HH:mm:ss Z
  • end (Fecha): Hora de finalización de la lectura del ECG en formato yyyy-MM-dd HH:mm:ss Z
  • classification (Cadena): Clasificación del ritmo cardíaco (ver clasificaciones a continuación)
  • averageHeartRate (Número): Frecuencia cardíaca promedio durante la lectura del ECG en latidos por minuto (lpm)
  • numberOfVoltageMeasurements (Número): Número total de mediciones de voltaje en la muestra de ECG
  • voltageMeasurements (Array): Array de mediciones de voltaje (ver Mediciones de Voltaje a continuación)
  • samplingFrequency (Número): Frecuencia de muestreo en Hz (típicamente 512 Hz para Apple Watch)
  • source (Cadena): Dispositivo o aplicación fuente que registró el ECG

Campos Opcionales

  • severity (Cadena): Clasificación de severidad del resultado del ECG (puede ser "Not Set" si no es aplicable)

Clasificaciones de ECG

El campo classification indica el ritmo cardíaco detectado:

  • "Sinus Rhythm" - Ritmo cardíaco normal
  • "Atrial Fibrillation" - Ritmo cardíaco irregular (FA) detectado
  • "High Heart Rate" - Frecuencia cardíaca por encima del rango normal
  • "Inconclusive Low Heart Rate" - No se puede clasificar debido a una frecuencia cardíaca baja
  • "Inconclusive High Heart Rate" - No se puede clasificar debido a una frecuencia cardíaca alta
  • "Inconclusive" - No se puede determinar la clasificación
  • "Inconclusive Poor Recording" - No se puede clasificar debido a una calidad de señal deficiente
  • "Unrecognized" - Clasificación no reconocida

Mediciones de Voltaje

Cada entrada de ECG incluye un array de mediciones de voltaje que representan la actividad eléctrica del corazón a lo largo del tiempo:

{
  "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"
    }
  ]
}

Campos de Medición de Voltaje:

  • date (Fecha): Marca de tiempo precisa de la medición de voltaje (incluye milisegundos)
  • voltage (Número): Valor de voltaje en voltios
  • units (Cadena): Unidad de medición (típicamente "V" para voltios)

Nota: Las mediciones de voltaje se muestrean a la frecuencia especificada por samplingFrequency (típicamente 512 Hz, lo que significa 512 mediciones por segundo).

Ejemplos de Entradas

Ritmo Sinusal Normal

{
  "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"
}

Detección de Fibrilación Auricular

{
  "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"
}

Lectura Inconclusa

{
  "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"
}

Comprensión de los Datos de ECG

Frecuencia de Muestreo

La samplingFrequency (típicamente 512 Hz) indica cuántas mediciones de voltaje se toman por segundo. Para una lectura de ECG de 30 segundos:

  • Mediciones totales = 512 × 30 = 15,360 mediciones
  • Cada medición representa aproximadamente 0.002 segundos (2 milisegundos) de actividad cardíaca

Mediciones de Voltaje

Las mediciones de voltaje representan la actividad eléctrica del corazón:

  • Valores positivos: Despolarización (contracción del músculo cardíaco)
  • Valores negativos: Repolarización (relajación del músculo cardíaco)
  • Análisis de patrones: El patrón de cambios de voltaje a lo largo del tiempo indica el ritmo cardíaco

Interpretación de Clasificación

  • Ritmo Sinusal: Ritmo cardíaco normal y saludable
  • Fibrilación Auricular: Ritmo irregular que puede requerir atención médica
  • Inconcluso: Puede indicar calidad de señal deficiente, movimiento durante la lectura u otros factores
  • Frecuencia Cardíaca Alta/Baja: Frecuencia cardíaca fuera del rango normal para una clasificación precisa

Compatibilidad de Dispositivos

La funcionalidad de ECG requiere:

  • Apple Watch Series 4 o posterior (con aplicación de ECG)
  • iOS 12.1.1 o posterior en el iPhone emparejado
  • Aplicación de ECG instalada y configurada

Casos de Uso

Los datos de ECG pueden ser útiles para:

  • Monitoreo del ritmo cardíaco: Rastrear patrones de ritmo cardíaco a lo largo del tiempo
  • Detección de FA: Monitorear episodios de fibrilación auricular
  • Registros médicos: Compartir datos de ECG con proveedores de atención médica
  • Análisis de tendencias: Identificar patrones o cambios en el ritmo cardíaco
  • Correlación de síntomas: Cruzar referencias de lecturas de ECG con síntomas o actividades

Notas Importantes

  • No es un dispositivo médico: El ECG de Apple Watch no está destinado a reemplazar el diagnóstico médico profesional
  • Consulte a los proveedores de atención médica: Siempre consulte con profesionales de la salud sobre los resultados del ECG, especialmente si se detecta FA
  • Monitoreo regular: Las lecturas regulares de ECG pueden ayudar a identificar patrones, pero no deben reemplazar la atención médica profesional
  • Tamaño del archivo: Las exportaciones de ECG con mediciones de voltaje completas pueden ser grandes debido a la alta frecuencia de muestreo

Consejos

  • Lecturas consistentes: Tome lecturas de ECG en momentos consistentes para un mejor análisis de tendencias
  • Posicionamiento adecuado: Asegure la colocación adecuada del reloj y la quietud durante las lecturas para resultados precisos
  • Exportar selectivamente: Considere el rango de fechas al exportar datos de ECG, ya que los archivos pueden ser grandes con mediciones de voltaje completas

Documentación Relacionada