Träningspass - JSON-exportformat
Dokumentation för träningsstruktur i JSON-exporter
Senast uppdaterad: 31 oktober 2026
På denna sida
JSON-exporter lagrar träningspass i arrayet workouts.
Exportversioner
Health Auto Export stöder två exportversioner för träningspass:
- Version 2 (rekommenderas): Förbättrat format med mer detaljerad metadata och strukturerade data
- Version 1 (äldre): Äldre format som behålls för kompatibilitet med befintliga arbetsflöden
Träningspass Version 2
Version 2 inkluderar följande obligatoriska fält och valfria data. Exemplen använder Lokalisera enheter av; aktivering kan ändra enhetsetiketter i måttserier.
Grundstruktur
{
"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
}
Obligatoriska fält
id(String): Unik identifierare för träningspassetname(String): Namn på träningstyp (t.ex. "Running", "Cycling", "Swimming")start(Date): Starttid för träningspasset i formatetyyyy-MM-dd HH:mm:ss Zend(Date): Sluttid för träningspasset i formatetyyyy-MM-dd HH:mm:ss Zduration(Number): Längd för träningspasset i sekunder
Valfria fält
Valfria fält beror på tillgängliga data och dina exportval:
Inspelningskälla
{
"source": {
"name": "Workout App",
"identifier": "com.example.workouts"
}
}
source(Object): Appen eller enheten som registrerade träningspasset, med namn och appidentifierare. Individuella måttvärden har separata källsträngar och kan komma från en annan app eller enhet.
Platsinformation
{
"location": "Outdoor",
"isIndoor": false
}
location(String): Ett av"Indoor","Outdoor","Pool","Open Water"isIndoor(Boolean): Om träningspasset utfördes inomhus
Energi och intensitet
{
"activeEnergyBurned": {
"qty": 350,
"units": "kcal"
},
"totalEnergy": {
"qty": 450,
"units": "kcal"
},
"intensity": {
"qty": 8.5,
"units": "kcal/hr\u00b7kg"
}
}
activeEnergyBurned(Object): Aktiva kalorier förbrända under träningspassettotalEnergy(Object): Totala kalorier (aktiva + vila) förbrändaintensity(Object): Metabolisk ekvivalent av uppgift (MET)
Avstånd och hastighet
{
"distance": {
"qty": 3.5,
"units": "mi"
}
}
distance(Object): Totalt tillryggalagt avståndspeed(Object): Medelhastighet beräknad från avstånd och längdavgSpeed(Object): Medelhastighet under träningspassetmaxSpeed(Object): Maximal uppnådd hastighet
Varje objekt inkluderar qty och units.
Höjd
{
"elevationUp": {
"qty": 500,
"units": "ft"
},
"elevationDown": {
"qty": 450,
"units": "ft"
}
}
elevationUp(Object): Total höjdvinstelevationDown(Object): Total höjdförlust
Enheter: "ft" (fot) eller "m" (meter)
Miljödata
{
"temperature": {
"qty": 72,
"units": "degF"
},
"humidity": {
"qty": 65,
"units": "%"
}
}
temperature(Object): Omgivningstemperatur under träningspassethumidity(Object): Relativ luftfuktighet i procent
Temperaturenheter: "degF" (Fahrenheit) eller "degC" (Celsius)
Simningsspecifika fält
{
"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): Längd på varje varvstrokeStyle(String): Ett av:"Backstroke""Breaststroke""Butterfly""Freestyle""Mixed""Kickboard""Unknown"
swolfScore(Number): Simeffektivitetspoängsalinity(String):"Fresh Water"eller"Salt Water"totalSwimmingStrokeCount(Object): Totalt antal tagswimCadence(Object): Tag per minut
Steg- och kadensdata
{
"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 med stegräkningar över tidstepCadence(Object): Steg per minutflightsClimbed(Object): Antal våningar gångna upp
Hjärtfrekvensdata
{
"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): Summering med min., med. och max. hjärtfrekvens under träningspassetmaxHeartRate(Object): Maximal hjärtfrekvens under träningspassetavgHeartRate(Object): Genomsnittlig hjärtfrekvens under träningspassetheartRateData(Array): Detaljerade mätningar från träningspasset, som slutar när träningspasset slutarheartRateRecovery(Array): Separata mätningar från de två minuterna omedelbart efter att träningspasset slutar
Summerade hjärtfrekvensvärden använder registrerade träningsvärden när de finns, och faller tillbaka till träningspassets hjärtfrekvensmätningar. De exporterade mätningarna inkluderar mätningar tagna under pauser, så deras toppar och genomsnitt kan skilja sig från summeringen.
Tidsserie-dataarrayer
Många mått kan inkluderas som tidsseriearrayer när Inkludera träningsmått är aktiverat:
{
"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"
}
]
}
QuantityData-struktur:
date(Date): Tidsstämpel för mätningenqty(Number): Mängdvärdeunits(String): Måttenhetsource(String, valfritt): Datakällenhet eller -app
HeartRateData-struktur:
date(Date): Tidsstämpel för mätningenMin(Number): MinimihjärtfrekvensAvg(Number): Genomsnittlig hjärtfrekvensMax(Number): Maximihjärtfrekvensunits(String): Enhet (count/minmed Lokalisera enheter av)source(String, valfritt): Datakällenhet eller -app
Ruttdata
När Inkludera ruttdata är aktiverat och träningspasset har GPS-data:
{
"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
}
]
}
Platsfält:
latitude(Number): GPS-latitudlongitude(Number): GPS-longitudaltitude(Number): Höjd i metercourse(Number): Färdriktning i grader (0-360)courseAccuracy(Number): Noggrannhet för kursmätning i graderhorizontalAccuracy(Number): Horisontell positionsnoggrannhet i meterverticalAccuracy(Number): Vertikal positionsnoggrannhet i metertimestamp(Date): Tid när platsen registreradesspeed(Number): Hastighet i meter per sekundspeedAccuracy(Number): Noggrannhet för hastighetsmätning i m/s
Metadata
{
"metadata": {
"customField": {
"label": "value",
"quantity": 123
},
"anotherField": [
1,
2,
3
]
}
}
metadata(Object): Ytterligare anpassad metadata kopplad till träningspasset
Händelser, aktiviteter och splits
Version 2 JSON- och Markdown-exporter kan inkludera events, segments, laps och activities som registrerats av träningsappen. Dessa förblir tillgängliga när Inkludera träningsmått är avstängt. CSV och GPX inkluderar inte dessa poster.
Med Inkludera träningsmått på och relevanta mått valda kan intervall också inkludera avstånd, aktiv energi, hjärtfrekvenssummeringar och pace eller hastighet för aktiv tid. Värden skiljer mellan registrerade mätningar och uppskattningar; otillgängliga värden utelämnas.
Med avstånd valt kan splits inkludera uppskattade kilometer- och mil-splits. De kan skilja sig från inspelningsappens splits, och den sista spliten markeras som delvis när den är kortare än målsträckan. Saknade avståndsmätningar eller träningspass som inte stöds kan förhindra splitberäkning.
Träningsinsatspoäng
Version 2 JSON- och Markdown-exporter kan inkludera valda värden för Träningsinsatspoäng (effortScore) och Uppskattad träningsinsatspoäng (estimatedEffortScore). Varje är ett objekt med qty och units: "appleEffortScore".
Poäng kräver iOS 18 eller senare och åtkomst till motsvarande data i Apple Health. Poäng för hela träningspasset och aktiviteter är separata. De är oberoende av Tidsgruppering och Inkludera träningsmått; CSV inkluderar dem inte.
Under Bläddra → Träningspass öppnar du listans exportblad eller ett träningspass Version 2-exportinställningar och använder Välj exportfält för att välja insatspoäng före export.
Tidsgruppering av träningsmått
När du använder exportversion 2 och Inkludera träningsmått är aktiverat kan du styra granulariteten för tidsseriedata:
- Minuter: Grupperar träningsmått efter klockminuter. Den första och sista minuten kan inkludera några sekunder precis före träningspasset startar eller precis efter att det slutar.
- Sekunder: Grupperar träningsmått efter klocksekunder, där varje tidsstämpel markerar början av sin sekund. Den första och sista sekunden kan inkludera bråkdelen av en sekund precis utanför träningspasset. Filer blir större än minutgruppering.
Aktiv och vilande energi använder samma kombinerade totaler som andra träningsmått i varje tidsgrupp. Mätningar från mer än en enhet eller app inkluderas tillsammans.
Träningspass Version 1 (äldre)
Version 1 använder en enklare struktur. För nya exporter rekommenderas Version 2.
Version 1-struktur
{
"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"
}
]
}