Træninger - JSON-eksportformat
Dokumentation for træningsstruktur i JSON-eksporter
Senest opdateret: 31. oktober 2026
På denne side
JSON-eksporter gemmer træninger i arrayet workouts.
Eksportversioner
Health Auto Export understøtter to eksportversioner for træninger:
- Version 2 (anbefalet): Forbedret format med mere detaljerede metadata og strukturerede data
- Version 1 (ældre): Ældre format bevaret for kompatibilitet med eksisterende arbejdsgange
Træninger Version 2
Version 2 inkluderer følgende påkrævede felter og valgfrie data. Eksempler bruger Lokaliser enheder fra; aktivering kan ændre enhedsetiketter i målingsserier.
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
}
Påkrævede felter
id(String): Unik identifikator for træningenname(String): Navn på træningstype (f.eks. "Running", "Cycling", "Swimming")start(Date): Træningens starttidspunkt i formatetyyyy-MM-dd HH:mm:ss Zend(Date): Træningens sluttidspunkt i formatetyyyy-MM-dd HH:mm:ss Zduration(Number): Træningens varighed i sekunder
Valgfrie felter
Valgfrie felter afhænger af tilgængelige data og dine eksportvalg:
Optagelseskilde
{
"source": {
"name": "Workout App",
"identifier": "com.example.workouts"
}
}
source(Object): Appen eller enheden, der registrerede træningen, med navn og app-identifikator. Individuelle målingsværdier har separate kildestrenge og kan komme fra en anden app eller enhed.
Placeringsoplysninger
{
"location": "Outdoor",
"isIndoor": false
}
location(String): En af"Indoor","Outdoor","Pool","Open Water"isIndoor(Boolean): Om træningen blev udført indendørs
Energi og intensitet
{
"activeEnergyBurned": {
"qty": 350,
"units": "kcal"
},
"totalEnergy": {
"qty": 450,
"units": "kcal"
},
"intensity": {
"qty": 8.5,
"units": "kcal/hr\u00b7kg"
}
}
activeEnergyBurned(Object): Aktive kalorier forbrændt under træningentotalEnergy(Object): Samlede kalorier (aktive + hvile) forbrændtintensity(Object): Metabolisk ækvivalent af opgave (MET)
Afstand og hastighed
{
"distance": {
"qty": 3.5,
"units": "mi"
}
}
distance(Object): Samlet tilbagelagt afstandspeed(Object): Gennemsnitshastighed beregnet ud fra afstand og varighedavgSpeed(Object): Gennemsnitshastighed under træningenmaxSpeed(Object): Maksimal nået hastighed
Hvert objekt inkluderer qty og units.
Højde
{
"elevationUp": {
"qty": 500,
"units": "ft"
},
"elevationDown": {
"qty": 450,
"units": "ft"
}
}
elevationUp(Object): Samlet højdeforøgelseelevationDown(Object): Samlet højdetab
Enheder: "ft" (fod) eller "m" (meter)
Miljødata
{
"temperature": {
"qty": 72,
"units": "degF"
},
"humidity": {
"qty": 65,
"units": "%"
}
}
temperature(Object): Omgivelsestemperatur under træningenhumidity(Object): Relativ luftfugtighed i procent
Temperatuurenheder: "degF" (Fahrenheit) eller "degC" (Celsius)
Svømmespecifikke felter
{
"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ængde af hver banestrokeStyle(String): En af:"Backstroke""Breaststroke""Butterfly""Freestyle""Mixed""Kickboard""Unknown"
swolfScore(Number): Svømmeeffektivitetsscoresalinity(String):"Fresh Water"eller"Salt Water"totalSwimmingStrokeCount(Object): Samlet antal tagswimCadence(Object): Tag pr. minut
Skridt- og 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 af skridttællinger over tidstepCadence(Object): Skridt pr. minutflightsClimbed(Object): Antal etager gået op
Pulsdata
{
"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): Opsummering med min., gns. og maks. puls under træningenmaxHeartRate(Object): Maksimal puls under træningenavgHeartRate(Object): Gennemsnitspuls under træningenheartRateData(Array): Detaljerede målinger fra træningen, der slutter, når træningen slutterheartRateRecovery(Array): Separate målinger fra de to minutter umiddelbart efter træningens afslutning
Opsummeringspulsværdier bruger registrerede træningsværdier, når de er tilgængelige, og falder tilbage til træningens pulsmålinger. De eksporterede målinger inkluderer målinger taget under pauser, så deres toppe og gennemsnit kan afvige fra opsummeringen.
Tidsserie-dataarrays
Mange målinger kan inkluderes som tidsseriearrays, når Inkluder træningsmålinger er aktiveret:
{
"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): Tidsstempel for målingenqty(Number): Mængdeværdiunits(String): Måleenhedsource(String, valgfri): Datakildeenhed eller -app
HeartRateData-struktur:
date(Date): Tidsstempel for målingenMin(Number): MinimumspulsAvg(Number): GennemsnitspulsMax(Number): Maximumspulsunits(String): Enhed (count/minmed Lokaliser enheder fra)source(String, valgfri): Datakildeenhed eller -app
Rutedata
Når Inkluder rutedata er aktiveret, og træningen 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
}
]
}
Placeringsfelter:
latitude(Number): GPS-breddegradlongitude(Number): GPS-længdegradaltitude(Number): Højde i metercourse(Number): Rejseretning i grader (0-360)courseAccuracy(Number): Nøjagtighed af kursmåling i graderhorizontalAccuracy(Number): Horisontal positionsnøjagtighed i meterverticalAccuracy(Number): Vertikal positionsnøjagtighed i metertimestamp(Date): Tidspunkt, hvor placeringen blev registreretspeed(Number): Hastighed i meter pr. sekundspeedAccuracy(Number): Nøjagtighed af hastighedsmåling i m/s
Metadata
{
"metadata": {
"customField": {
"label": "value",
"quantity": 123
},
"anotherField": [
1,
2,
3
]
}
}
metadata(Object): Yderligere tilpassede metadata knyttet til træningen
Begivenheder, aktiviteter og splits
Version 2 JSON- og Markdown-eksporter kan inkludere events, segments, laps og activities registreret af træningsappen. Disse forbliver tilgængelige, når Inkluder træningsmålinger er slået fra. CSV og GPX inkluderer ikke disse poster.
Med Inkluder træningsmålinger til og relevante målinger valgt kan intervaller også inkludere afstand, aktiv energi, pulsopsummeringer og pace eller hastighed for aktiv tid. Værdier skelner mellem registrerede målinger og estimater; utilgængelige værdier udelades.
Med afstand valgt kan splits inkludere estimerede kilometer- og mil-splits. De kan afvige fra optagelsesappens splits, og den sidste split markeres som delvis, når den er kortere end målafstanden. Manglende afstandsmålinger eller ikke-understøttede træningstyper kan forhindre splitberegning.
Træningsindsatsresultater
Version 2 JSON- og Markdown-eksporter kan inkludere valgte værdier for Træningsindsatsresultat (effortScore) og Estimeret træningsindsatsresultat (estimatedEffortScore). Hver er et objekt med qty og units: "appleEffortScore".
Resultater kræver iOS 18 eller nyere og adgang til de tilsvarende data i Apple Health. Resultater for hele træningen og aktiviteter er separate. De er uafhængige af Tidsgruppering og Inkluder træningsmålinger; CSV inkluderer dem ikke.
Under Browse → Træninger skal du åbne listens eksportark eller en trænings Version 2-eksportindstillinger og bruge Vælg eksportfelter til at vælge indsatsresultater før eksport.
Tidsgruppering for træningsmålinger
Når du bruger eksportversion 2, og Inkluder træningsmålinger er aktiveret, kan du styre granulariteten af tidsseriedata:
- Minutter: Grupperer træningsmålinger efter urminutter. Det første og sidste minut kan inkludere nogle få sekunder lige før træningen starter eller lige efter den slutter.
- Sekunder: Grupperer træningsmålinger efter ursekunder, hvor hvert tidsstempel markerer starten af sit sekund. Det første og sidste sekund kan inkludere brøkdelen af et sekund lige uden for træningen. Filer er større end minutgruppering.
Aktiv og hvileenergi bruger de samme kombinerede totaler som andre træningsmålinger i hver tidsgruppe. Målinger fra mere end én enhed eller app inkluderes sammen.
Træninger Version 1 (ældre)
Version 1 bruger en enklere struktur. Til nye eksporter anbefales 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"
}
]
}