Hjelpsenter HealthyApps
Norsk Bokmål
Hjelpsenter
Hovednettsted ↗

Søk i hjelpeemner

Treningsøkter - JSON-eksportformat

Dokumentasjon for treningsstruktur i JSON-eksporter

Sist oppdatert: 31. oktober 2026

På denne siden
Eksportversjoner
Treningsøkter Versjon 2 Treningsøkter Versjon 2 GrunnstrukturObligatoriske feltValgfrie feltTidsgruppering av treningsmål
Treningsøkter Versjon 1 (eldre) Treningsøkter Versjon 1 (eldre) Versjon 1-struktur
Relatert dokumentasjon

JSON-eksporter lagrer treningsøkter i arrayen workouts.

Eksportversjoner

Health Auto Export støtter to eksportversjoner for treningsøkter:

  • Versjon 2 (anbefalt): Forbedret format med mer detaljert metadata og strukturerte data
  • Versjon 1 (eldre): Eldre format som beholdes for kompatibilitet med eksisterende arbeidsflyter

Treningsøkter Versjon 2

Versjon 2 inkluderer følgende obligatoriske felt og valgfrie data. Eksemplene bruker Lokaliser enheter av; aktivering kan endre enhetsetiketter i målserier.

Grunnstruktur

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

Obligatoriske felt

  • id (String): Unik identifikator for treningsøkten
  • name (String): Navn på treningstype (f.eks. "Running", "Cycling", "Swimming")
  • start (Date): Starttid for treningsøkten i formatet yyyy-MM-dd HH:mm:ss Z
  • end (Date): Sluttid for treningsøkten i formatet yyyy-MM-dd HH:mm:ss Z
  • duration (Number): Lengde for treningsøkten i sekunder

Valgfrie felt

Valgfrie felt avhenger av tilgjengelige data og eksportvalgene dine:

Opptakskilde

{
  "source": {
    "name": "Workout App",
    "identifier": "com.example.workouts"
  }
}
  • source (Object): Appen eller enheten som registrerte treningsøkten, med navn og appidentifikator. Individuelle målinger har separate kildestrenger og kan komme fra en annen app eller enhet.

Stedsinformasjon

{
  "location": "Outdoor",
  "isIndoor": false
}
  • location (String): Én av "Indoor", "Outdoor", "Pool", "Open Water"
  • isIndoor (Boolean): Om treningsøkten ble utført innendø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 forbrent under treningsøkten
  • totalEnergy (Object): Totale kalorier (aktive + hvile) forbrent
  • intensity (Object): Metabolsk ekvivalent av oppgave (MET)

Avstand og hastighet

{
  "distance": {
    "qty": 3.5,
    "units": "mi"
  }
}
  • distance (Object): Total tilbakelagt avstand
  • speed (Object): Gjennomsnittshastighet beregnet fra avstand og lengde
  • avgSpeed (Object): Gjennomsnittshastighet under treningsøkten
  • maxSpeed (Object): Maksimal oppnådd hastighet

Hvert objekt inkluderer qty og units.

Høyde

{
  "elevationUp": {
    "qty": 500,
    "units": "ft"
  },
  "elevationDown": {
    "qty": 450,
    "units": "ft"
  }
}
  • elevationUp (Object): Total høydegevinst
  • elevationDown (Object): Total høyde tap

Enheter: "ft" (fot) eller "m" (meter)

Miljødata

{
  "temperature": {
    "qty": 72,
    "units": "degF"
  },
  "humidity": {
    "qty": 65,
    "units": "%"
  }
}
  • temperature (Object): Omgivelsestemperatur under treningsøkten
  • humidity (Object): Relativ luftfuktighet i prosent

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

Svømmespesifikke felt

