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

Pesquisar tópicos de ajuda

Treinos - Formato de exportação JSON

Documentação da estrutura dos treinos nas exportações JSON

Última atualização: 31 de outubro de 2026

Nesta página
Versões de exportação
Treinos Versão 2 Treinos Versão 2 Estrutura básicaCampos obrigatóriosCampos opcionaisAgrupamento temporal das métricas do treino
Treinos Versão 1 (obsoleto) Treinos Versão 1 (obsoleto) Estrutura da Versão 1
Documentação relacionada

As exportações JSON armazenam os treinos no array workouts.

Versões de exportação

O Health Auto Export oferece suporte a duas versões de exportação de treinos:

  • Versão 2 (recomendada): Formato melhorado com metadados mais detalhados e dados estruturados
  • Versão 1 (obsoleto): Formato anterior mantido para compatibilidade com fluxos existentes

Treinos Versão 2

A Versão 2 inclui os seguintes campos obrigatórios e dados opcionais. Os exemplos usam Localizar unidades desativado; ativá-lo pode alterar os rótulos das unidades nas séries de métricas.

Estrutura básica

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Running",
  "start": "2024-02-06 07:00:00 -0800",
  "end": "2024-02-06 07:30:00 -0800",
  "duration": 1800
}

Campos obrigatórios

  • id (String): Identificador exclusivo do treino
  • name (String): Nome do tipo de treino (ex.: "Running", "Cycling", "Swimming")
  • start (Date): Hora de início do treino no formato yyyy-MM-dd HH:mm:ss Z
  • end (Date): Hora de fim do treino no formato yyyy-MM-dd HH:mm:ss Z
  • duration (Number): Duração do treino em segundos

Campos opcionais

Os campos opcionais dependem dos dados disponíveis e das suas seleções de exportação:

Origem de registo

{
  "source": {
    "name": "Workout App",
    "identifier": "com.example.workouts"
  }
}
  • source (Object): A aplicação ou dispositivo que registou o treino, com nome e identificador da aplicação. As leituras individuais de métricas têm cadeias de origem separadas e podem vir de outra aplicação ou dispositivo.

Informações de localização

{
  "location": "Outdoor",
  "isIndoor": false
}
  • location (String): Um de "Indoor", "Outdoor", "Pool", "Open Water"
  • isIndoor (Boolean): Se o treino foi realizado em ambiente interno

Energia e intensidade

{
  "activeEnergyBurned": {
    "qty": 350,
    "units": "kcal"
  },
  "totalEnergy": {
    "qty": 450,
    "units": "kcal"
  },
  "intensity": {
    "qty": 8.5,
    "units": "kcal/hr\u00b7kg"
  }
}
  • activeEnergyBurned (Object): Calorias ativas queimadas durante o treino
  • totalEnergy (Object): Calorias totais (ativas + em repouso) queimadas
  • intensity (Object): Equivalente metabólico da tarefa (MET)

Distância e velocidade

{
  "distance": {
    "qty": 3.5,
    "units": "mi"
  }
}
  • distance (Object): Distância total percorrida
  • speed (Object): Velocidade média calculada a partir da distância e da duração
  • avgSpeed (Object): Velocidade média ao longo do treino
  • maxSpeed (Object): Velocidade máxima alcançada

Cada objeto inclui qty e units.

Elevação

{
  "elevationUp": {
    "qty": 500,
    "units": "ft"
  },
  "elevationDown": {
    "qty": 450,
    "units": "ft"
  }
}
  • elevationUp (Object): Elevação total ganha
  • elevationDown (Object): Elevação total perdida

Unidades: "ft" (pés) ou "m" (metros)

Dados ambientais

{
  "temperature": {
    "qty": 72,
    "units": "degF"
  },
  "humidity": {
    "qty": 65,
    "units": "%"
  }
}
  • temperature (Object): Temperatura ambiente durante o treino
  • humidity (Object): Percentagem de humidade relativa

Unidades de temperatura: "degF" (Fahrenheit) ou "degC" (Celsius)

Campos específicos de natação

{
  "lapLength": {
    "qty": 0.025,
    "units": "mi"
  },
  "strokeStyle": "Freestyle",
  "swolfScore": 45,
  "salinity": "Fresh Water",
  "totalSwimmingStrokeCount": {
    "qty": 1200,
    "units": "count"
  },
  "swimCadence": {
    "qty": 30,
    "units": "count/min"
  }
}
  • lapLength (Object): Comprimento de cada volta
  • strokeStyle (String): Um de:
    • "Backstroke"
    • "Breaststroke"
    • "Butterfly"
    • "Freestyle"
    • "Mixed"
    • "Kickboard"
    • "Unknown"
  • swolfScore (Number): Pontuação de eficiência da natação
  • salinity (String): "Fresh Water" ou "Salt Water"
  • totalSwimmingStrokeCount (Object): Número total de braçadas
  • swimCadence (Object): Braçadas por minuto

