Centrum pomocy HealthyApps
Polski
Centrum pomocy
Strona główna ↗

Szukaj tematów pomocy

Treningi — format eksportu JSON

Dokumentacja struktury treningów w eksportach JSON

Ostatnia aktualizacja: 31 października 2026

Na tej stronie
Wersje eksportu
Treningi wersja 2 Treningi wersja 2 Podstawowa strukturaPola wymaganePola opcjonalneGrupowanie czasu metryk treningu
Treningi wersja 1 (starsza) Treningi wersja 1 (starsza) Struktura wersji 1
Powiązana dokumentacja

Eksporty JSON przechowują treningi w tablicy workouts.

Wersje eksportu

Health Auto Export obsługuje dwie wersje eksportu treningów:

  • Wersja 2 (zalecana): Rozszerzony format z bardziej szczegółowymi metadanymi i danymi strukturalnymi
  • Wersja 1 (starsza): Starszy format utrzymywany dla zgodności z istniejącymi przepływami pracy

Treningi wersja 2

Wersja 2 obejmuje poniższe pola wymagane oraz opcjonalne dane. Przykłady używają wyłączonej opcji Lokalizuj jednostki; jej włączenie może zmienić etykiety jednostek w seriach metryk.

Podstawowa struktura

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

Pola wymagane

  • id (String): Unikalny identyfikator treningu
  • name (String): Nazwa typu treningu (np. „Running”, „Cycling”, „Swimming”)
  • start (Date): Czas rozpoczęcia treningu w formacie yyyy-MM-dd HH:mm:ss Z
  • end (Date): Czas zakończenia treningu w formacie yyyy-MM-dd HH:mm:ss Z
  • duration (Number): Czas trwania treningu w sekundach

Pola opcjonalne

Pola opcjonalne zależą od dostępnych danych i wyborów eksportu:

Źródło rejestracji

{
  "source": {
    "name": "Workout App",
    "identifier": "com.example.workouts"
  }
}
  • source (Object): Aplikacja lub urządzenie, które zarejestrowało trening, z nazwą i identyfikatorem aplikacji. Poszczególne odczyty metryk mają osobne ciągi źródła i mogą pochodzić z innej aplikacji lub urządzenia.

Informacje o lokalizacji

{
  "location": "Outdoor",
  "isIndoor": false
}
  • location (String): Jedno z "Indoor", "Outdoor", "Pool", "Open Water"
  • isIndoor (Boolean): Czy trening był wykonywany w pomieszczeniu

Energia i intensywność

{
  "activeEnergyBurned": {
    "qty": 350,
    "units": "kcal"
  },
  "totalEnergy": {
    "qty": 450,
    "units": "kcal"
  },
  "intensity": {
    "qty": 8.5,
    "units": "kcal/hr\u00b7kg"
  }
}
  • activeEnergyBurned (Object): Aktywne kalorie spalone podczas treningu
  • totalEnergy (Object): Całkowite kalorie (aktywne + spoczynkowe) spalone
  • intensity (Object): Wartość metabolicznego ekwiwalentu zadania (MET)

Dystans i prędkość

{
  "distance": {
    "qty": 3.5,
    "units": "mi"
  }
}
  • distance (Object): Całkowity pokonany dystans
  • speed (Object): Średnia prędkość obliczona z dystansu i czasu trwania
  • avgSpeed (Object): Średnia prędkość w trakcie treningu
  • maxSpeed (Object): Maksymalna osiągnięta prędkość

Każdy obiekt zawiera qty i units.

Przewyższenie

{
  "elevationUp": {
    "qty": 500,
    "units": "ft"
  },
  "elevationDown": {
    "qty": 450,
    "units": "ft"
  }
}
  • elevationUp (Object): Całkowite zdobyte przewyższenie
  • elevationDown (Object): Całkowite utracone przewyższenie

Jednostki: "ft" (stopy) lub "m" (metry)

Dane środowiskowe

{
  "temperature": {
    "qty": 72,
    "units": "degF"
  },
  "humidity": {
    "qty": 65,
    "units": "%"
  }
}
  • temperature (Object): Temperatura otoczenia podczas treningu
  • humidity (Object): Względna wilgotność w procentach

Jednostki temperatury: "degF" (Fahrenheit) lub "degC" (Celsius)

Pola specyficzne dla pływania

