Métricas de saúde - Formato de exportação JSON
Documentação da estrutura das métricas de saúde nas exportações JSON
Última atualização: 31 de outubro de 2026
Nesta página
Formatos especiais de métricas
Formatos especiais de métricas Pressão arterialFrequência cardíacaVariabilidade da frequência cardíacaAnálise do sonoGlicose no sangueNutriçãoAtividade sexualLavagem das mãosEscovação dos dentesAdministração de insulinaAs exportações JSON armazenam as métricas de saúde no array metrics.
Formato do nome da métrica
Todos os nomes das métricas nas exportações JSON usam o formato snake_case (minúsculas com underscores). Por exemplo:
- "Step Count" torna-se
"step_count" - "Blood Pressure" torna-se
"blood_pressure" - "Heart Rate" torna-se
"heart_rate" - "Walking + Running Distance" torna-se
"walking_running_distance"
Estrutura
O array metrics contém objetos, cada um representando um tipo específico de métrica de saúde. A maioria das métricas de saúde segue uma estrutura comum:
{
"name": "step_count",
"units": "count",
"data": [
{
"qty": 8500,
"date": "2024-02-06 14:30:00 -0800",
"source": "Apple Watch"
}
]
}
Campos comuns
name(String): O nome da métrica de saúde no formato snake_case (ex.: "step_count", "heart_rate", "active_energy")units(String): A unidade de medida (ex.: "count", "count/min", "kcal")data(Array): Um array de pontos de dados, cada um com:qty(Number): O valor da quantidadedate(Date): Carimbo de data/hora no formatoyyyy-MM-dd HH:mm:ss Zsource(String, quando disponível): O app ou dispositivo que registrou a amostra
Formatos especiais de métricas
Algumas métricas de saúde têm estruturas exclusivas que diferem do formato comum:
Pressão arterial
As leituras de pressão arterial incluem valores sistólicos e diastólicos:
{
"name": "blood_pressure",
"units": "mmHg",
"data": [
{
"date": "2024-02-06 14:30:00 -0800",
"start": "2024-02-06 14:30:00 -0800",
"end": "2024-02-06 14:30:00 -0800",
"systolic": 120,
"diastolic": 80,
"source": "Health"
}
]
}
Campos:
systolic(Number): A leitura da pressão arterial sistólica (superior). As exportações resumidas usam a média das leituras do grupo temporal.diastolic(Number): A leitura da pressão arterial diastólica (inferior). As exportações resumidas usam a média das leituras do grupo temporal.
Frequência cardíaca
Os dados de frequência cardíaca incluem valores mínimo, médio e máximo:
{
"name": "heart_rate",
"units": "count/min",
"data": [
{
"date": "2024-02-06 14:30:00 -0800",
"Min": 65,
"Avg": 72,
"Max": 85,
"source": "Apple Watch"
}
]
}
Campos:
Min(Number): Frequência cardíaca mínima durante o período de mediçãoAvg(Number): Frequência cardíaca média durante o período de mediçãoMax(Number): Frequência cardíaca máxima durante o período de medição
Variabilidade da frequência cardíaca
Com Resumir dados desativado, as exportações JSON de Variabilidade da frequência cardíaca (SDNN) podem incluir leituras batimento a batimento disponíveis. Exigem acesso de leitura a Série de batimentos no Apple Health.
As exportações resumidas, as exportações CSV e a HRV de recuperação não incluem leituras batimento a batimento.
Análise do sono
A estrutura dos dados de sono depende de Resumir dados estar ativado ou desativado.
Resumir dados ativado
Com Resumir dados ativado, os dados de sono são resumidos por dia. As durações da mesma fase são somadas. O sono total é a soma de asleep, core, deep e REM. O JSON conserva cada dia. Em CSV, um grupo temporal mais grosseiro mostra o último dia daquele grupo:
{
"name": "sleep_analysis",
"units": "hr",
"data": [
{
"date": "2024-02-06 00:00:00 -0800",
"totalSleep": 7.5,
"asleep": 0.5,
"core": 3.5,
"deep": 1.5,
"rem": 2.0,
"sleepStart": "2024-02-05 23:00:00 -0800",
"sleepEnd": "2024-02-06 06:30:00 -0800",
"inBed": 8.0,
"inBedStart": "2024-02-05 22:45:00 -0800",
"inBedEnd": "2024-02-06 06:45:00 -0800",
"awake": 0.0,
"source": "Apple Watch"
}
]
}
Campos:
totalSleep(Number): Tempo total de sono em horasasleep(Number): Tempo de sono sem uma fase de sono registrada, em horascore(Number): Duração do sono core em horasdeep(Number): Duração do sono profundo em horasrem(Number): Duração do sono REM em horasawake(Number): Tempo acordado em horassleepStart(Date): Quando o sono realmente começousleepEnd(Date): Quando o sono realmente terminouinBed(Number): Tempo total na cama em horasinBedStart(Date): Quando você foi para a camainBedEnd(Date): Quando você saiu da cama
Resumir dados desativado
Com Resumir dados desativado, são incluídos os segmentos de sono individuais:
{
"name": "sleep_analysis",
"units": "hr",
"data": [
{
"date": "2024-02-05 23:00:00 -0800",
"start": "2024-02-05 23:00:00 -0800",
"end": "2024-02-05 23:30:00 -0800",
"startDate": "2024-02-05 23:00:00 -0800",
"endDate": "2024-02-05 23:30:00 -0800",
"qty": 0.5,
"value": "Core",
"source": "Apple Watch"
}
]
}
Campos:
date,start,startDate(Date): Hora de início do segmento de sonoend,endDate(Date): Hora de fim do segmento de sonosource(String): O app ou dispositivo que registrou o segmentoqty(Number): Duração do segmento em horasvalue(String): Estado do sono - um de:"Awake""Asleep"(fase de sono não categorizada)"In Bed""Core""REM""Deep""Unspecified"
Nota: "Asleep" refere-se a uma fase de sono não categorizada (não ao tempo total de sono). Pode ocorrer se a origem dos dados não oferecer suporte ao monitoramento das fases do sono.
Glicose no sangue
As leituras de glicose no sangue incluem informações sobre o momento da refeição:
{
"name": "blood_glucose",
"units": "mg/dL",
"data": [
{
"date": "2024-02-06 08:00:00 -0800",
"start": "2024-02-06 08:00:00 -0800",
"end": "2024-02-06 08:00:00 -0800",
"qty": 95,
"mealTime": "Before Meal",
"source": "Health"
}
]
}
Campos:
qty(Number): Nível de glicose no sanguemealTime(String): Um de:"Before Meal""After Meal""Unspecified"
Nutrição
Quando Resumir dados está desativado, as amostras individuais de quantidade de nutrição (por exemplo, Energia alimentar ou Carboidratos) podem incluir detalhes dos alimentos registrados no Apple Health. Por exemplo:
{
"name": "dietary_energy",
"units": "kcal",
"data": [
{
"date": "2024-02-06 08:00:00 -0800",
"start": "2024-02-06 08:00:00 -0800",
"end": "2024-02-06 08:00:00 -0800",
"qty": 240,
"source": "Lose It!",
"foodType": "Boneless, Skinless Grilled Chicken Breast"
}
]
}
Campos:
qty(Number): Quantidade do nutriente da amostrafoodType(String, opcional): Nome do alimento registrado pelo app de origem, quando disponível
Com Resumir dados ativado, os totais de nutrição não incluem foodType.
Atividade sexual
As entradas de atividade sexual registram o uso de proteção:
{
"name": "sexual_activity",
"units": "count",
"data": [
{
"date": "2024-02-06 00:00:00 -0800",
"Unspecified": 0,
"Protection Used": 1,
"Protection Not Used": 0,
"source": "Health"
}
]
}
Campos:
Unspecified(Number): Contagem de eventos naquele dia quando o status de proteção é desconhecidoProtection Used(Number): Contagem de eventos naquele dia quando foi usada proteçãoProtection Not Used(Number): Contagem de eventos naquele dia quando não foi usada proteção
As exportações resumidas contam cada dia do calendário. O JSON conserva cada dia. Em CSV, um grupo temporal mais grosseiro mostra o último dia daquele grupo.
Lavagem das mãos
Os eventos de lavagem das mãos registram o status de conclusão:
{
"name": "handwashing",
"units": "s",
"data": [
{
"date": "2024-02-06 12:00:00 -0800",
"start": "2024-02-06 12:00:00 -0800",
"end": "2024-02-06 12:00:25 -0800",
"qty": 25,
"value": "Completed",
"source": "Apple Watch"
}
]
}
Campos:
qty(Number): Duração em segundos. As exportações resumidas usam a duração média do grupo temporal.value(String):"Completed"quando a sessão dura mais de 20 segundos; caso contrário"Incomplete"
Escovação dos dentes
Os eventos de escovação dos dentes registram o status de conclusão:
{
"name": "toothbrushing",
"units": "s",
"data": [
{
"date": "2024-02-06 08:00:00 -0800",
"start": "2024-02-06 08:00:00 -0800",
"end": "2024-02-06 08:02:10 -0800",
"qty": 130,
"value": "Completed",
"source": "Health"
}
]
}
Campos:
qty(Number): Duração em segundos. As exportações resumidas usam a duração média do grupo temporal.value(String):"Completed"quando a sessão dura pelo menos 2 minutos; caso contrário"Incomplete"
Administração de insulina
As entradas de administração de insulina incluem o motivo da administração:
{
"name": "insulin_delivery",
"units": "IU",
"data": [
{
"date": "2024-02-06 08:00:00 -0800",
"start": "2024-02-06 08:00:00 -0800",
"end": "2024-02-06 08:00:00 -0800",
"qty": 5,
"reason": "Bolus",
"source": "Health"
}
]
}
Campos:
qty(Number): Quantidade de insulina administrada. As exportações resumidas somam as quantidades do grupo temporal.reason(String): Um de:"Bolus"(insulina das refeições)"Basal"(insulina basal)