Dados de passos e cadência

{
  "stepCount": [
    {
      "date": "2024-02-06 07:00:00 -0800",
      "qty": 5000,
      "units": "count",
      "source": "Apple Watch"
    }
  ],
  "stepCadence": {
    "qty": 180,
    "units": "count/min"
  },
  "flightsClimbed": {
    "qty": 10,
    "units": "count"
  }
}
  • stepCount (Array): Array de medições de contagem de passos ao longo do tempo
  • stepCadence (Object): Passos por minuto
  • flightsClimbed (Object): Número de lanços de escada subidos

Dados de frequência cardíaca

{
  "heartRate": {
    "min": {
      "qty": 120,
      "units": "count/min"
    },
    "avg": {
      "qty": 150,
      "units": "count/min"
    },
    "max": {
      "qty": 175,
      "units": "count/min"
    }
  },
  "maxHeartRate": {
    "qty": 175,
    "units": "count/min"
  },
  "avgHeartRate": {
    "qty": 150,
    "units": "count/min"
  },
  "heartRateData": [
    {
      "date": "2024-02-06 07:00:00 -0800",
      "Min": 120,
      "Avg": 150,
      "Max": 175,
      "units": "count/min",
      "source": "Apple Watch"
    }
  ],
  "heartRateRecovery": [
    {
      "date": "2024-02-06 07:30:00 -0800",
      "Min": 140,
      "Avg": 145,
      "Max": 150,
      "units": "count/min",
      "source": "Apple Watch"
    }
  ]
}
  • heartRate (Object): Resumo com frequência cardíaca mín., méd. e máx. durante o treino
  • maxHeartRate (Object): Frequência cardíaca máxima durante o treino
  • avgHeartRate (Object): Frequência cardíaca média durante o treino
  • heartRateData (Array): Medições detalhadas do treino, que terminam quando o treino termina
  • heartRateRecovery (Array): Medições separadas dos dois minutos imediatamente após o fim do treino

As frequências cardíacas de resumo usam valores de treino registados quando disponíveis; caso contrário, as leituras de frequência cardíaca do treino. As leituras exportadas incluem medições feitas durante as pausas, pelo que os seus picos e médias podem diferir do resumo.

Arrays de dados em série temporal

Muitas métricas podem ser incluídas como arrays em série temporal quando "Incluir métricas do treino" está ativado:

{
  "activeEnergy": [
    {
      "date": "2024-02-06 07:00:00 -0800",
      "qty": 50,
      "units": "kcal",
      "source": "Apple Watch"
    }
  ],
  "basalEnergy": [
    {
      "date": "2024-02-06 07:00:00 -0800",
      "qty": 20,
      "units": "kcal",
      "source": "Apple Watch"
    }
  ],
  "cyclingCadence": [
    {
      "date": "2024-02-06 07:00:00 -0800",
      "qty": 90,
      "units": "count/min",
      "source": "Apple Watch"
    }
  ],
  "cyclingDistance": [
    {
      "date": "2024-02-06 07:00:00 -0800",
      "qty": 0.5,
      "units": "mi",
      "source": "Apple Watch"
    }
  ],
  "cyclingPower": [
    {
      "date": "2024-02-06 07:00:00 -0800",
      "qty": 200,
      "units": "W",
      "source": "Power Meter"
    }
  ],
  "cyclingSpeed": [
    {
      "date": "2024-02-06 07:00:00 -0800",
      "qty": 18,
      "units": "mi/hr",
      "source": "Apple Watch"
    }
  ],
  "swimDistance": [
    {
      "date": "2024-02-06 07:00:00 -0800",
      "qty": 25,
      "units": "yd",
      "source": "Apple Watch"
    }
  ],
  "swimStroke": [
    {
      "date": "2024-02-06 07:00:00 -0800",
      "qty": 20,
      "units": "count",
      "source": "Apple Watch"
    }
  ],
  "walkingAndRunningDistance": [
    {
      "date": "2024-02-06 07:00:00 -0800",
      "qty": 0.25,
      "units": "mi",
      "source": "Apple Watch"
    }
  ]
}

Estrutura QuantityData:

  • date (Date): Carimbo de data/hora da medição
  • qty (Number): Valor da quantidade
  • units (String): Unidade de medida
  • source (String, opcional): Dispositivo ou aplicação de origem dos dados

Estrutura HeartRateData:

  • date (Date): Carimbo de data/hora da medição
  • Min (Number): Frequência cardíaca mínima
  • Avg (Number): Frequência cardíaca média
  • Max (Number): Frequência cardíaca máxima
  • units (String): Unidade (count/min com Localizar unidades desativado)
  • source (String, opcional): Dispositivo ou aplicação de origem dos dados

