Centro assistenza HealthyApps
Italiano
Centro assistenza
Sito principale ↗

Cerca argomenti di assistenza

Allenamenti - Formato di esportazione JSON

Documentazione della struttura degli allenamenti nelle esportazioni JSON

Ultimo aggiornamento: 31 ottobre 2026

In questa pagina
Versioni di esportazione
Workouts Version 2 Workouts Version 2 Struttura di baseCampi obbligatoriCampi facoltativiRaggruppamento temporale delle metriche dell’allenamento
Workouts Version 1 (obsoleto) Workouts Version 1 (obsoleto) Struttura della Versione 1
Documentazione correlata

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’allenamento
  • name (String): Nome del tipo di allenamento (ad es. "Running", "Cycling", "Swimming")
  • start (Date): Ora di inizio dell’allenamento nel formato yyyy-MM-dd HH:mm:ss Z
  • end (Date): Ora di fine dell’allenamento nel formato yyyy-MM-dd HH:mm:ss Z
  • duration (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’allenamento
  • totalEnergy (Object): Calorie totali (attive + a riposo) bruciate
  • intensity (Object): Equivalente metabolico del compito (MET)

Distanza e velocità

{
  "distance": {
    "qty": 3.5,
    "units": "mi"
  }
}
  • distance (Object): Distanza totale percorsa
  • speed (Object): Velocità media calcolata da distanza e durata
  • avgSpeed (Object): Velocità media per tutto l’allenamento
  • maxSpeed (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 guadagnato
  • elevationDown (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’allenamento
  • humidity (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 vasca
  • strokeStyle (String): Uno di:
    • "Backstroke"
    • "Breaststroke"
    • "Butterfly"
    • "Freestyle"
    • "Mixed"
    • "Kickboard"
    • "Unknown"
  • swolfScore (Number): Punteggio di efficienza del nuoto
  • salinity (String): "Fresh Water" oppure "Salt Water"
  • totalSwimmingStrokeCount (Object): Numero totale di bracciate
  • swimCadence (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 tempo
  • stepCadence (Object): Passi al minuto
  • flightsClimbed (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’allenamento
  • maxHeartRate (Object): Frequenza cardiaca massima durante l’allenamento
  • avgHeartRate (Object): Frequenza cardiaca media durante l’allenamento
  • heartRateData (Array): Misurazioni dettagliate dall’allenamento, che terminano quando termina l’allenamento
  • heartRateRecovery (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 misurazione
  • qty (Number): Valore di quantità
  • units (String): Unità di misura
  • source (String, facoltativo): Dispositivo o app di origine dei dati

Struttura HeartRateData:

  • date (Date): Timestamp della misurazione
  • Min (Number): Frequenza cardiaca minima
  • Avg (Number): Frequenza cardiaca media
  • Max (Number): Frequenza cardiaca massima
  • units (String): Unità (count/min con 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 latitudine
  • longitude (Number): Coordinata GPS di longitudine
  • altitude (Number): Altitudine in metri
  • course (Number): Direzione di viaggio in gradi (0-360)
  • courseAccuracy (Number): Accuratezza della misurazione della direzione in gradi
  • horizontalAccuracy (Number): Accuratezza della posizione orizzontale in metri
  • verticalAccuracy (Number): Accuratezza della posizione verticale in metri
  • timestamp (Date): Momento in cui è stata registrata la posizione
  • speed (Number): Velocità in metri al secondo
  • speedAccuracy (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"
    }
  ]
}

Documentazione correlata