Treningsøkter - JSON-eksportformat
Dokumentasjon for treningsstruktur i JSON-eksporter
Sist oppdatert: 31. oktober 2026
På denne siden
JSON-eksporter lagrer treningsøkter i arrayen workouts.
Eksportversjoner
Health Auto Export støtter to eksportversjoner for treningsøkter:
- Versjon 2 (anbefalt): Forbedret format med mer detaljert metadata og strukturerte data
- Versjon 1 (eldre): Eldre format som beholdes for kompatibilitet med eksisterende arbeidsflyter
Treningsøkter Versjon 2
Versjon 2 inkluderer følgende obligatoriske felt og valgfrie data. Eksemplene bruker Lokaliser enheter av; aktivering kan endre enhetsetiketter i målserier.
Grunnstruktur
{
"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
}
Obligatoriske felt
id(String): Unik identifikator for treningsøktenname(String): Navn på treningstype (f.eks. "Running", "Cycling", "Swimming")start(Date): Starttid for treningsøkten i formatetyyyy-MM-dd HH:mm:ss Zend(Date): Sluttid for treningsøkten i formatetyyyy-MM-dd HH:mm:ss Zduration(Number): Lengde for treningsøkten i sekunder
Valgfrie felt
Valgfrie felt avhenger av tilgjengelige data og eksportvalgene dine:
Opptakskilde
{
"source": {
"name": "Workout App",
"identifier": "com.example.workouts"
}
}
source(Object): Appen eller enheten som registrerte treningsøkten, med navn og appidentifikator. Individuelle målinger har separate kildestrenger og kan komme fra en annen app eller enhet.
Stedsinformasjon
{
"location": "Outdoor",
"isIndoor": false
}
location(String): Én av"Indoor","Outdoor","Pool","Open Water"isIndoor(Boolean): Om treningsøkten ble utført innendø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 forbrent under treningsøktentotalEnergy(Object): Totale kalorier (aktive + hvile) forbrentintensity(Object): Metabolsk ekvivalent av oppgave (MET)
Avstand og hastighet
{
"distance": {
"qty": 3.5,
"units": "mi"
}
}
distance(Object): Total tilbakelagt avstandspeed(Object): Gjennomsnittshastighet beregnet fra avstand og lengdeavgSpeed(Object): Gjennomsnittshastighet under treningsøktenmaxSpeed(Object): Maksimal oppnådd hastighet
Hvert objekt inkluderer qty og units.
Høyde
{
"elevationUp": {
"qty": 500,
"units": "ft"
},
"elevationDown": {
"qty": 450,
"units": "ft"
}
}
elevationUp(Object): Total høydegevinstelevationDown(Object): Total høyde tap
Enheter: "ft" (fot) eller "m" (meter)
Miljødata
{
"temperature": {
"qty": 72,
"units": "degF"
},
"humidity": {
"qty": 65,
"units": "%"
}
}
temperature(Object): Omgivelsestemperatur under treningsøktenhumidity(Object): Relativ luftfuktighet i prosent
Temperaturenheter: "degF" (Fahrenheit) eller "degC" (Celsius)
Svømmespesifikke felt
{
"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): Lengde på hvert bassengstrokeStyle(String): Én av:"Backstroke""Breaststroke""Butterfly""Freestyle""Mixed""Kickboard""Unknown"
swolfScore(Number): Svømmeeffektivitetspoengsalinity(String):"Fresh Water"eller"Salt Water"totalSwimmingStrokeCount(Object): Totalt antall takswimCadence(Object): Tak per minutt
Steg- 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 med stegtellinger over tidstepCadence(Object): Steg per minuttflightsClimbed(Object): Antall etasjer gått opp
Hjertefrekvensdata
{
"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): Oppsummering med min., gj.sn. og maks. hjertefrekvens under treningsøktenmaxHeartRate(Object): Maksimal hjertefrekvens under treningsøktenavgHeartRate(Object): Gjennomsnittlig hjertefrekvens under treningsøktenheartRateData(Array): Detaljerte målinger fra treningsøkten, som slutter når treningsøkten slutterheartRateRecovery(Array): Separate målinger fra de to minuttene umiddelbart etter at treningsøkten slutter
Oppsummerte hjertefrekvensverdier bruker registrerte treningsverdier når de finnes, og faller tilbake til treningsøktens hjertefrekvensmålinger. De eksporterte målingene inkluderer målinger tatt under pauser, så toppene og gjennomsnittene kan skille seg fra oppsummeringen.
Tidsserie-dataarrays
Mange mål kan inkluderes som tidsseriearrays når Inkluder treningsmål er aktivert:
{
"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): Mengdeverdiunits(String): Måleenhetsource(String, valgfritt): Datakildeenhet eller -app
HeartRateData-struktur:
date(Date): Tidsstempel for målingenMin(Number): Minimum hjertefrekvensAvg(Number): Gjennomsnittlig hjertefrekvensMax(Number): Maksimum hjertefrekvensunits(String): Enhet (count/minmed Lokaliser enheter av)source(String, valgfritt): Datakildeenhet eller -app
Rutedata
Når Inkluder rutedata er aktivert og treningsøkten 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
}
]
}
Stedsfelt:
latitude(Number): GPS-breddegradlongitude(Number): GPS-lengdegradaltitude(Number): Høyde i metercourse(Number): Retning i grader (0-360)courseAccuracy(Number): Nøyaktighet for kursmåling i graderhorizontalAccuracy(Number): Horisontal posisjonsnøyaktighet i meterverticalAccuracy(Number): Vertikal posisjonsnøyaktighet i metertimestamp(Date): Tid da stedet ble registrertspeed(Number): Hastighet i meter per sekundspeedAccuracy(Number): Nøyaktighet for hastighetsmåling i m/s
Metadata
{
"metadata": {
"customField": {
"label": "value",
"quantity": 123
},
"anotherField": [
1,
2,
3
]
}
}
metadata(Object): Ytterligere tilpasset metadata knyttet til treningsøkten
Hendelser, aktiviteter og splits
Versjon 2 JSON- og Markdown-eksporter kan inkludere events, segments, laps og activities registrert av treningsappen. Disse forblir tilgjengelige når Inkluder treningsmål er av. CSV og GPX inkluderer ikke disse postene.
Med Inkluder treningsmål på og relevante mål valgt kan intervaller også inkludere avstand, aktiv energi, hjertefrekvensoppsummeringer og pace eller hastighet for aktiv tid. Verdier skiller mellom registrerte målinger og estimater; utilgjengelige verdier utelates.
Med avstand valgt kan splits inkludere estimerte kilometer- og mil-splits. De kan skille seg fra opptaksappens splits, og den siste spliten markeres som delvis når den er kortere enn målavstanden. Manglende avstandsmålinger eller treningstyper som ikke støttes kan forhindre splitberegning.
Treningsinnsats-poeng
Versjon 2 JSON- og Markdown-eksporter kan inkludere valgte verdier for Treningsinnsats-poeng (effortScore) og Estimert treningsinnsats-poeng (estimatedEffortScore). Hver er et objekt med qty og units: "appleEffortScore".
Poeng krever iOS 18 eller senere og tilgang til tilsvarende data i Apple Health. Poeng for hele treningsøkten og aktiviteter er separate. De er uavhengige av Tidsgruppering og Inkluder treningsmål; CSV inkluderer dem ikke.
Under Bla gjennom → Treningsøkter åpner du listens eksportark eller en treningsøkts Versjon 2-eksportinnstillinger og bruker Velg eksportfelt for å velge innsatspoeng før eksport.
Tidsgruppering av treningsmål
Når du bruker eksportversjon 2 og Inkluder treningsmål er aktivert, kan du styre granulariteten for tidsseriedata:
- Minutter: Grupperer treningsmål etter klokkeminutter. Det første og siste minuttet kan inkludere noen sekunder like før treningsøkten starter eller like etter at den slutter.
- Sekunder: Grupperer treningsmål etter klokkesekunder, der hvert tidsstempel markerer starten av sitt sekund. Det første og siste sekundet kan inkludere brøkdelen av et sekund like utenfor treningsøkten. Filer blir større enn minuttgruppering.
Aktiv og hvilende energi bruker samme kombinerte totaler som andre treningsmål i hver tidsgruppe. Målinger fra mer enn én enhet eller app inkluderes sammen.
Treningsøkter Versjon 1 (eldre)
Versjon 1 bruker en enklere struktur. For nye eksporter anbefales Versjon 2.
Versjon 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"
}
]
}