Treningi — format eksportu JSON
Dokumentacja struktury treningów w eksportach JSON
Ostatnia aktualizacja: 31 października 2026
Na tej stronie
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 treninguname(String): Nazwa typu treningu (np. „Running”, „Cycling”, „Swimming”)start(Date): Czas rozpoczęcia treningu w formacieyyyy-MM-dd HH:mm:ss Zend(Date): Czas zakończenia treningu w formacieyyyy-MM-dd HH:mm:ss Zduration(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 treningutotalEnergy(Object): Całkowite kalorie (aktywne + spoczynkowe) spaloneintensity(Object): Wartość metabolicznego ekwiwalentu zadania (MET)
Dystans i prędkość
{
"distance": {
"qty": 3.5,
"units": "mi"
}
}
distance(Object): Całkowity pokonany dystansspeed(Object): Średnia prędkość obliczona z dystansu i czasu trwaniaavgSpeed(Object): Średnia prędkość w trakcie treningumaxSpeed(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ższenieelevationDown(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 treninguhumidity(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 basenustrokeStyle(String): Jedno z:"Backstroke""Breaststroke""Butterfly""Freestyle""Mixed""Kickboard""Unknown"
swolfScore(Number): Wynik efektywności pływaniasalinity(String):"Fresh Water"lub"Salt Water"totalSwimmingStrokeCount(Object): Całkowita liczba ruchówswimCadence(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 czasiestepCadence(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 treningumaxHeartRate(Object): Maksymalne tętno podczas treninguavgHeartRate(Object): Średnie tętno podczas treninguheartRateData(Array): Szczegółowe pomiary z treningu, kończące się wraz z końcem treninguheartRateRecovery(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 pomiaruqty(Number): Wartość ilościowaunits(String): Jednostka miarysource(String, opcjonalne): Urządzenie lub aplikacja źródłowa
Struktura HeartRateData:
date(Date): Znacznik czasu pomiaruMin(Number): Minimalne tętnoAvg(Number): Średnie tętnoMax(Number): Maksymalne tętnounits(String): Jednostka (count/minprzy 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 GPSlongitude(Number): Współrzędna długości GPSaltitude(Number): Wysokość w metrachcourse(Number): Kierunek ruchu w stopniach (0–360)courseAccuracy(Number): Dokładność pomiaru kursu w stopniachhorizontalAccuracy(Number): Dokładność pozycji poziomej w metrachverticalAccuracy(Number): Dokładność pozycji pionowej w metrachtimestamp(Date): Czas zarejestrowania lokalizacjispeed(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"
}
]
}