Träningar - JSON Exportformat

Dokumentation om träningsstrukturen i JSON-exporter

Last updated: February 6, 2026

On this page

Exportversioner
Träningar Version 2
Grundstruktur
Obligatoriska Fält
Valfria Fält
Träningar Version 1 (Legacy)
Version 1 Struktur
Tidsgruppering av Träningsmätvärden
Tips
Relaterad Dokumentation

Träningar

Träningsdata inkluderar alla dina träningspass som registrerats i Apple Health, såsom löpning, cykling, simning, styrketräning och mer. I JSON-exporter lagras träningar i arrayen workouts.

Exportversioner

Health Auto Export stödjer två träningsexportversioner:

Version 2 (Rekommenderad): Förbättrat format med mer detaljerade metadata och strukturerad data
Version 1 (Legacy): Äldre format som behålls för kompatibilitet med befintliga arbetsflöden

Träningar Version 2

Version 2 ger en omfattande struktur med valfria fält som endast inkluderas när data är tillgänglig.

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äningen
name (String): Namn på träningstyp (t.ex. "Running", "Cycling", "Swimming")
start (Date): Träningens starttid i formatet yyyy-MM-dd HH:mm:ss Z
end (Date): Träningens sluttid i formatet yyyy-MM-dd HH:mm:ss Z
duration (Number): Träningens varaktighet i sekunder

Valfria Fält

Följande fält inkluderas endast när data är tillgänglig:

Platsinformation

{
  "location": "Outdoor",
  "isIndoor": false
}

location (String): En av "Indoor", "Outdoor", "Pool", "Open Water"
isIndoor (Boolean): Om träningen utfördes inomhus

Energi och Intensitet

{
  "activeEnergyBurned": {
    "qty": 350,
    "units": "kcal"
  },
  "totalEnergy": {
    "qty": 450,
    "units": "kcal"
  },
  "intensity": {
    "qty": 8.5,
    "units": "MET"
  }
}

activeEnergyBurned (Object): Aktiva kalorier förbrända under träningen
totalEnergy (Object): Totalt antal kalorier (aktiva + vila) förbrända
intensity (Object): Metabolisk ekvivalent av uppgiften (MET)-värde

Distans och Hastighet

{
  "distance": {
    "qty": 3.5,
    "units": "mi"
  },
  "speed": {
    "qty": 7.0,
    "units": "mph"
  },
  "avgSpeed": {
    "qty": 7.0,
    "units": "mph"
  },
  "maxSpeed": {
    "qty": 8.5,
    "units": "mph"
  }
}

distance (Object): Total tillryggalagd distans
speed (Object): Nuvarande eller genomsnittlig hastighet
avgSpeed (Object): Genomsnittlig hastighet under hela träningen
maxSpeed (Object): Maximal hastighet uppnådd

Enheter:

Distans: "mi" (miles) eller "km" (kilometer)
Hastighet: "mph" (miles per timme) eller "kmph" (kilometer per timme)

Höjd

{
  "elevationUp": {
    "qty": 500,
    "units": "ft"
  },
  "elevationDown": {
    "qty": 450,
    "units": "ft"
  }
}

elevationUp (Object): Total höjdvinst
elevationDown (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äningen
humidity (Object): Relativ luftfuktighet i procent

Temperaturenheter: "degF" (Fahrenheit) eller "degC" (Celsius)

Simspecifika Fält

{
  "lapLength": {
    "qty": 0.025,
    "units": "mi"
  },
  "strokeStyle": "Freestyle",
  "swolfScore": 45,
  "salinity": "Fresh Water",
  "totalSwimmingStrokeCount": {
    "qty": 1200,
    "units": "count"
  },
  "swimCadence": {
    "qty": 30,
    "units": "spm"
  }
}

lapLength (Object): Längd på varje bana
strokeStyle (String): En av:
- "Backstroke"
- "Breaststroke"
- "Butterfly"
- "Freestyle"
- "Mixed"
- "Kickboard"
- "Unknown"
swolfScore (Number): Simeffektivitetspoäng
salinity (String): "Fresh Water" eller "Salt Water"
totalSwimmingStrokeCount (Object): Totalt antal simtag
swimCadence (Object): Simtag 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": "spm"
  },
  "flightsClimbed": {
    "qty": 10,
    "units": "count"
  }
}

