Hjælpecenter HealthyApps
Dansk
Hjælpecenter
Hovedwebsted ↗

Søg i hjælpeemner

Træninger - JSON-eksportformat

Dokumentation for træningsstruktur i JSON-eksporter

Senest opdateret: 31. oktober 2026

På denne side
Eksportversioner
Træninger Version 2 Træninger Version 2 GrundstrukturPåkrævede felterValgfrie felterTidsgruppering for træningsmålinger
Træninger Version 1 (ældre) Træninger Version 1 (ældre) Version 1-struktur
Relateret dokumentation

JSON-eksporter gemmer træninger i arrayet workouts.

Eksportversioner

Health Auto Export understøtter to eksportversioner for træninger:

  • Version 2 (anbefalet): Forbedret format med mere detaljerede metadata og strukturerede data
  • Version 1 (ældre): Ældre format bevaret for kompatibilitet med eksisterende arbejdsgange

Træninger Version 2

Version 2 inkluderer følgende påkrævede felter og valgfrie data. Eksempler bruger Lokaliser enheder fra; aktivering kan ændre enhedsetiketter i målingsserier.

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
}

Påkrævede felter

  • id (String): Unik identifikator for træningen
  • name (String): Navn på træningstype (f.eks. "Running", "Cycling", "Swimming")
  • start (Date): Træningens starttidspunkt i formatet yyyy-MM-dd HH:mm:ss Z
  • end (Date): Træningens sluttidspunkt i formatet yyyy-MM-dd HH:mm:ss Z
  • duration (Number): Træningens varighed i sekunder

Valgfrie felter

Valgfrie felter afhænger af tilgængelige data og dine eksportvalg:

Optagelseskilde

{
  "source": {
    "name": "Workout App",
    "identifier": "com.example.workouts"
  }
}
  • source (Object): Appen eller enheden, der registrerede træningen, med navn og app-identifikator. Individuelle målingsværdier har separate kildestrenge og kan komme fra en anden app eller enhed.

Placeringsoplysninger

{
  "location": "Outdoor",
  "isIndoor": false
}
  • location (String): En af "Indoor", "Outdoor", "Pool", "Open Water"
  • isIndoor (Boolean): Om træningen blev udført indendørs

Energi og intensitet

{
  "activeEnergyBurned": {
    "qty": 350,
    "units": "kcal"
  },
  "totalEnergy": {
    "qty": 450,
    "units": "kcal"
  },
  "intensity": {
    "qty": 8.5,
    "units": "kcal/hr\u00b7kg"
  }
}
  • activeEnergyBurned (Object): Aktive kalorier forbrændt under træningen
  • totalEnergy (Object): Samlede kalorier (aktive + hvile) forbrændt
  • intensity (Object): Metabolisk ækvivalent af opgave (MET)

Afstand og hastighed

{
  "distance": {
    "qty": 3.5,
    "units": "mi"
  }
}
  • distance (Object): Samlet tilbagelagt afstand
  • speed (Object): Gennemsnitshastighed beregnet ud fra afstand og varighed
  • avgSpeed (Object): Gennemsnitshastighed under træningen
  • maxSpeed (Object): Maksimal nået hastighed

Hvert objekt inkluderer qty og units.

Højde

{
  "elevationUp": {
    "qty": 500,
    "units": "ft"
  },
  "elevationDown": {
    "qty": 450,
    "units": "ft"
  }
}
  • elevationUp (Object): Samlet højdeforøgelse
  • elevationDown (Object): Samlet højdetab

Enheder: "ft" (fod) eller "m" (meter)

Miljødata

{
  "temperature": {
    "qty": 72,
    "units": "degF"
  },
  "humidity": {
    "qty": 65,
    "units": "%"
  }
}
  • temperature (Object): Omgivelsestemperatur under træningen
  • humidity (Object): Relativ luftfugtighed i procent

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

Svømmespecifikke felter

