Centro de ajuda HealthyApps
Português (Portugal)
Centro de ajuda
Site principal ↗

Pesquisar tópicos de ajuda

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
Formato do nome da métrica
Estrutura Estrutura Campos comuns
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 insulina
Documentação relacionada

As 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 quantidade
    • date (Date): Carimbo de data/hora no formato yyyy-MM-dd HH:mm:ss Z
    • source (String, quando disponível): A aplicação ou dispositivo que registou 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çã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

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 horas
  • asleep (Number): Tempo de sono sem uma fase de sono registada, em horas
  • core (Number): Duração do sono core em horas
  • deep (Number): Duração do sono profundo em horas
  • rem (Number): Duração do sono REM em horas
  • awake (Number): Tempo acordado 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 foi para a cama
  • inBedEnd (Date): Quando 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 sono
  • end, endDate (Date): Hora de fim do segmento de sono
  • source (String): A aplicação ou dispositivo que registou o segmento
  • qty (Number): Duração do segmento em horas
  • value (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 à monitorização 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 sangue
  • mealTime (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 registados 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 amostra
  • foodType (String, opcional): Nome do alimento registado pela aplicação 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 registam 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 estado de proteção é desconhecido
  • Protection Used (Number): Contagem de eventos naquele dia quando foi usada proteção
  • Protection 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 registam o estado 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 registam o estado 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)

Documentação relacionada