Como o HealthKit Funciona
Um guia técnico sobre como a Apple Health armazena e organiza os seus dados de saúde.
O que é o HealthKit?
O HealthKit é a estrutura (framework) da Apple para dados de saúde e fitness. Funciona como um repositório central que:
- Armazena dados de saúde de múltiplas fontes (Apple Watch, iPhone, aplicações de terceiros).
- Fornece um formato de dados consistente para todas as métricas de saúde.
- Gere as permissões de privacidade de forma detalhada.
- Permite a compartilhamento de dados entre aplicações autorizadas.
Como os Dados são Armazenados
O HealthKit armazena dados como amostras tipificadas (typed samples), geralmente com:
| Componente | Descrição | Exemplo |
|---|---|---|
| Hora de início/fim | Quando a medição ocorreu | 2025-01-15 08:30:00 |
| Valor + unidade | A própria medição | 72 bpm |
| Fonte e dispositivo | Qual a aplicação/dispositivo que gravou | Apple Watch Series 9 |
| Metadados | Contexto adicional | Tipo de treino, posição do dispositivo |
Tipos de Amostras
Amostras de Quantidade
Medições numéricas com unidades.
Exemplos: - Contagem de passos (passos) - Frequência cardíaca (bpm) - Glicose no sangue (mg/dL) - Distância (metros) - Energia queimada (kcal)
Amostras de Categoria
Valores enumerados a partir de um conjunto definido.
Exemplos: - Fase do sono (REM, Core, Profundo, Acordado) - Fluxo menstrual (ligeiro, médio, abundante) - Sessão de atenção plena (presente/não presente)
Amostras de Correlação
Grupos de amostras relacionadas armazenadas em conjunto.
Exemplos: - Pressão arterial (sistólica + diastólica) - Alimentos (múltiplos nutrientes de uma refeição)
Amostras de Treino
Sessões de atividade estruturadas com: - Tipo de atividade (corrida, natação, ciclismo, etc.) - Hora de início e fim - Energia total queimada - Distância (se aplicável) - Dados de rota (se gravados)
Registos Clínicos
Quando suportado pela sua região e fornecedor de cuidados de saúde: - Resultados laboratoriais - Registos de imunização - Medicações - Documentos clínicos
Fontes de Dados
O HealthKit pode receber dados de múltiplas fontes:
Dispositivos Apple
- Apple Watch - Frequência cardíaca, atividade, treinos, ECG, sono, oxigénio no sangue.
- iPhone - Passos, distância, lances de escada subidos (sensores de movimento).
Dispositivos de Terceiros
- Balanças inteligentes (peso, composição corporal)
- Medidores de pressão arterial
- Medidores de glicose
- Monitores de sono
Entrada Manual
- Dados introduzidos pelo usuário na aplicação Apple Health.
- Dados introduzidos através de aplicações de terceiros.
Integração com Cuidados de Saúde
- Registos clínicos de fornecedores suportados.
- Resultados laboratoriais (onde disponível).
Prioridade das Fontes
Quando múltiplas fontes gravam a mesma métrica, o HealthKit utiliza regras para determinar quais os dados a exibir:
- Os dados introduzidos pelo usuário costumam ter a prioridade mais alta.
- Dados de dispositivos provenientes de sensores usados (wearables).
- Dados de aplicações de terceiros.
Pode gerir a prioridade das fontes nas definições da Apple Health.
Arquitetura de Privacidade
O modelo de privacidade do HealthKit é fundamental para o seu design:
Permissões por Tipo
As aplicações solicitam acesso a tipos de dados específicos, não a todos os dados de saúde. Pode conceder: - Apenas acesso de leitura - Apenas acesso de escrita - Leitura e escrita - Nenhum
Controlo do Usuário
- Reveja as permissões a qualquer momento em Definições > Saúde > Acesso a Dados e Dispositivos.
- Revogue o acesso a qualquer momento.
- Veja quais as aplicações que acederam a que tipos de dados.
Armazenamento no Dispositivo
- Os dados de saúde são armazenados localmente no seu iPhone.
- Encriptados com o código de acesso do seu dispositivo.
- Cópia de segurança em iCloud apenas se a Saúde estiver ativa nas definições de iCloud.
Identificadores Comuns do HealthKit
Cada tipo de dados tem um identificador único. Exemplos:
| Métrica | Identificador do HealthKit |
|---|---|
| Frequência Cardíaca | HKQuantityTypeIdentifier.heartRate |
| Contagem de Passos | HKQuantityTypeIdentifier.stepCount |
| Análise do Sono | HKCategoryTypeIdentifier.sleepAnalysis |
| VO₂ Máx | HKQuantityTypeIdentifier.vo2Max |
| Pressão Arterial | HKCorrelationTypeIdentifier.bloodPressure |