{
  "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ængde af hver bane
  • strokeStyle (String): En af:
    • "Backstroke"
    • "Breaststroke"
    • "Butterfly"
    • "Freestyle"
    • "Mixed"
    • "Kickboard"
    • "Unknown"
  • swolfScore (Number): Svømmeeffektivitetsscore
  • salinity (String): "Fresh Water" eller "Salt Water"
  • totalSwimmingStrokeCount (Object): Samlet antal tag
  • swimCadence (Object): Tag pr. minut

Skridt- og 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 af skridttællinger over tid
  • stepCadence (Object): Skridt pr. minut
  • flightsClimbed (Object): Antal etager gået op

Pulsdata

{
  "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): Opsummering med min., gns. og maks. puls under træningen
  • maxHeartRate (Object): Maksimal puls under træningen
  • avgHeartRate (Object): Gennemsnitspuls under træningen
  • heartRateData (Array): Detaljerede målinger fra træningen, der slutter, når træningen slutter
  • heartRateRecovery (Array): Separate målinger fra de to minutter umiddelbart efter træningens afslutning

Opsummeringspulsværdier bruger registrerede træningsværdier, når de er tilgængelige, og falder tilbage til træningens pulsmålinger. De eksporterede målinger inkluderer målinger taget under pauser, så deres toppe og gennemsnit kan afvige fra opsummeringen.

Tidsserie-dataarrays

Mange målinger kan inkluderes som tidsseriearrays, når Inkluder træningsmålinger er aktiveret:

{
  "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): Tidsstempel for målingen
  • qty (Number): Mængdeværdi
  • units (String): Måleenhed
  • source (String, valgfri): Datakildeenhed eller -app

HeartRateData-struktur:

  • date (Date): Tidsstempel for målingen
  • Min (Number): Minimumspuls
  • Avg (Number): Gennemsnitspuls
  • Max (Number): Maximumspuls
  • units (String): Enhed (count/min med Lokaliser enheder fra)
  • source (String, valgfri): Datakildeenhed eller -app

Rutedata

Når Inkluder rutedata er aktiveret, og 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
    }
  ]
}

Placeringsfelter:

  • latitude (Number): GPS-breddegrad
  • longitude (Number): GPS-længdegrad
  • altitude (Number): Højde i meter
  • course (Number): Rejseretning i grader (0-360)
  • courseAccuracy (Number): Nøjagtighed af kursmåling i grader
  • horizontalAccuracy (Number): Horisontal positionsnøjagtighed i meter
  • verticalAccuracy (Number): Vertikal positionsnøjagtighed i meter
  • timestamp (Date): Tidspunkt, hvor placeringen blev registreret
  • speed (Number): Hastighed i meter pr. sekund
  • speedAccuracy (Number): Nøjagtighed af hastighedsmåling i m/s

Metadata

{
  "metadata": {
    "customField": {
      "label": "value",
      "quantity": 123
    },
    "anotherField": [
      1,
      2,
      3
    ]
  }
}
  • metadata (Object): Yderligere tilpassede metadata knyttet til træningen

Begivenheder, aktiviteter og splits

Version 2 JSON- og Markdown-eksporter kan inkludere events, segments, laps og activities registreret af træningsappen. Disse forbliver tilgængelige, når Inkluder træningsmålinger er slået fra. CSV og GPX inkluderer ikke disse poster.

Med Inkluder træningsmålinger til og relevante målinger valgt kan intervaller også inkludere afstand, aktiv energi, pulsopsummeringer og pace eller hastighed for aktiv tid. Værdier skelner mellem registrerede målinger og estimater; utilgængelige værdier udelades.

Med afstand valgt kan splits inkludere estimerede kilometer- og mil-splits. De kan afvige fra optagelsesappens splits, og den sidste split markeres som delvis, når den er kortere end målafstanden. Manglende afstandsmålinger eller ikke-understøttede træningstyper kan forhindre splitberegning.

Træningsindsatsresultater

Version 2 JSON- og Markdown-eksporter kan inkludere valgte værdier for Træningsindsatsresultat (effortScore) og Estimeret træningsindsatsresultat (estimatedEffortScore). Hver er et objekt med qty og units: "appleEffortScore".

Resultater kræver iOS 18 eller nyere og adgang til de tilsvarende data i Apple Health. Resultater for hele træningen og aktiviteter er separate. De er uafhængige af Tidsgruppering og Inkluder træningsmålinger; CSV inkluderer dem ikke.

Under Browse → Træninger skal du åbne listens eksportark eller en trænings Version 2-eksportindstillinger og bruge Vælg eksportfelter til at vælge indsatsresultater før eksport.

Tidsgruppering for træningsmålinger

Når du bruger eksportversion 2, og Inkluder træningsmålinger er aktiveret, kan du styre granulariteten af tidsseriedata:

  • Minutter: Grupperer træningsmålinger efter urminutter. Det første og sidste minut kan inkludere nogle få sekunder lige før træningen starter eller lige efter den slutter.
  • Sekunder: Grupperer træningsmålinger efter ursekunder, hvor hvert tidsstempel markerer starten af sit sekund. Det første og sidste sekund kan inkludere brøkdelen af et sekund lige uden for træningen. Filer er større end minutgruppering.

Aktiv og hvileenergi bruger de samme kombinerede totaler som andre træningsmålinger i hver tidsgruppe. Målinger fra mere end én enhed eller app inkluderes sammen.

Træninger Version 1 (ældre)

Version 1 bruger en enklere struktur. Til nye eksporter anbefales 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"
    }
  ]
}

Relateret dokumentation