Helpcentrum HealthyApps
Nederlands
Helpcentrum
Hoofdwebsite ↗

Zoek in helponderwerpen

Trainingen - JSON-exportformaat

Documentatie voor de trainingsstructuur in JSON-exporten

Laatst bijgewerkt: 31 oktober 2026

Op deze pagina
Exportversies
Trainingen versie 2 Trainingen versie 2 BasisstructuurVerplichte veldenOptionele veldenTijdgroepering trainingsmetrieken
Trainingen versie 1 (verouderd) Trainingen versie 1 (verouderd) Versie 1-structuur
Gerelateerde documentatie

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 training
  • name (String): Naam van het trainingstype (bijv. "Running", "Cycling", "Swimming")
  • start (Date): Starttijd van de training in de indeling yyyy-MM-dd HH:mm:ss Z
  • end (Date): Eindtijd van de training in de indeling yyyy-MM-dd HH:mm:ss Z
  • duration (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 training
  • totalEnergy (Object): Totale calorieën (actief + rust) verbrand
  • intensity (Object): Metabolisch equivalent van taak (MET)

Afstand en snelheid

{
  "distance": {
    "qty": 3.5,
    "units": "mi"
  }
}
  • distance (Object): Totale afgelegde afstand
  • speed (Object): Gemiddelde snelheid berekend uit afstand en duur
  • avgSpeed (Object): Gemiddelde snelheid tijdens de training
  • maxSpeed (Object): Bereikte maximale snelheid

Elk object bevat qty en units.

Hoogte

{
  "elevationUp": {
    "qty": 500,
    "units": "ft"
  },
  "elevationDown": {
    "qty": 450,
    "units": "ft"
  }
}
  • elevationUp (Object): Totale hoogtetoename
  • elevationDown (Object): Totale hoogteafname

Eenheden: "ft" (voet) of "m" (meter)

Omgevingsgegevens

{
  "temperature": {
    "qty": 72,
    "units": "degF"
  },
  "humidity": {
    "qty": 65,
    "units": "%"
  }
}
  • temperature (Object): Omgevingstemperatuur tijdens de training
  • humidity (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 baan
  • strokeStyle (String): Een van:
    • "Backstroke"
    • "Breaststroke"
    • "Butterfly"
    • "Freestyle"
    • "Mixed"
    • "Kickboard"
    • "Unknown"
  • swolfScore (Number): Zwemefficiëntiescore
  • salinity (String): "Fresh Water" of "Salt Water"
  • totalSwimmingStrokeCount (Object): Totaal aantal slagen
  • swimCadence (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 tijd
  • stepCadence (Object): Stappen per minuut
  • flightsClimbed (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 training
  • maxHeartRate (Object): Maximale hartslag tijdens de training
  • avgHeartRate (Object): Gemiddelde hartslag tijdens de training
  • heartRateData (Array): Gedetailleerde metingen uit de training, eindigend wanneer de training eindigt
  • heartRateRecovery (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 meting
  • qty (Number): Hoeveelheidswaarde
  • units (String): Meeteenheid
  • source (String, optioneel): Gegevensbronapparaat of -app

HeartRateData-structuur:

  • date (Date): Tijdstempel van de meting
  • Min (Number): Minimale hartslag
  • Avg (Number): Gemiddelde hartslag
  • Max (Number): Maximale hartslag
  • units (String): Eenheid (count/min met 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-breedtegraad
  • longitude (Number): GPS-lengtegraad
  • altitude (Number): Hoogte in meters
  • course (Number): Reisrichting in graden (0-360)
  • courseAccuracy (Number): Nauwkeurigheid van de koersmeting in graden
  • horizontalAccuracy (Number): Horizontale positienauwkeurigheid in meters
  • verticalAccuracy (Number): Verticale positienauwkeurigheid in meters
  • timestamp (Date): Tijdstip waarop de locatie is vastgelegd
  • speed (Number): Snelheid in meters per seconde
  • speedAccuracy (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"
    }
  ]
}

Gerelateerde documentatie