{
  "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): Lengde på hvert basseng
  • strokeStyle (String): Én av:
    • "Backstroke"
    • "Breaststroke"
    • "Butterfly"
    • "Freestyle"
    • "Mixed"
    • "Kickboard"
    • "Unknown"
  • swolfScore (Number): Svømmeeffektivitetspoeng
  • salinity (String): "Fresh Water" eller "Salt Water"
  • totalSwimmingStrokeCount (Object): Totalt antall tak
  • swimCadence (Object): Tak per minutt

Steg- 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 med stegtellinger over tid
  • stepCadence (Object): Steg per minutt
  • flightsClimbed (Object): Antall etasjer gått opp

Hjertefrekvensdata

{
  "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): Oppsummering med min., gj.sn. og maks. hjertefrekvens under treningsøkten
  • maxHeartRate (Object): Maksimal hjertefrekvens under treningsøkten
  • avgHeartRate (Object): Gjennomsnittlig hjertefrekvens under treningsøkten
  • heartRateData (Array): Detaljerte målinger fra treningsøkten, som slutter når treningsøkten slutter
  • heartRateRecovery (Array): Separate målinger fra de to minuttene umiddelbart etter at treningsøkten slutter

Oppsummerte hjertefrekvensverdier bruker registrerte treningsverdier når de finnes, og faller tilbake til treningsøktens hjertefrekvensmålinger. De eksporterte målingene inkluderer målinger tatt under pauser, så toppene og gjennomsnittene kan skille seg fra oppsummeringen.

Tidsserie-dataarrays

Mange mål kan inkluderes som tidsseriearrays når Inkluder treningsmål er aktivert:

{
  "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): Mengdeverdi
  • units (String): Måleenhet
  • source (String, valgfritt): Datakildeenhet eller -app

HeartRateData-struktur:

  • date (Date): Tidsstempel for målingen
  • Min (Number): Minimum hjertefrekvens
  • Avg (Number): Gjennomsnittlig hjertefrekvens
  • Max (Number): Maksimum hjertefrekvens
  • units (String): Enhet (count/min med Lokaliser enheter av)
  • source (String, valgfritt): Datakildeenhet eller -app

Rutedata

Når Inkluder rutedata er aktivert og treningsøkten 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
    }
  ]
}

Stedsfelt:

  • latitude (Number): GPS-breddegrad
  • longitude (Number): GPS-lengdegrad
  • altitude (Number): Høyde i meter
  • course (Number): Retning i grader (0-360)
  • courseAccuracy (Number): Nøyaktighet for kursmåling i grader
  • horizontalAccuracy (Number): Horisontal posisjonsnøyaktighet i meter
  • verticalAccuracy (Number): Vertikal posisjonsnøyaktighet i meter
  • timestamp (Date): Tid da stedet ble registrert
  • speed (Number): Hastighet i meter per sekund
  • speedAccuracy (Number): Nøyaktighet for hastighetsmåling i m/s

Metadata

{
  "metadata": {
    "customField": {
      "label": "value",
      "quantity": 123
    },
    "anotherField": [
      1,
      2,
      3
    ]
  }
}
  • metadata (Object): Ytterligere tilpasset metadata knyttet til treningsøkten

Hendelser, aktiviteter og splits

Versjon 2 JSON- og Markdown-eksporter kan inkludere events, segments, laps og activities registrert av treningsappen. Disse forblir tilgjengelige når Inkluder treningsmål er av. CSV og GPX inkluderer ikke disse postene.

Med Inkluder treningsmål på og relevante mål valgt kan intervaller også inkludere avstand, aktiv energi, hjertefrekvensoppsummeringer og pace eller hastighet for aktiv tid. Verdier skiller mellom registrerte målinger og estimater; utilgjengelige verdier utelates.

Med avstand valgt kan splits inkludere estimerte kilometer- og mil-splits. De kan skille seg fra opptaksappens splits, og den siste spliten markeres som delvis når den er kortere enn målavstanden. Manglende avstandsmålinger eller treningstyper som ikke støttes kan forhindre splitberegning.

Treningsinnsats-poeng

Versjon 2 JSON- og Markdown-eksporter kan inkludere valgte verdier for Treningsinnsats-poeng (effortScore) og Estimert treningsinnsats-poeng (estimatedEffortScore). Hver er et objekt med qty og units: "appleEffortScore".

Poeng krever iOS 18 eller senere og tilgang til tilsvarende data i Apple Health. Poeng for hele treningsøkten og aktiviteter er separate. De er uavhengige av Tidsgruppering og Inkluder treningsmål; CSV inkluderer dem ikke.

Under Bla gjennom → Treningsøkter åpner du listens eksportark eller en treningsøkts Versjon 2-eksportinnstillinger og bruker Velg eksportfelt for å velge innsatspoeng før eksport.

Tidsgruppering av treningsmål

Når du bruker eksportversjon 2 og Inkluder treningsmål er aktivert, kan du styre granulariteten for tidsseriedata:

  • Minutter: Grupperer treningsmål etter klokkeminutter. Det første og siste minuttet kan inkludere noen sekunder like før treningsøkten starter eller like etter at den slutter.
  • Sekunder: Grupperer treningsmål etter klokkesekunder, der hvert tidsstempel markerer starten av sitt sekund. Det første og siste sekundet kan inkludere brøkdelen av et sekund like utenfor treningsøkten. Filer blir større enn minuttgruppering.

Aktiv og hvilende energi bruker samme kombinerte totaler som andre treningsmål i hver tidsgruppe. Målinger fra mer enn én enhet eller app inkluderes sammen.

Treningsøkter Versjon 1 (eldre)

Versjon 1 bruker en enklere struktur. For nye eksporter anbefales Versjon 2.

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

Relatert dokumentasjon