ECG - Formato de Exportação JSON
Documentação sobre a estrutura de ECG em exportações JSON
Last updated: February 6, 2026
On this page
- Estrutura
- Campos
- Campos Obrigatórios
- Campos Opcionais
- Classificações de ECG
- Medições de Tensão
- Exemplos de Entradas
- Ritmo Sinusal Normal
- Detecção de Fibrilação Auricular
- Leitura Inconclusiva
- Compreendendo os Dados de ECG
- Frequência de Amostragem
- Medições de Tensão
- Interpretação de Classificação
- Compatibilidade de Dispositivos
- Casos de Uso
- Notas Importantes
- Dicas
- Documentação Relacionada
ECG (Electrocardiograma)
Os dados de ECG incluem leituras de electrocardiograma de dispositivos Apple compatíveis (como Apple Watch Series 4 e posteriores). Os dados de ECG fornecem análise detalhada do ritmo cardíaco e podem detectar condições como fibrilação auricular. Nas exportações JSON, os dados de ECG são armazenados no array ecg.
Estrutura
Cada entrada de ECG inclui resultados de classificação, medições de frequência cardíaca, dados de tensão e informações de amostragem:
{
"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 Obrigatórios
start(Data): Hora de início da leitura do ECG no formatoyyyy-MM-dd HH:mm:ss Zend(Data): Hora de término da leitura do ECG no formatoyyyy-MM-dd HH:mm:ss Zclassification(String): Classificação do ritmo cardíaco (veja classificações abaixo)averageHeartRate(Número): Frequência cardíaca média durante a leitura do ECG em batimentos por minuto (bpm)numberOfVoltageMeasurements(Número): Número total de medições de tensão na amostra de ECGvoltageMeasurements(Array): Array de medições de tensão (veja Medições de Tensão abaixo)samplingFrequency(Número): Frequência de amostragem em Hz (tipicamente 512 Hz para Apple Watch)source(String): Dispositivo ou aplicação de origem que registou o ECG
Campos Opcionais
severity(String): Classificação de severidade do resultado do ECG (pode ser "Not Set" se não aplicável)
Classificações de ECG
O campo classification indica o ritmo cardíaco detectado:
"Sinus Rhythm"- Ritmo cardíaco normal"Atrial Fibrillation"- Ritmo cardíaco irregular (FA) detectado"High Heart Rate"- Frequência cardíaca acima da gama normal"Inconclusive Low Heart Rate"- Incapaz de classificar devido à baixa frequência cardíaca"Inconclusive High Heart Rate"- Incapaz de classificar devido à alta frequência cardíaca"Inconclusive"- Incapaz de determinar a classificação"Inconclusive Poor Recording"- Incapaz de classificar devido à baixa qualidade do sinal"Unrecognized"- Classificação não reconhecida
Medições de Tensão
Cada entrada de ECG inclui um array de medições de tensão que representam a atividade elétrica do coração ao longo do 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"
}
]
}
Campos de Medição de Tensão:
date(Data): Timestamp preciso da medição de tensão (inclui milissegundos)voltage(Número): Valor de tensão em voltsunits(String): Unidade de medição (tipicamente"V"para volts)
Nota: As medições de tensão são amostradas na frequência especificada por samplingFrequency (tipicamente 512 Hz, significando 512 medições por segundo).
Exemplos 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"
}
Detecção de Fibrilação 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"
}
Leitura Inconclusiva
{
"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"
}
Compreendendo os Dados de ECG
Frequência de Amostragem
A samplingFrequency (tipicamente 512 Hz) indica quantas medições de tensão são feitas por segundo. Para uma leitura de ECG de 30 segundos:
- Medições totais = 512 × 30 = 15.360 medições
- Cada medição representa aproximadamente 0,002 segundos (2 milissegundos) de atividade cardíaca
Medições de Tensão
As medições de tensão representam a atividade elétrica do coração:
- Valores positivos: Despolarização (contração do músculo cardíaco)
- Valores negativos: Repolarização (relaxamento do músculo cardíaco)
- Análise de padrão: O padrão de mudanças de tensão ao longo do tempo indica o ritmo cardíaco
Interpretação de Classificação
- Ritmo Sinusal: Ritmo cardíaco normal e saudável
- Fibrilação Auricular: Ritmo irregular que pode requerer atenção médica
- Inconclusivo: Pode indicar baixa qualidade do sinal, movimento durante a leitura ou outros fatores
- Frequência Cardíaca Alta/Baixa: Frequência cardíaca fora da gama normal para classificação precisa
Compatibilidade de Dispositivos
A funcionalidade de ECG requer:
- Apple Watch Series 4 ou posterior (com app de ECG)
- iOS 12.1.1 ou posterior no iPhone emparelhado
- App de ECG instalado e configurado
Casos de Uso
Os dados de ECG podem ser úteis para:
- Monitoramento do ritmo cardíaco: Rastrear padrões de ritmo cardíaco ao longo do tempo
- Detecção de FA: Monitorar episódios de fibrilação auricular
- Registos médicos: Partilhar dados de ECG com prestadores de cuidados de saúde
- Análise de tendências: Identificar padrões ou mudanças no ritmo cardíaco
- Correlação de sintomas: Cruzar referências de leituras de ECG com sintomas ou atividades
Notas Importantes
- Não é um dispositivo médico: O ECG do Apple Watch não se destina a substituir o diagnóstico médico profissional
- Consulte prestadores de cuidados de saúde: Consulte sempre profissionais de saúde sobre os resultados do ECG, especialmente se FA for detectada
- Monitoramento regular: Leituras regulares de ECG podem ajudar a identificar padrões, mas não devem substituir cuidados médicos profissionais
- Tamanho do ficheiro: Exportações de ECG com medições de tensão completas podem ser grandes devido à alta taxa de amostragem
Dicas
- Leituras consistentes: Faça leituras de ECG em horários consistentes para melhor análise de tendências
- Posicionamento adequado: Garanta o posicionamento adequado do relógio e imobilidade durante as leituras para resultados precisos
- Exportar seletivamente: Considere o intervalo de datas ao exportar dados de ECG, pois os ficheiros podem ser grandes com medições de tensão completas
Documentação Relacionada
- Visão Geral do Formato de Exportação JSON
- Notificações de Frequência Cardíaca - Para alertas de frequência cardíaca alta/baixa
- Guia de Exportação Manual
- Visão Geral de Automações