Dados de rota

Quando "Incluir dados de rota" está ativado e o treino tem dados GPS:

{
  "route": [
    {
      "latitude": 37.7749,
      "longitude": -122.4194,
      "altitude": 50.5,
      "course": 45.0,
      "courseAccuracy": 5.0,
      "horizontalAccuracy": 10.0,
      "verticalAccuracy": 15.0,
      "timestamp": "2024-02-06 07:00:00 -0800",
      "speed": 7.0,
      "speedAccuracy": 0.5
    }
  ]
}

Campos de localização:

  • latitude (Number): Coordenada GPS de latitude
  • longitude (Number): Coordenada GPS de longitude
  • altitude (Number): Elevação em metros
  • course (Number): Direção de deslocamento em graus (0-360)
  • courseAccuracy (Number): Precisão da medição de rumo em graus
  • horizontalAccuracy (Number): Precisão da posição horizontal em metros
  • verticalAccuracy (Number): Precisão da posição vertical em metros
  • timestamp (Date): Momento em que a localização foi registada
  • speed (Number): Velocidade em metros por segundo
  • speedAccuracy (Number): Precisão da medição de velocidade em m/s

Metadados

{
  "metadata": {
    "customField": {
      "label": "value",
      "quantity": 123
    },
    "anotherField": [
      1,
      2,
      3
    ]
  }
}
  • metadata (Object): Metadados personalizados adicionais associados ao treino

Eventos, atividades e splits

As exportações JSON e Markdown da Versão 2 podem incluir events, segments, laps e activities registados pela aplicação de treino. Continuam disponíveis quando Incluir métricas do treino está desativado. CSV e GPX não incluem esses registos.

Com Incluir métricas do treino ativado e as métricas relevantes selecionadas, os intervalos também podem incluir distância, energia ativa, resumos de frequência cardíaca e ritmo ou velocidade do tempo ativo. Os valores distinguem as medições registadas das estimativas; os valores indisponíveis são omitidos.

Com a distância selecionada, splits pode incluir splits estimados de quilómetros e milhas. Podem diferir dos splits da aplicação de registo, e o split final é marcado como parcial quando é mais curto do que a distância alvo. Leituras de distância em falta ou tipos de treino não compatíveis podem impedir o cálculo dos splits.

Pontuações de esforço do treino

As exportações JSON e Markdown da Versão 2 podem incluir valores selecionados de Pontuação de esforço do treino (effortScore) e Pontuação de esforço do treino estimada (estimatedEffortScore). Cada um é um objeto com qty e units: "appleEffortScore".

As pontuações exigem iOS 18 ou posterior e acesso aos dados correspondentes no Apple Health. As pontuações do treino completo e da atividade são independentes. São independentes de Agrupamento temporal e Incluir métricas do treino; CSV não as inclui.

Em Explorar → Treinos, abra a folha de exportação da lista ou as definições de exportação Versão 2 de um treino e use Selecionar campos de exportação para escolher as pontuações de esforço antes de exportar.

Agrupamento temporal das métricas do treino

Ao usar a Versão de exportação 2 e com "Incluir métricas do treino" ativado, pode controlar a granularidade dos dados em série temporal:

  • Minutos: Agrupa as métricas do treino pelos minutos do relógio. O primeiro e o último minuto podem incluir alguns segundos imediatamente antes do início do treino ou imediatamente após o fim.
  • Segundos: Agrupa as métricas do treino pelos segundos do relógio, com cada carimbo de data/hora a marcar o início do respetivo segundo. O primeiro e o último segundo podem incluir a fração de segundo imediatamente fora do treino. Os ficheiros são maiores do que com o agrupamento por minutos.

Energia ativa e em repouso usam os mesmos totais combinados das outras métricas do treino em cada grupo temporal. As leituras de mais de um dispositivo ou aplicação são incluídas juntas.

Treinos Versão 1 (obsoleto)

A Versão 1 usa uma estrutura mais simples. Para exportações novas, a Versão 2 é recomendada.

Estrutura da Versão 1

{
  "name": "Running",
  "start": "2024-02-06 07:00:00 -0800",
  "end": "2024-02-06 07:30:00 -0800",
  "totalEnergy": {
    "qty": 450,
    "units": "kcal"
  },
  "activeEnergy": {
    "qty": 350,
    "units": "kcal"
  },
  "distance": {
    "qty": 3.5,
    "units": "mi"
  },
  "heartRateData": [
    {
      "date": "2024-02-06 07:00:00 -0800",
      "qty": 150,
      "units": "bpm"
    }
  ],
  "route": [
    {
      "lat": 37.7749,
      "lon": -122.4194,
      "altitude": 50.5,
      "timestamp": "2024-02-06 07:00:00 -0800"
    }
  ]
}

Documentação relacionada