Edzések – JSON export formátum

Az edzésadatok szerkezete a JSON exportokban

Last updated: April 5, 2026

Ezen az oldalon

Export verziók
Edzések – 2. verzió
Alapvető szerkezet
Kötelező mezők
Opcionális mezők
Edzések – 1. verzió (régi)
1. verzió szerkezete
Edzésmetrikák időbeli csoportosítása
Tippek
Kapcsolódó dokumentáció

Edzések

Az edzésadatok az Apple Egészségben rögzített összes mozgásedzést tartalmazzák – például futás, kerékpár, úszás, erősítés és egyebek. A JSON exportokban az edzések a workouts tömbben szerepelnek.

Export verziók

A Health Auto Export két edzés-export verziót támogat:

2. verzió (ajánlott): bővített formátum részletesebb metaadatokkal és strukturált adatokkal
1. verzió (régi): korábbi formátum, a meglévő munkafolyamatokkal való kompatibilitás miatt megőrizve

Edzések – 2. verzió

A 2. verzió átfogó szerkezetet ad, opcionális mezőkkel, amelyek csak akkor szerepelnek, ha az adat elérhető.

Alapvető szerkezet

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

Kötelező mezők

id (String): Az edzés egyedi azonosítója
name (String): Az edzés típusának neve (pl. „Running”, „Cycling”, „Swimming”)
start (Date): Az edzés kezdete yyyy-MM-dd HH:mm:ss Z formátumban
end (Date): Az edzés vége yyyy-MM-dd HH:mm:ss Z formátumban
duration (Number): Az edzés időtartama másodpercben

Opcionális mezők

Az alábbi mezők csak akkor szerepelnek, ha az adat elérhető:

Helyinformáció

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

location (String): Az alábbiak egyike: "Indoor", "Outdoor", "Pool", "Open Water"
isIndoor (Boolean): Az edzés beltérben történt-e

Energia és intenzitás

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

activeEnergyBurned (Object): Az edzés alatt elégetett aktív kalóriák
totalEnergy (Object): Összes kalória (aktív + nyugalmi) elégetve
intensity (Object): Anyagcsere-egyenérték (MET) érték

Távolság és sebesség

{
  "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): Megtett teljes távolság
speed (Object): Aktuális vagy átlagos sebesség
avgSpeed (Object): Átlagos sebesség az egész edzés alatt
maxSpeed (Object): Elért maximális sebesség

Mértékegységek:

Távolság: "mi" (mérföld) vagy "km" (kilométer)
Sebesség: "mph" (mérföld/óra) vagy "kmph" (km/óra)

Szintkülönbség

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

elevationUp (Object): Összes szintemelkedés
elevationDown (Object): Összes süllyedés

Mértékegységek: "ft" (láb) vagy "m" (méter)

Környezeti adatok

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

temperature (Object): Környezeti hőmérséklet az edzés alatt
humidity (Object): Relatív páratartalom százalékban

Hőmérséklet mértékegységei: "degF" (Fahrenheit) vagy "degC" (Celsius)

Úszás-specifikus mezők

{
  "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): Egy hossz hossza
strokeStyle (String): Az alábbiak egyike:
- "Backstroke"
- "Breaststroke"
- "Butterfly"
- "Freestyle"
- "Mixed"
- "Kickboard"
- "Unknown"
swolfScore (Number): Úszáshatékonysági pontszám
salinity (String): "Fresh Water" vagy "Salt Water"
totalSwimmingStrokeCount (Object): Összes úszóütés száma
swimCadence (Object): Ütés percenként

Lépés- és ritmusadatok

{
  "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): Lépésszám-mérések időbeli sorozata
stepCadence (Object): Lépés percenként
flightsClimbed (Object): Megmászott emeletek száma

Pulzusadatok

{
  "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): Összegzés minimum, átlag és maximum pulzussal
maxHeartRate (Object): Maximális pulzus az edzés alatt
avgHeartRate (Object): Átlagos pulzus az edzés alatt
heartRateData (Array): Részletes pulzusmérések az edzés során
heartRateRecovery (Array): Pulzusmérések a regenerációs időszakban

Idősoros adattömbök

Sok metrika idősorként is szerepelhet, ha be van kapcsolva az „Include Workout Metrics”:

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

date (Date): A mérés időbélyege
qty (Number): Mennyiségi érték
units (String): Mértékegység
source (String, opcionális): Adatforrás eszköz vagy alkalmazás

HeartRateData szerkezet:

date (Date): A mérés időbélyege
Min (Number): Minimum pulzus
Avg (Number): Átlagos pulzus
Max (Number): Maximum pulzus
units (String): Mértékegység (általában "bpm")
source (String, opcionális): Adatforrás eszköz vagy alkalmazás

Útvonaladatok

Ha be van kapcsolva az „Include Route Data”, és az edzéshez tartozik GPS-adat:

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

Helymezők:

latitude (Number): GPS szélesség
longitude (Number): GPS hosszúság
altitude (Number): Magasság méterben
course (Number): Haladási irány fokban (0–360)
courseAccuracy (Number): Az iránymérés pontossága fokban
horizontalAccuracy (Number): Vízszintes pozíció pontossága méterben
verticalAccuracy (Number): Függőleges pozíció pontossága méterben
timestamp (Date): A hely rögzítésének időpontja
speed (Number): Sebesség méter/másodpercben
speedAccuracy (Number): A sebességmérés pontossága m/s-ban

Metaadatok

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

metadata (Object): További egyéni metaadatok az edzéshez

Edzések – 1. verzió (régi)

Az 1. verzió egyszerűbb szerkezetet használ. Új exportokhoz a 2. verzió ajánlott.

1. verzió szerkezete

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

Edzésmetrikák időbeli csoportosítása

A 2. export verzió és az „Include Workout Metrics” bekapcsolásakor szabályozható az idősoros adatok részletessége:

Perc: az edzésmetrikák percenkénti intervallumok szerint csoportosítva
Másodperc: másodpercenkénti intervallumok (részletesebb, nagyobb fájlméret)

Tippek

Include Route Data: Kapcsold be ezt a lehetőséget, ha kültéri edzésekhez GPS-útvonalat szeretnél
Include Workout Metrics: Kapcsold be a részletes idősoros adatokhoz (pulzus, teljesítmény, ritmus stb.)
Export Version: A 2. verzió adja a legteljesebb adatszerkezetet
GPX export: Az útvonaladat külön GPX fájlként is exportálható térképező alkalmazásokhoz