Allenamenti - Formato di esportazione JSON
Documentazione della struttura degli allenamenti nelle esportazioni JSON
Ultimo aggiornamento: 31 ottobre 2026
In questa pagina
Le esportazioni JSON memorizzano gli allenamenti nell’array workouts.
Versioni di esportazione
Health Auto Export supporta due versioni di esportazione degli allenamenti:
- Versione 2 (consigliata): Formato migliorato con metadati più dettagliati e dati strutturati
- Versione 1 (legacy): Formato precedente mantenuto per la compatibilità con i flussi esistenti
Workouts Version 2
La Versione 2 include i seguenti campi obbligatori e dati facoltativi. Gli esempi usano Localizza unità disattivato; attivarlo può cambiare le etichette delle unità nelle serie di metriche.
Struttura di base
{
"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
}
Campi obbligatori
id(String): Identificatore univoco dell’allenamentoname(String): Nome del tipo di allenamento (ad es. "Running", "Cycling", "Swimming")start(Date): Ora di inizio dell’allenamento nel formatoyyyy-MM-dd HH:mm:ss Zend(Date): Ora di fine dell’allenamento nel formatoyyyy-MM-dd HH:mm:ss Zduration(Number): Durata dell’allenamento in secondi
Campi facoltativi
I campi facoltativi dipendono dai dati disponibili e dalle selezioni di esportazione:
Origine di registrazione
{
"source": {
"name": "Workout App",
"identifier": "com.example.workouts"
}
}
source(Object): L’app o il dispositivo che ha registrato l’allenamento, con nome e identificatore dell’app. Le singole letture delle metriche hanno stringhe di origine separate e possono provenire da un’altra app o dispositivo.
Informazioni sulla posizione
{
"location": "Outdoor",
"isIndoor": false
}
location(String): Uno di"Indoor","Outdoor","Pool","Open Water"isIndoor(Boolean): Se l’allenamento è stato eseguito indoor
Energia e intensità
{
"activeEnergyBurned": {
"qty": 350,
"units": "kcal"
},
"totalEnergy": {
"qty": 450,
"units": "kcal"
},
"intensity": {
"qty": 8.5,
"units": "kcal/hr\u00b7kg"
}
}
activeEnergyBurned(Object): Calorie attive bruciate durante l’allenamentototalEnergy(Object): Calorie totali (attive + a riposo) bruciateintensity(Object): Equivalente metabolico del compito (MET)
Distanza e velocità
{
"distance": {
"qty": 3.5,
"units": "mi"
}
}
distance(Object): Distanza totale percorsaspeed(Object): Velocità media calcolata da distanza e durataavgSpeed(Object): Velocità media per tutto l’allenamentomaxSpeed(Object): Velocità massima raggiunta
Ciascun oggetto include qty e units.
Dislivello
{
"elevationUp": {
"qty": 500,
"units": "ft"
},
"elevationDown": {
"qty": 450,
"units": "ft"
}
}
elevationUp(Object): Dislivello totale guadagnatoelevationDown(Object): Dislivello totale perso
Unità: "ft" (piedi) oppure "m" (metri)
Dati ambientali
{
"temperature": {
"qty": 72,
"units": "degF"
},
"humidity": {
"qty": 65,
"units": "%"
}
}
temperature(Object): Temperatura ambientale durante l’allenamentohumidity(Object): Umidità relativa in percentuale
Unità di temperatura: "degF" (Fahrenheit) oppure "degC" (Celsius)
Campi specifici del nuoto
{
"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): Lunghezza di ciascuna vascastrokeStyle(String): Uno di:"Backstroke""Breaststroke""Butterfly""Freestyle""Mixed""Kickboard""Unknown"
swolfScore(Number): Punteggio di efficienza del nuotosalinity(String):"Fresh Water"oppure"Salt Water"totalSwimmingStrokeCount(Object): Numero totale di bracciateswimCadence(Object): Bracciate al minuto
Dati di passi e cadenza
{
"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 di misurazioni del conteggio passi nel tempostepCadence(Object): Passi al minutoflightsClimbed(Object): Numero di piani saliti
Dati della frequenza cardiaca
{
"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): Riepilogo con frequenza cardiaca min., media e max. durante l’allenamentomaxHeartRate(Object): Frequenza cardiaca massima durante l’allenamentoavgHeartRate(Object): Frequenza cardiaca media durante l’allenamentoheartRateData(Array): Misurazioni dettagliate dall’allenamento, che terminano quando termina l’allenamentoheartRateRecovery(Array): Misurazioni separate dai due minuti immediatamente successivi alla fine dell’allenamento
Le frequenze cardiache di riepilogo usano i valori registrati dell’allenamento quando disponibili, altrimenti le letture della frequenza cardiaca dell’allenamento. Le letture esportate includono misurazioni durante le pause, quindi i picchi e le medie possono differire dal riepilogo.
Array di dati in serie temporale
Molte metriche possono essere incluse come array in serie temporale quando "Includi metriche dell’allenamento" è attivato:
{
"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"
}
]
}
Struttura QuantityData:
date(Date): Timestamp della misurazioneqty(Number): Valore di quantitàunits(String): Unità di misurasource(String, facoltativo): Dispositivo o app di origine dei dati
Struttura HeartRateData:
date(Date): Timestamp della misurazioneMin(Number): Frequenza cardiaca minimaAvg(Number): Frequenza cardiaca mediaMax(Number): Frequenza cardiaca massimaunits(String): Unità (count/mincon Localizza unità disattivato)source(String, facoltativo): Dispositivo o app di origine dei dati
Dati del percorso
Quando "Includi dati del percorso" è attivato e l’allenamento ha dati 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
}
]
}
Campi della posizione:
latitude(Number): Coordinata GPS di latitudinelongitude(Number): Coordinata GPS di longitudinealtitude(Number): Altitudine in metricourse(Number): Direzione di viaggio in gradi (0-360)courseAccuracy(Number): Accuratezza della misurazione della direzione in gradihorizontalAccuracy(Number): Accuratezza della posizione orizzontale in metriverticalAccuracy(Number): Accuratezza della posizione verticale in metritimestamp(Date): Momento in cui è stata registrata la posizionespeed(Number): Velocità in metri al secondospeedAccuracy(Number): Accuratezza della misurazione della velocità in m/s
Metadati
{
"metadata": {
"customField": {
"label": "value",
"quantity": 123
},
"anotherField": [
1,
2,
3
]
}
}
metadata(Object): Metadati personalizzati aggiuntivi associati all’allenamento
Eventi, attività e split
Le esportazioni JSON e Markdown della Versione 2 possono includere events, segments, laps e activities registrati dall’app di allenamento. Restano disponibili quando Includi metriche dell’allenamento è disattivato. CSV e GPX non includono questi record.
Con Includi metriche dell’allenamento attivato e le metriche rilevanti selezionate, gli intervalli possono anche includere distanza, energia attiva, riepiloghi della frequenza cardiaca e passo o velocità del tempo attivo. I valori distinguono le misurazioni registrate dalle stime; i valori non disponibili vengono omessi.
Con la distanza selezionata, splits può includere split stimati di chilometri e miglia. Possono differire dagli split dell’app di registrazione, e lo split finale è contrassegnato come parziale quando è più corto della distanza obiettivo. Letture di distanza mancanti o tipi di allenamento non supportati possono impedire il calcolo degli split.
Punteggi di sforzo dell’allenamento
Le esportazioni JSON e Markdown della Versione 2 possono includere valori selezionati di Punteggio sforzo allenamento (effortScore) e Punteggio sforzo allenamento stimato (estimatedEffortScore). Ciascuno è un oggetto con qty e units: "appleEffortScore".
I punteggi richiedono iOS 18 o successivo e accesso ai dati corrispondenti in Apple Health. I punteggi dell’allenamento completo e dell’attività sono separati. Sono indipendenti da Raggruppamento temporale e Includi metriche dell’allenamento; CSV non li include.
In Sfoglia → Allenamenti, apri il foglio di esportazione dell’elenco o le impostazioni di esportazione Versione 2 di un allenamento, poi usa Seleziona campi di esportazione per scegliere i punteggi di sforzo prima di esportare.
Raggruppamento temporale delle metriche dell’allenamento
Quando usi la Versione di esportazione 2 e "Includi metriche dell’allenamento" è attivato, puoi controllare la granularità dei dati in serie temporale:
- Minuti: Raggruppa le metriche dell’allenamento sui minuti dell’orologio. Il primo e l’ultimo minuto possono includere alcuni secondi appena prima dell’inizio dell’allenamento o appena dopo la fine.
- Secondi: Raggruppa le metriche dell’allenamento sui secondi dell’orologio, con ciascun timestamp che segna l’inizio del relativo secondo. Il primo e l’ultimo secondo possono includere la frazione di secondo appena fuori dall’allenamento. I file sono più grandi rispetto al raggruppamento per minuti.
Energia attiva e a riposo usano gli stessi totali combinati delle altre metriche dell’allenamento in ciascun gruppo temporale. Le letture da più di un dispositivo o app sono incluse insieme.
Workouts Version 1 (obsoleto)
La Versione 1 usa una struttura più semplice. Per le nuove esportazioni, è consigliata la Versione 2.
Struttura della Versione 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"
}
]
}