ECG - Formato de Exportación JSON
Documentación sobre la estructura de ECG en exportaciones JSON
Last updated: February 6, 2026
On this page
- Estructura
- Campos
- Campos Requeridos
- Campos Opcionales
- Clasificaciones de ECG
- Mediciones de Voltaje
- Ejemplos de Entradas
- Ritmo Sinusal Normal
- Detección de Fibrilación Auricular
- Lectura Inconclusa
- Comprensión de los Datos de ECG
- Frecuencia de Muestreo
- Mediciones de Voltaje
- Interpretación de Clasificación
- Compatibilidad de Dispositivos
- Casos de Uso
- Notas Importantes
- Consejos
- Documentación Relacionada
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 formatoyyyy-MM-dd HH:mm:ss Zend(Fecha): Hora de finalización de la lectura del ECG en formatoyyyy-MM-dd HH:mm:ss Zclassification(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 ECGvoltageMeasurements(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 voltiosunits(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
- Resumen del Formato de Exportación JSON
- Notificaciones de Frecuencia Cardíaca - Para alertas de frecuencia cardíaca alta/baja
- Guía de Exportación Manual
- Resumen de Automatizaciones