Hjälpcenter HealthyApps
Svenska
Hjälpcenter
Huvudwebbplats ↗

Sök bland hjälpämnen

Träningspass - JSON-exportformat

Dokumentation för träningsstruktur i JSON-exporter

Senast uppdaterad: 31 oktober 2026

På denna sida
Exportversioner
Träningspass Version 2 Träningspass Version 2 GrundstrukturObligatoriska fältValfria fältTidsgruppering av träningsmått
Träningspass Version 1 (äldre) Träningspass Version 1 (äldre) Version 1-struktur
Relaterad dokumentation

JSON-exporter lagrar träningspass i arrayet workouts.

Exportversioner

Health Auto Export stöder två exportversioner för träningspass:

  • Version 2 (rekommenderas): Förbättrat format med mer detaljerad metadata och strukturerade data
  • Version 1 (äldre): Äldre format som behålls för kompatibilitet med befintliga arbetsflöden

Träningspass Version 2

Version 2 inkluderar följande obligatoriska fält och valfria data. Exemplen använder Lokalisera enheter av; aktivering kan ändra enhetsetiketter i måttserier.

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äningspasset
  • name (String): Namn på träningstyp (t.ex. "Running", "Cycling", "Swimming")
  • start (Date): Starttid för träningspasset i formatet yyyy-MM-dd HH:mm:ss Z
  • end (Date): Sluttid för träningspasset i formatet yyyy-MM-dd HH:mm:ss Z
  • duration (Number): Längd för träningspasset i sekunder

Valfria fält

Valfria fält beror på tillgängliga data och dina exportval:

Inspelningskälla

{
  "source": {
    "name": "Workout App",
    "identifier": "com.example.workouts"
  }
}
  • source (Object): Appen eller enheten som registrerade träningspasset, med namn och appidentifierare. Individuella måttvärden har separata källsträngar och kan komma från en annan app eller enhet.

Platsinformation

{
  "location": "Outdoor",
  "isIndoor": false
}
  • location (String): Ett av "Indoor", "Outdoor", "Pool", "Open Water"
  • isIndoor (Boolean): Om träningspasset utfördes inomhus

Energi och intensitet

{
  "activeEnergyBurned": {
    "qty": 350,
    "units": "kcal"
  },
  "totalEnergy": {
    "qty": 450,
    "units": "kcal"
  },
  "intensity": {
    "qty": 8.5,
    "units": "kcal/hr\u00b7kg"
  }
}
  • activeEnergyBurned (Object): Aktiva kalorier förbrända under träningspasset
  • totalEnergy (Object): Totala kalorier (aktiva + vila) förbrända
  • intensity (Object): Metabolisk ekvivalent av uppgift (MET)

Avstånd och hastighet

{
  "distance": {
    "qty": 3.5,
    "units": "mi"
  }
}
  • distance (Object): Totalt tillryggalagt avstånd
  • speed (Object): Medelhastighet beräknad från avstånd och längd
  • avgSpeed (Object): Medelhastighet under träningspasset
  • maxSpeed (Object): Maximal uppnådd hastighet

Varje objekt inkluderar qty och units.

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äningspasset
  • humidity (Object): Relativ luftfuktighet i procent

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

Simningsspecifika fält

{
  "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): Längd på varje varv
  • strokeStyle (String): Ett av:
    • "Backstroke"
    • "Breaststroke"
    • "Butterfly"
    • "Freestyle"
    • "Mixed"
    • "Kickboard"
    • "Unknown"
  • swolfScore (Number): Simeffektivitetspoäng
  • salinity (String): "Fresh Water" eller "Salt Water"
  • totalSwimmingStrokeCount (Object): Totalt antal tag
  • swimCadence (Object): Tag 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": "count/min"
  },
  "flightsClimbed": {
    "qty": 10,
    "units": "count"
  }
}
  • stepCount (Array): Array med stegräkningar över tid
  • stepCadence (Object): Steg per minut
  • flightsClimbed (Object): Antal våningar gångna upp

Hjärtfrekvensdata

