Tréningy – formát exportu JSON

Dokumentácia štruktúry tréningov v JSON exportoch

Last updated: April 5, 2026

Na tejto stránke

Verzie exportu
Tréningy verzia 2
Základná štruktúra
Required Fields
Optional Fields
Tréningy verzia 1 (legacy)
Version 1 Structure
Časová agregácia metrík tréningu
Tipy
Súvisiaca dokumentácia

Tréningy

Údaje o tréningoch zahŕňajú všetky cvičenia zaznamenané v Apple Health (beh, cyklistika, plávanie, silový tréning atď.). V JSON exportoch sú v poli workouts.

Verzie exportu

Health Auto Export podporuje dve verzie exportu tréningov:

Verzia 2 (odporúčaná): Rozšírený formát s podrobnejšími metadátami a štruktúrovanými údajmi
Verzia 1 (legacy): Starší formát kvôli kompatibilite so existujúcimi postupmi

Tréningy verzia 2

Verzia 2 poskytuje rozsiahlu štruktúru voliteľných polí; polia sa zahrnú len ak sú údaje k dispozícii.

Základná štruktúra

{
  "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
}

Required Fields

id (String): Unique identifier for the workout
name (String): Workout type name (e.g., "Running", "Cycling", "Swimming")
start (Date): Workout start time in format yyyy-MM-dd HH:mm:ss Z
end (Date): Workout end time in format yyyy-MM-dd HH:mm:ss Z
duration (Number): Workout duration in seconds

Optional Fields

Nasledujúce polia sa zahrnú len ak sú údaje k dispozícii:

Location Information

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

location (String): One of "Indoor", "Outdoor", "Pool", "Open Water"
isIndoor (Boolean): Whether the workout was performed indoors

Energy and Intensity

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

activeEnergyBurned (Object): Active calories burned during the workout
totalEnergy (Object): Total calories (active + resting) burned
intensity (Object): Metabolic equivalent of task (MET) value

Distance and Speed

{
  "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 distance covered
speed (Object): Current or average speed
avgSpeed (Object): Average speed throughout the workout
maxSpeed (Object): Maximum speed reached

Units:

Distance: "mi" (miles) or "km" (kilometers)
Speed: "mph" (miles per hour) or "kmph" (kilometers per hour)

Elevation

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

elevationUp (Object): Total elevation gained
elevationDown (Object): Total elevation lost

Units: "ft" (feet) or "m" (meters)

Environmental Data

{
  "temperature": {
    "qty": 72,
    "units": "degF"
  },
  "humidity": {
    "qty": 65,
    "units": "%"
  }
}

temperature (Object): Ambient temperature during workout
humidity (Object): Relative humidity percentage

Temperature Units: "degF" (Fahrenheit) or "degC" (Celsius)

Swimming-Specific Fields

{
  "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): Length of each lap
strokeStyle (String): One of:
- "Backstroke"
- "Breaststroke"
- "Butterfly"
- "Freestyle"
- "Mixed"
- "Kickboard"
- "Unknown"
swolfScore (Number): Swimming efficiency score
salinity (String): "Fresh Water" or "Salt Water"
totalSwimmingStrokeCount (Object): Total number of strokes
swimCadence (Object): Strokes per minute

Step and Cadence Data

{
  "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 of step count measurements over time
stepCadence (Object): Steps per minute
flightsClimbed (Object): Number of flights of stairs climbed

Heart Rate Data

{
  "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): Summary with min, avg, and max heart rate
maxHeartRate (Object): Maximum heart rate during workout
avgHeartRate (Object): Average heart rate during workout
heartRateData (Array): Detailed heart rate measurements throughout the workout
heartRateRecovery (Array): Heart rate measurements during recovery period

Time-Series Data Arrays

Many metrics can be included as time-series arrays when "Include Workout Metrics" is enabled:

{
  "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 Structure:

date (Date): Timestamp of the measurement
qty (Number): Quantity value
units (String): Unit of measurement
source (String, optional): Data source device or app

HeartRateData Structure:

date (Date): Timestamp of the measurement
Min (Number): Minimum heart rate
Avg (Number): Average heart rate
Max (Number): Maximum heart rate
units (String): Unit (typically "bpm")
source (String, optional): Data source device or app

Route Data

Keď je zapnuté „Zahrnúť údaje o trase“ a tréning má GPS údaje:

{
  "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
    }
  ]
}

Location Fields:

latitude (Number): GPS latitude coordinate
longitude (Number): GPS longitude coordinate
altitude (Number): Elevation in meters
course (Number): Direction of travel in degrees (0-360)
courseAccuracy (Number): Accuracy of course measurement in degrees
horizontalAccuracy (Number): Horizontal position accuracy in meters
verticalAccuracy (Number): Vertical position accuracy in meters
timestamp (Date): Time when location was recorded
speed (Number): Speed in meters per second
speedAccuracy (Number): Accuracy of speed measurement in m/s

Metadata

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

metadata (Object): Additional custom metadata associated with the workout

Tréningy verzia 1 (legacy)

Version 1 uses a simpler structure. For new exports, Version 2 is recommended.

Version 1 Structure

{
  "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"
    }
  ]
}

Časová agregácia metrík tréningu

Pri exportnej verzii 2 a zapnutom „Zahrnúť metriky tréningu“ môžete nastaviť granularitu časových radov:

Minutes: Groups workout metrics by minute intervals
Seconds: Groups workout metrics by second intervals (more detailed, larger file size)

Tipy

Include Route Data: Enable this option to get GPS route information for outdoor workouts
Include Workout Metrics: Enable this to get detailed time-series data for metrics like heart rate, power, and cadence
Export Version: Use Version 2 for the most comprehensive data structure
GPX Export: Route data can also be exported as separate GPX files for use in mapping applications