{
  "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): Długość każdego basenu
  • strokeStyle (String): Jedno z:
    • "Backstroke"
    • "Breaststroke"
    • "Butterfly"
    • "Freestyle"
    • "Mixed"
    • "Kickboard"
    • "Unknown"
  • swolfScore (Number): Wynik efektywności pływania
  • salinity (String): "Fresh Water" lub "Salt Water"
  • totalSwimmingStrokeCount (Object): Całkowita liczba ruchów
  • swimCadence (Object): Ruchy na minutę

Dane kroków i kadencji

{
  "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): Tablica pomiarów liczby kroków w czasie
  • stepCadence (Object): Kroki na minutę
  • flightsClimbed (Object): Liczba pokonanych pięter schodów

Dane tętna

{
  "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): Podsumowanie z min, avg i max tętna podczas treningu
  • maxHeartRate (Object): Maksymalne tętno podczas treningu
  • avgHeartRate (Object): Średnie tętno podczas treningu
  • heartRateData (Array): Szczegółowe pomiary z treningu, kończące się wraz z końcem treningu
  • heartRateRecovery (Array): Osobne pomiary z dwóch minut bezpośrednio po zakończeniu treningu

Podsumowania tętna używają zarejestrowanych wartości treningu, gdy są dostępne, a w przeciwnym razie odczytów tętna treningu. Wyeksportowane odczyty obejmują pomiary wykonane podczas pauz, więc ich szczyty i średnie mogą różnić się od podsumowania.

Tablice danych szeregów czasowych

Wiele metryk można dołączyć jako tablice szeregów czasowych, gdy włączone jest „Uwzględnij metryki treningu”:

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

Struktura QuantityData:

  • date (Date): Znacznik czasu pomiaru
  • qty (Number): Wartość ilościowa
  • units (String): Jednostka miary
  • source (String, opcjonalne): Urządzenie lub aplikacja źródłowa

Struktura HeartRateData:

  • date (Date): Znacznik czasu pomiaru
  • Min (Number): Minimalne tętno
  • Avg (Number): Średnie tętno
  • Max (Number): Maksymalne tętno
  • units (String): Jednostka (count/min przy wyłączonym Lokalizuj jednostki)
  • source (String, opcjonalne): Urządzenie lub aplikacja źródłowa

Dane trasy

Gdy włączone jest „Uwzględnij dane trasy” i trening ma dane GPS:

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

Pola lokalizacji:

  • latitude (Number): Współrzędna szerokości GPS
  • longitude (Number): Współrzędna długości GPS
  • altitude (Number): Wysokość w metrach
  • course (Number): Kierunek ruchu w stopniach (0–360)
  • courseAccuracy (Number): Dokładność pomiaru kursu w stopniach
  • horizontalAccuracy (Number): Dokładność pozycji poziomej w metrach
  • verticalAccuracy (Number): Dokładność pozycji pionowej w metrach
  • timestamp (Date): Czas zarejestrowania lokalizacji
  • speed (Number): Prędkość w metrach na sekundę
  • speedAccuracy (Number): Dokładność pomiaru prędkości w m/s

Metadane

{
  "metadata": {
    "customField": {
      "label": "value",
      "quantity": 123
    },
    "anotherField": [
      1,
      2,
      3
    ]
  }
}
  • metadata (Object): Dodatkowe niestandardowe metadane powiązane z treningiem

Zdarzenia, aktywności i splity

Eksporty JSON i Markdown wersji 2 mogą zawierać events, segments, laps i activities zarejestrowane przez aplikację treningową. Pozostają dostępne, gdy Uwzględnij metryki treningu jest wyłączone. CSV i GPX nie zawierają tych rekordów.

Przy włączonym Uwzględnij metryki treningu i wybranych odpowiednich metrykach interwały mogą też zawierać dystans, aktywną energię, podsumowania tętna oraz tempo lub prędkość czasu aktywnego. Wartości rozróżniają zarejestrowane pomiary od szacunków; niedostępne wartości są pomijane.

Przy wybranym dystansie splits mogą zawierać szacowane splity kilometrowe i milowe. Mogą różnić się od splitów aplikacji rejestrującej, a ostatni split jest oznaczony jako częściowy, gdy jest krótszy niż docelowy dystans. Brakujące odczyty dystansu lub nieobsługiwane typy treningu mogą uniemożliwić obliczenie splitów.

Wyniki wysiłku treningu

Eksporty JSON i Markdown wersji 2 mogą zawierać wybrane wartości Wyniku wysiłku treningu (effortScore) oraz Szacowanego wyniku wysiłku treningu (estimatedEffortScore). Każda to obiekt z qty i units: "appleEffortScore".

Wyniki wymagają iOS 18 lub nowszego oraz dostępu do odpowiednich danych w Apple Health. Wyniki całego treningu i aktywności są osobne. Są niezależne od Grupowania czasu i Uwzględnij metryki treningu; CSV ich nie zawiera.

W Przeglądaj → Treningi otwórz arkusz eksportu listy lub ustawienia eksportu wersji 2 treningu, a następnie użyj Wybierz pola eksportu, aby wybrać wyniki wysiłku przed eksportem.

Grupowanie czasu metryk treningu

Przy użyciu wersji eksportu 2 i włączonym „Uwzględnij metryki treningu” możesz kontrolować ziarnistość danych szeregów czasowych:

  • Minuty: Grupuje metryki treningu według minut zegarowych. Pierwsza i ostatnia minuta mogą obejmować kilka sekund tuż przed rozpoczęciem treningu lub tuż po jego zakończeniu.
  • Sekundy: Grupuje metryki treningu według sekund zegarowych, a każdy znacznik czasu oznacza początek swojej sekundy. Pierwsza i ostatnia sekunda mogą obejmować ułamek sekundy tuż poza treningiem. Pliki są większe niż przy grupowaniu minutowym.

Aktywna i spoczynkowa energia używają tych samych połączonych sum co inne metryki treningu w każdej grupie czasowej. Odczyty z więcej niż jednego urządzenia lub aplikacji są uwzględniane razem.

Treningi wersja 1 (starsza)

Wersja 1 używa prostszej struktury. W przypadku nowych eksportów zalecana jest wersja 2.

Struktura wersji 1

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

Powiązana dokumentacja