stepCount (Array): Array av stegräkningsmätningar över tid
stepCadence (Object): Steg per minut
flightsClimbed (Object): Antal trappor klättrade

Pulssdata

{
  "heartRate": {
    "min": {
      "qty": 120,
      "units": "bpm"
    },
    "avg": {
      "qty": 150,
      "units": "bpm"
    },
    "max": {
      "qty": 175,
      "units": "bpm"
    }
  },
  "maxHeartRate": {
    "qty": 175,
    "units": "bpm"
  },
  "avgHeartRate": {
    "qty": 150,
    "units": "bpm"
  },
  "heartRateData": [
    {
      "date": "2024-02-06 07:00:00 -0800",
      "Min": 120,
      "Avg": 150,
      "Max": 175,
      "units": "bpm",
      "source": "Apple Watch"
    }
  ],
  "heartRateRecovery": [
    {
      "date": "2024-02-06 07:30:00 -0800",
      "Min": 140,
      "Avg": 145,
      "Max": 150,
      "units": "bpm",
      "source": "Apple Watch"
    }
  ]
}

heartRate (Object): Sammanfattning med min, genomsnitt och max puls
maxHeartRate (Object): Maximal puls under träningen
avgHeartRate (Object): Genomsnittlig puls under träningen
heartRateData (Array): Detaljerade pulsmätningar under hela träningen
heartRateRecovery (Array): Pulsmätningar under återhämtningsperioden

Tidssekvensdataarrays

Många mätvärden kan inkluderas som tidssekvensarrays när "Inkludera Träningsmätvärden" ä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": "rpm",
      "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": "mph",
      "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ätningen
qty (Number): Kvantitetsvärde
units (String): Mätenhet
source (String, valfritt): Datakällanhet eller app

HeartRateData-struktur:

date (Date): Tidsstämpel för mätningen
Min (Number): Minimal puls
Avg (Number): Genomsnittlig puls
Max (Number): Maximal puls
units (String): Enhet (vanligtvis "bpm")
source (String, valfritt): Datakällanhet eller app

Rutdata

När "Inkludera Rutdata" är aktiverat och 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
    }
  ]
}

Platsfält:

latitude (Number): GPS-breddgradskoordinat
longitude (Number): GPS-längdgradskoordinat
altitude (Number): Höjd i meter
course (Number): Reseriktning i grader (0-360)
courseAccuracy (Number): Noggrannhet för kursmätning i grader
horizontalAccuracy (Number): Horisontell positionsnoggrannhet i meter
verticalAccuracy (Number): Vertikal positionsnoggrannhet i meter
timestamp (Date): Tidpunkt när platsen registrerades
speed (Number): Hastighet i meter per sekund
speedAccuracy (Number): Noggrannhet för hastighetsmätning i m/s

Metadata

{
  "metadata": {
    "customField": "value",
    "anotherField": 123
  }
}

metadata (Object): Ytterligare anpassade metadata associerade med träningen

Träningar Version 1 (Legacy)

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": "count"
    }
  ],
  "route": [
    {
      "lat": 37.7749,
      "lon": -122.4194,
      "altitude": 50.5,
      "timestamp": "2024-02-06 07:00:00 -0800"
    }
  ]
}

Tidsgruppering av Träningsmätvärden

Vid användning av Exportversion 2 och när "Inkludera Träningsmätvärden" är aktiverat kan du styra granulariteten för tidssekvensdata:

Minuter: Grupperar träningsmätvärden efter minutintervaller
Sekunder: Grupperar träningsmätvärden efter sekundintervaller (mer detaljerat, större filstorlek)

Tips

Inkludera Rutdata: Aktivera denna inställning för att få GPS-rutinformation för utomhusträningar
Inkludera Träningsmätvärden: Aktivera detta för att få detaljerade tidssekvensdata för mätvärden som puls, effekt och kadens
Exportversion: Använd Version 2 för den mest omfattande datastrukturen
GPX-export: Rutdata kan också exporteras som separata GPX-filer för användning i kartapplikationer