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
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 aprimorado 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 treinoname(String): Nome do tipo de treino (ex.: "Running", "Cycling", "Swimming")start(Date): Hora de início do treino no formatoyyyy-MM-dd HH:mm:ss Zend(Date): Hora de fim do treino no formatoyyyy-MM-dd HH:mm:ss Zduration(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 registro
{
"source": {
"name": "Workout App",
"identifier": "com.example.workouts"
}
}
source(Object): O app ou dispositivo que registrou o treino, com nome e identificador do app. As leituras individuais de métricas têm cadeias de origem separadas e podem vir de outro app 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 treinototalEnergy(Object): Calorias totais (ativas + em repouso) queimadasintensity(Object): Equivalente metabólico da tarefa (MET)
Distância e velocidade
{
"distance": {
"qty": 3.5,
"units": "mi"
}
}
distance(Object): Distância total percorridaspeed(Object): Velocidade média calculada a partir da distância e da duraçãoavgSpeed(Object): Velocidade média ao longo do treinomaxSpeed(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 ganhaelevationDown(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 treinohumidity(Object): Porcentagem de umidade 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 voltastrokeStyle(String): Um de:"Backstroke""Breaststroke""Butterfly""Freestyle""Mixed""Kickboard""Unknown"
swolfScore(Number): Pontuação de eficiência da nataçãosalinity(String):"Fresh Water"ou"Salt Water"totalSwimmingStrokeCount(Object): Número total de braçadasswimCadence(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 tempostepCadence(Object): Passos por minutoflightsClimbed(Object): Número de lances 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 treinomaxHeartRate(Object): Frequência cardíaca máxima durante o treinoavgHeartRate(Object): Frequência cardíaca média durante o treinoheartRateData(Array): Medições detalhadas do treino, que terminam quando o treino terminaheartRateRecovery(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 registrados 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, portanto 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çãoqty(Number): Valor da quantidadeunits(String): Unidade de medidasource(String, opcional): Dispositivo ou app de origem dos dados
Estrutura HeartRateData:
date(Date): Carimbo de data/hora da mediçãoMin(Number): Frequência cardíaca mínimaAvg(Number): Frequência cardíaca médiaMax(Number): Frequência cardíaca máximaunits(String): Unidade (count/mincom Localizar unidades desativado)source(String, opcional): Dispositivo ou app 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 latitudelongitude(Number): Coordenada GPS de longitudealtitude(Number): Elevação em metroscourse(Number): Direção de deslocamento em graus (0-360)courseAccuracy(Number): Precisão da medição de rumo em graushorizontalAccuracy(Number): Precisão da posição horizontal em metrosverticalAccuracy(Number): Precisão da posição vertical em metrostimestamp(Date): Momento em que a localização foi registradaspeed(Number): Velocidade em metros por segundospeedAccuracy(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 registrados pelo app de treino. Continuam disponíveis quando Incluir métricas do treino está desativado. CSV e GPX não incluem esses registros.
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 registradas 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 do app de registro, e o split final é marcado como parcial quando é mais curto que a distância alvo. Leituras de distância ausentes 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 configuraçõ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, você 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 marcando o início do respectivo segundo. O primeiro e o último segundo podem incluir a fração de segundo imediatamente fora do treino. Os arquivos 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 app 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"
}
]
}