{
  "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): Summering med min., med. och max. hjärtfrekvens under träningspasset
  • maxHeartRate (Object): Maximal hjärtfrekvens under träningspasset
  • avgHeartRate (Object): Genomsnittlig hjärtfrekvens under träningspasset
  • heartRateData (Array): Detaljerade mätningar från träningspasset, som slutar när träningspasset slutar
  • heartRateRecovery (Array): Separata mätningar från de två minuterna omedelbart efter att träningspasset slutar

Summerade hjärtfrekvensvärden använder registrerade träningsvärden när de finns, och faller tillbaka till träningspassets hjärtfrekvensmätningar. De exporterade mätningarna inkluderar mätningar tagna under pauser, så deras toppar och genomsnitt kan skilja sig från summeringen.

Tidsserie-dataarrayer

Många mått kan inkluderas som tidsseriearrayer när Inkludera träningsmått ä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": "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-struktur:

  • date (Date): Tidsstämpel för mätningen
  • qty (Number): Mängdvärde
  • units (String): Måttenhet
  • source (String, valfritt): Datakällenhet eller -app

HeartRateData-struktur:

  • date (Date): Tidsstämpel för mätningen
  • Min (Number): Minimihjärtfrekvens
  • Avg (Number): Genomsnittlig hjärtfrekvens
  • Max (Number): Maximihjärtfrekvens
  • units (String): Enhet (count/min med Lokalisera enheter av)
  • source (String, valfritt): Datakällenhet eller -app

Ruttdata

När Inkludera ruttdata är aktiverat och träningspasset 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-latitud
  • longitude (Number): GPS-longitud
  • altitude (Number): Höjd i meter
  • course (Number): Färdriktning 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): Tid när platsen registrerades
  • speed (Number): Hastighet i meter per sekund
  • speedAccuracy (Number): Noggrannhet för hastighetsmätning i m/s

Metadata

{
  "metadata": {
    "customField": {
      "label": "value",
      "quantity": 123
    },
    "anotherField": [
      1,
      2,
      3
    ]
  }
}
  • metadata (Object): Ytterligare anpassad metadata kopplad till träningspasset

Händelser, aktiviteter och splits

Version 2 JSON- och Markdown-exporter kan inkludera events, segments, laps och activities som registrerats av träningsappen. Dessa förblir tillgängliga när Inkludera träningsmått är avstängt. CSV och GPX inkluderar inte dessa poster.

Med Inkludera träningsmått på och relevanta mått valda kan intervall också inkludera avstånd, aktiv energi, hjärtfrekvenssummeringar och pace eller hastighet för aktiv tid. Värden skiljer mellan registrerade mätningar och uppskattningar; otillgängliga värden utelämnas.

Med avstånd valt kan splits inkludera uppskattade kilometer- och mil-splits. De kan skilja sig från inspelningsappens splits, och den sista spliten markeras som delvis när den är kortare än målsträckan. Saknade avståndsmätningar eller träningspass som inte stöds kan förhindra splitberäkning.

Träningsinsatspoäng

Version 2 JSON- och Markdown-exporter kan inkludera valda värden för Träningsinsatspoäng (effortScore) och Uppskattad träningsinsatspoäng (estimatedEffortScore). Varje är ett objekt med qty och units: "appleEffortScore".

Poäng kräver iOS 18 eller senare och åtkomst till motsvarande data i Apple Health. Poäng för hela träningspasset och aktiviteter är separata. De är oberoende av Tidsgruppering och Inkludera träningsmått; CSV inkluderar dem inte.

Under Bläddra → Träningspass öppnar du listans exportblad eller ett träningspass Version 2-exportinställningar och använder Välj exportfält för att välja insatspoäng före export.

Tidsgruppering av träningsmått

När du använder exportversion 2 och Inkludera träningsmått är aktiverat kan du styra granulariteten för tidsseriedata:

  • Minuter: Grupperar träningsmått efter klockminuter. Den första och sista minuten kan inkludera några sekunder precis före träningspasset startar eller precis efter att det slutar.
  • Sekunder: Grupperar träningsmått efter klocksekunder, där varje tidsstämpel markerar början av sin sekund. Den första och sista sekunden kan inkludera bråkdelen av en sekund precis utanför träningspasset. Filer blir större än minutgruppering.

Aktiv och vilande energi använder samma kombinerade totaler som andra träningsmått i varje tidsgrupp. Mätningar från mer än en enhet eller app inkluderas tillsammans.

Träningspass Version 1 (äldre)

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

Relaterad dokumentation