Métricas de Saúde

As métricas de saúde representam as várias medições e pontos de dados recolhidos pela sua aplicação Apple Health e dispositivos ligados. Nas exportações JSON, as métricas de saúde são armazenadas no array metrics.

Formato do Nome da Métrica

Todos os nomes de 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"
    }
  ]
}

Campos Comuns

• name (String): O nome da métrica de saúde em formato snake_case (ex: "step_count", "heart_rate", "active_energy")
• units (String): A unidade de medida (ex: "count", "bpm", "kcal")
• data (Array): Um array de pontos de dados, cada um contendo:
  • qty (Number): O valor da quantidade
  • date (Date): Timestamp no formato yyyy-MM-dd HH:mm:ss Z

Formatos Especiais de Métricas

Algumas métricas de saúde têm estruturas únicas 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",
      "systolic": 120,
      "diastolic": 80
    }
  ]
}

Campos:

• systolic (Number): A leitura da pressão arterial sistólica (superior)
• diastolic (Number): A leitura da pressão arterial diastólica (inferior)

Frequência Cardíaca

Os dados de frequência cardíaca incluem valores mínimos, médios e máximos:

{
  "name": "heart_rate",
  "units": "bpm",
  "data": [
    {
      "date": "2024-02-06 14:30:00 -0800",
      "Min": 65,
      "Avg": 72,
      "Max": 85
    }
  ]
}

Campos:

• Min (Number): Frequência cardíaca mínima durante o período de medição
• Avg (Number): Frequência cardíaca média durante o período de medição
• Max (Number): Frequência cardíaca máxima durante o período de medição

Análise do Sono

A estrutura dos dados do sono varia dependendo se a agregação de dados está activada nas configurações de exportação.

Dados do Sono Agregados

Quando a agregação está activada, os dados do sono são resumidos por dia:

{
  "name": "sleep_analysis",
  "units": "hr",
  "data": [
    {
      "date": "2024-02-06",
      "totalSleep": 7.5,
      "asleep": 7.0,
      "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"
    }
  ]
}

Campos:

• totalSleep (Number): Tempo total de sono em horas
• asleep (Number): Tempo total em qualquer estado de sono
• core (Number): Duração do sono leve em horas
• deep (Number): Duração do sono profundo em horas
• rem (Number): Duração do sono REM em horas
• sleepStart (Date): Quando o sono realmente começou
• sleepEnd (Date): Quando o sono realmente terminou
• inBed (Number): Tempo total na cama em horas
• inBedStart (Date): Quando se deitou
• inBedEnd (Date): Quando se levantou

Dados do Sono Não Agregados

Quando a agregação está desactivada, segmentos individuais de sono são incluídos:

{
  "name": "sleep_analysis",
  "units": "hr",
  "data": [
    {
      "startDate": "2024-02-05 23:00:00 -0800",
      "endDate": "2024-02-05 23:30:00 -0800",
      "qty": 0.5,
      "value": "Core",
      "deep": 0.0,
      "rem": 0.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"
    }
  ]
}

Campos:

• startDate (Date): Hora de início do segmento de sono
• endDate (Date): Hora de fim do segmento de sono
• qty (Number): Duração do segmento em horas
• value (String): Estado do sono - um dos seguintes:
  • "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 (em vez do tempo total de sono). Isto pode ocorrer se a fonte de dados não suportar o rastreamento de fases do sono.

Glicemia

As leituras de glicemia incluem informações sobre o momento da refeição:

{
  "name": "blood_glucose",
  "units": "mg/dL",
  "data": [
    {
      "date": "2024-02-06 08:00:00 -0800",
      "qty": 95,
      "mealTime": "Before Meal"
    }
  ]
}

Campos:

• qty (Number): Nível de glicemia
• mealTime (String): Um dos seguintes:
  • "Before Meal"
  • "After Meal"
  • "Unspecified"

Actividade Sexual

As entradas de actividade sexual rastreiam o uso de protecção:

{
  "name": "sexual_activity",
  "units": "count",
  "data": [
    {
      "date": "2024-02-06 20:00:00 -0800",
      "Unspecified": 0,
      "Protection Used": 1,
      "Protection Not Used": 0
    }
  ]
}

Campos:

• Unspecified (Number): Contagem quando o estado de protecção é desconhecido
• Protection Used (Number): Contagem quando a protecção foi usada
• Protection Not Used (Number): Contagem quando a protecção não foi usada

Lavagem das Mãos

Os eventos de lavagem das mãos rastreiam o estado de conclusão:

{
  "name": "handwashing",
  "units": "count",
  "data": [
    {
      "date": "2024-02-06 12:00:00 -0800",
      "qty": 1,
      "value": "Complete"
    }
  ]
}

Campos:

• qty (Number): Número de eventos de lavagem das mãos
• value (String): Um dos seguintes:
  • "Complete"
  • "Incomplete"

Escovagem dos Dentes

Os eventos de escovagem dos dentes rastreiam o estado de conclusão:

{
  "name": "toothbrushing",
  "units": "count",
  "data": [
    {
      "date": "2024-02-06 08:00:00 -0800",
      "qty": 1,
      "value": "Complete"
    }
  ]
}

Campos:

• qty (Number): Número de eventos de escovagem dos dentes
• value (String): Um dos seguintes:
  • "Complete"
  • "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",
      "qty": 5,
      "reason": "Bolus"
    }
  ]
}

Campos:

• qty (Number): Quantidade de insulina administrada
• reason (String): Um dos seguintes:
  • "Bolus" (insulina de refeição)
  • "Basal" (insulina de fundo)

Métricas de Saúde Comuns

Algumas métricas de saúde comumente exportadas incluem (todos os nomes de métricas estão em formato snake_case):

• step_count - Contagens diárias de passos
• walking_running_distance - Distância percorrida
• active_energy - Calorias queimadas através da actividade
• resting_heart_rate - Frequência cardíaca em repouso
• heart_rate - Medições de frequência cardíaca
• respiratory_rate - Frequência respiratória
• body_temperature - Leituras de temperatura corporal
• blood_oxygen_saturation - Níveis de SpO2
• weight_&_body_mass - Medições de peso corporal
• body_mass_index - Valores de IMC calculados
• height - Medições de altura
• dietary_water - Consumo de líquidos
• mindful_minutes - Tempo de meditação ou atenção plena

Dicas

• Agrupamento Temporal: Use as configurações de agrupamento temporal na sua configuração de exportação para controlar como os dados são agregados (por segundo, minuto, hora, dia, etc.)
• Agregação de Dados: Active a agregação de dados para resumir o sono e outras métricas por dia para facilitar a análise
• Exportação Selectiva: Pode escolher quais métricas de saúde específicas incluir na sua exportação para reduzir o tamanho do ficheiro e o tempo de processamento

Documentação Relacionada

• Visão Geral do Formato de Exportação JSON
• Guia de Exportação Manual
• Visão Geral das Automações