Trainingen - JSON-exportformaat
Documentatie voor de trainingsstructuur in JSON-exporten
Laatst bijgewerkt: 31 oktober 2026
Op deze pagina
JSON-exporten slaan trainingen op in de array workouts.
Exportversies
Health Auto Export ondersteunt twee exportversies voor trainingen:
- Versie 2 (aanbevolen): Verbeterd formaat met gedetailleerdere metadata en gestructureerde gegevens
- Versie 1 (verouderd): Ouder formaat behouden voor compatibiliteit met bestaande workflows
Trainingen versie 2
Versie 2 omvat de volgende verplichte velden en optionele gegevens. Voorbeelden gebruiken Eenheden lokaliseren uit; inschakelen kan eenheidslabels in metriekreeksen wijzigen.
Basisstructuur
{
"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
}
Verplichte velden
id(String): Unieke identificatie van de trainingname(String): Naam van het trainingstype (bijv. "Running", "Cycling", "Swimming")start(Date): Starttijd van de training in de indelingyyyy-MM-dd HH:mm:ss Zend(Date): Eindtijd van de training in de indelingyyyy-MM-dd HH:mm:ss Zduration(Number): Trainingsduur in seconden
Optionele velden
Optionele velden hangen af van beschikbare gegevens en je exportselecties:
Opnamebron
{
"source": {
"name": "Workout App",
"identifier": "com.example.workouts"
}
}
source(Object): De app of het apparaat dat de training heeft vastgelegd, met naam en app-identificatie. Individuele metriekmetingen hebben aparte bronstrings en kunnen van een andere app of een ander apparaat komen.
Locatie-informatie
{
"location": "Outdoor",
"isIndoor": false
}
location(String): Een van"Indoor","Outdoor","Pool","Open Water"isIndoor(Boolean): Of de training indoor is uitgevoerd
Energie en intensiteit
{
"activeEnergyBurned": {
"qty": 350,
"units": "kcal"
},
"totalEnergy": {
"qty": 450,
"units": "kcal"
},
"intensity": {
"qty": 8.5,
"units": "kcal/hr\u00b7kg"
}
}
activeEnergyBurned(Object): Actieve calorieën verbrand tijdens de trainingtotalEnergy(Object): Totale calorieën (actief + rust) verbrandintensity(Object): Metabolisch equivalent van taak (MET)
Afstand en snelheid
{
"distance": {
"qty": 3.5,
"units": "mi"
}
}
distance(Object): Totale afgelegde afstandspeed(Object): Gemiddelde snelheid berekend uit afstand en duuravgSpeed(Object): Gemiddelde snelheid tijdens de trainingmaxSpeed(Object): Bereikte maximale snelheid
Elk object bevat qty en units.
Hoogte
{
"elevationUp": {
"qty": 500,
"units": "ft"
},
"elevationDown": {
"qty": 450,
"units": "ft"
}
}
elevationUp(Object): Totale hoogtetoenameelevationDown(Object): Totale hoogteafname
Eenheden: "ft" (voet) of "m" (meter)
Omgevingsgegevens
{
"temperature": {
"qty": 72,
"units": "degF"
},
"humidity": {
"qty": 65,
"units": "%"
}
}
temperature(Object): Omgevingstemperatuur tijdens de traininghumidity(Object): Relatieve luchtvochtigheid in procenten
Temperatuureenheden: "degF" (Fahrenheit) of "degC" (Celsius)
Zwemspecifieke velden
{
"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): Lengte van elke baanstrokeStyle(String): Een van:"Backstroke""Breaststroke""Butterfly""Freestyle""Mixed""Kickboard""Unknown"
swolfScore(Number): Zwemefficiëntiescoresalinity(String):"Fresh Water"of"Salt Water"totalSwimmingStrokeCount(Object): Totaal aantal slagenswimCadence(Object): Slagen per minuut
Stap- en cadansgegevens
{
"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 van stapentellingen in de tijdstepCadence(Object): Stappen per minuutflightsClimbed(Object): Aantal verdiepingen
Hartslaggegevens
{
"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): Samenvatting met min., gem. en max. hartslag tijdens de trainingmaxHeartRate(Object): Maximale hartslag tijdens de trainingavgHeartRate(Object): Gemiddelde hartslag tijdens de trainingheartRateData(Array): Gedetailleerde metingen uit de training, eindigend wanneer de training eindigtheartRateRecovery(Array): Aparte metingen uit de twee minuten direct na het einde van de training
Samenvattingshartslagen gebruiken vastgelegde trainingswaarden wanneer beschikbaar, anders de hartslagmetingen van de training. Geëxporteerde metingen bevatten metingen tijdens pauzes, zodat pieken en gemiddelden kunnen afwijken van de samenvatting.
Tijdreeks-data-arrays
Veel metrieken kunnen als tijdreeksarrays worden opgenomen wanneer Trainingsmetrieken opnemen is ingeschakeld:
{
"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-structuur:
date(Date): Tijdstempel van de metingqty(Number): Hoeveelheidswaardeunits(String): Meeteenheidsource(String, optioneel): Gegevensbronapparaat of -app
HeartRateData-structuur:
date(Date): Tijdstempel van de metingMin(Number): Minimale hartslagAvg(Number): Gemiddelde hartslagMax(Number): Maximale hartslagunits(String): Eenheid (count/minmet Eenheden lokaliseren uit)source(String, optioneel): Gegevensbronapparaat of -app
Routegegevens
Wanneer Routgegevens opnemen is ingeschakeld en de training GPS-gegevens heeft:
{
"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
}
]
}
Locatievelden:
latitude(Number): GPS-breedtegraadlongitude(Number): GPS-lengtegraadaltitude(Number): Hoogte in meterscourse(Number): Reisrichting in graden (0-360)courseAccuracy(Number): Nauwkeurigheid van de koersmeting in gradenhorizontalAccuracy(Number): Horizontale positienauwkeurigheid in metersverticalAccuracy(Number): Verticale positienauwkeurigheid in meterstimestamp(Date): Tijdstip waarop de locatie is vastgelegdspeed(Number): Snelheid in meters per secondespeedAccuracy(Number): Nauwkeurigheid van de snelheidsmeting in m/s
Metadata
{
"metadata": {
"customField": {
"label": "value",
"quantity": 123
},
"anotherField": [
1,
2,
3
]
}
}
metadata(Object): Extra aangepaste metadata bij de training
Gebeurtenissen, activiteiten en splits
JSON- en Markdown-exporten van versie 2 kunnen door de trainingsapp vastgelegde events, segments, laps en activities bevatten. Deze blijven beschikbaar wanneer Trainingsmetrieken opnemen uit staat. CSV en GPX bevatten deze records niet.
Met Trainingsmetrieken opnemen aan en relevante geselecteerde metrieken kunnen intervallen ook afstand, actieve energie, hartslagsamenvattingen en pace of snelheid van de actieve tijd bevatten. Waarden onderscheiden vastgelegde metingen van schattingen; niet-beschikbare waarden worden weggelaten.
Met geselecteerde afstand kan splits geschatte kilometer- en mijlsplits bevatten. Ze kunnen afwijken van de splits van de opname-app, en de laatste split wordt als gedeeltelijk gemarkeerd wanneer deze korter is dan de doelafstand. Ontbrekende afstandsmetingen of niet-ondersteunde trainingstypen kunnen splitberekening verhinderen.
Inspanningsscores van trainingen
JSON- en Markdown-exporten van Versie 2 kunnen geselecteerde Inspanningsscore van de training- (effortScore) en Geschatte inspanningsscore van de training-waarden (estimatedEffortScore) bevatten. Elke is een object met qty en units: "appleEffortScore".
Scores vereisen iOS 18 of nieuwer en toegang tot de bijbehorende gegevens in Apple Health. Scores van de hele training en van activiteiten zijn apart. Ze zijn onafhankelijk van Tijdgroepering en Trainingsmetrieken opnemen; CSV bevat ze niet.
Onder Bladeren → Trainingen open je het exportblad van de lijst of de Versie 2-exportinstellingen van een training, en gebruik je Exportvelden selecteren om inspanningsscores te kiezen vóór het exporteren.
Tijdgroepering trainingsmetrieken
Bij exportversie 2 en ingeschakeld Trainingsmetrieken opnemen kun je de granulariteit van tijdreeksgegevens sturen:
- Minuten: Groepeert trainingsmetrieken op klokminuten. De eerste en laatste minuut kunnen enkele seconden net vóór de start of net na het einde van de training bevatten.
- Seconden: Groepeert trainingsmetrieken op klokseconden, waarbij elke tijdstempel het begin van die seconde markeert. De eerste en laatste seconde kunnen de fractie van een seconde net buiten de training bevatten. Bestanden zijn groter dan bij minutengroepering.
Actieve en rustenergie gebruiken dezelfde gecombineerde totalen als andere trainingsmetrieken in elke tijdgroep. Metingen van meer dan één apparaat of app worden samen opgenomen.
Trainingen versie 1 (verouderd)
Versie 1 gebruikt een eenvoudigere structuur. Voor nieuwe exporten wordt Versie 2 aanbevolen.
Versie 1-structuur
{
"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"
}
]
}