Senaman - Format Eksport JSON
Dokumentasi untuk struktur senaman dalam eksport JSON
Kemas kini terakhir: 31 Oktober 2026
Pada halaman ini
Eksport JSON menyimpan senaman dalam tatasusunan workouts.
Versi Eksport
Health Auto Export menyokong dua versi eksport senaman:
- Versi 2 (Disyorkan): Format yang dipertingkatkan dengan metadata dan data berstruktur yang lebih terperinci
- Versi 1 (Legasi): Format lama yang dikekalkan untuk keserasian dengan aliran kerja sedia ada
Senaman Versi 2
Versi 2 merangkumi medan wajib berikut dan data pilihan. Contoh menggunakan Setempatkan Unit dimatikan; mendayakannya boleh menukar label unit dalam siri metrik.
Struktur Asas
{
"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
}
Medan Wajib
id(String): Pengecam unik untuk senamanname(String): Nama jenis senaman (cth. "Running", "Cycling", "Swimming")start(Date): Masa mula senaman dalam formatyyyy-MM-dd HH:mm:ss Zend(Date): Masa akhir senaman dalam formatyyyy-MM-dd HH:mm:ss Zduration(Number): Tempoh senaman dalam saat
Medan Pilihan
Medan pilihan bergantung pada data yang tersedia dan pilihan eksport anda:
Sumber Rakaman
{
"source": {
"name": "Workout App",
"identifier": "com.example.workouts"
}
}
source(Object): Aplikasi atau peranti yang merakam senaman, dengan namanya dan pengecam aplikasi. Bacaan metrik individu mempunyai rentetan sumber berasingan dan mungkin datang dari aplikasi atau peranti lain.
Maklumat Lokasi
{
"location": "Outdoor",
"isIndoor": false
}
location(String): Salah satu daripada"Indoor","Outdoor","Pool","Open Water"isIndoor(Boolean): Sama ada senaman dilakukan di dalam bangunan
Tenaga dan Intensiti
{
"activeEnergyBurned": {
"qty": 350,
"units": "kcal"
},
"totalEnergy": {
"qty": 450,
"units": "kcal"
},
"intensity": {
"qty": 8.5,
"units": "kcal/hr\u00b7kg"
}
}
activeEnergyBurned(Object): Kalori aktif yang dibakar semasa senamantotalEnergy(Object): Jumlah kalori (aktif + rehat) yang dibakarintensity(Object): Nilai metabolic equivalent of task (MET)
Jarak dan Kelajuan
{
"distance": {
"qty": 3.5,
"units": "mi"
}
}
distance(Object): Jumlah jarak yang diliputispeed(Object): Kelajuan purata dikira dari jarak dan tempohavgSpeed(Object): Kelajuan purata sepanjang senamanmaxSpeed(Object): Kelajuan maksimum yang dicapai
Setiap objek termasuk qty dan units.
Elevasi
{
"elevationUp": {
"qty": 500,
"units": "ft"
},
"elevationDown": {
"qty": 450,
"units": "ft"
}
}
elevationUp(Object): Jumlah elevasi yang diperolehelevationDown(Object): Jumlah elevasi yang hilang
Unit: "ft" (kaki) atau "m" (meter)
Data Persekitaran
{
"temperature": {
"qty": 72,
"units": "degF"
},
"humidity": {
"qty": 65,
"units": "%"
}
}
temperature(Object): Suhu ambien semasa senamanhumidity(Object): Peratusan kelembapan relatif
Unit Suhu: "degF" (Fahrenheit) atau "degC" (Celsius)
Medan Khusus Renang
{
"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): Panjang setiap pusinganstrokeStyle(String): Salah satu daripada:"Backstroke""Breaststroke""Butterfly""Freestyle""Mixed""Kickboard""Unknown"
swolfScore(Number): Skor kecekapan renangsalinity(String):"Fresh Water"atau"Salt Water"totalSwimmingStrokeCount(Object): Jumlah bilangan kayuhanswimCadence(Object): Kayuhan seminit
Data Langkah dan Kadens
{
"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): Tatasusunan ukuran kiraan langkah dari masa ke masastepCadence(Object): Langkah seminitflightsClimbed(Object): Bilangan tingkat tangga yang didaki
Data Kadar Jantung
{
"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): Ringkasan dengan kadar jantung min, purata, dan maks semasa senamanmaxHeartRate(Object): Kadar jantung maksimum semasa senamanavgHeartRate(Object): Kadar jantung purata semasa senamanheartRateData(Array): Ukuran terperinci dari senaman, berakhir apabila senaman berakhirheartRateRecovery(Array): Ukuran berasingan dari dua minit sejurus selepas senaman berakhir
Ringkasan kadar jantung menggunakan nilai senaman yang direkodkan apabila tersedia, kembali kepada bacaan kadar jantung senaman. Bacaan yang dieksport termasuk ukuran yang diambil semasa jeda, jadi puncak dan puratanya mungkin berbeza daripada ringkasan.
Tatasusunan Data Siri Masa
Banyak metrik boleh disertakan sebagai tatasusunan siri masa apabila "Sertakan Metrik Senaman" didayakan:
{
"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"
}
]
}
Struktur QuantityData:
date(Date): Cap masa ukuranqty(Number): Nilai kuantitiunits(String): Unit ukuransource(String, pilihan): Peranti atau aplikasi sumber data
Struktur HeartRateData:
date(Date): Cap masa ukuranMin(Number): Kadar jantung minimumAvg(Number): Kadar jantung purataMax(Number): Kadar jantung maksimumunits(String): Unit (count/mindengan Setempatkan Unit dimatikan)source(String, pilihan): Peranti atau aplikasi sumber data
Data Laluan
Apabila "Sertakan Data Laluan" didayakan dan senaman mempunyai data 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
}
]
}
Medan Lokasi:
latitude(Number): Koordinat latitud GPSlongitude(Number): Koordinat longitud GPSaltitude(Number): Elevasi dalam metercourse(Number): Arah perjalanan dalam darjah (0-360)courseAccuracy(Number): Ketepatan ukuran arah dalam darjahhorizontalAccuracy(Number): Ketepatan kedudukan mendatar dalam meterverticalAccuracy(Number): Ketepatan kedudukan menegak dalam metertimestamp(Date): Masa apabila lokasi direkodkanspeed(Number): Kelajuan dalam meter sesaatspeedAccuracy(Number): Ketepatan ukuran kelajuan dalam m/s
Metadata
{
"metadata": {
"customField": {
"label": "value",
"quantity": 123
},
"anotherField": [
1,
2,
3
]
}
}
metadata(Object): Metadata tersuai tambahan yang dikaitkan dengan senaman
Peristiwa, Aktiviti, dan Split
Eksport JSON dan Markdown Versi 2 mungkin termasuk events, segments, laps, dan activities yang direkodkan oleh aplikasi senaman. Ini kekal tersedia apabila Sertakan Metrik Senaman dimatikan. CSV dan GPX tidak termasuk rekod ini.
Dengan Sertakan Metrik Senaman dihidupkan dan metrik berkaitan dipilih, selang juga mungkin termasuk jarak, tenaga aktif, ringkasan kadar jantung, dan pace atau kelajuan masa aktif. Nilai membezakan ukuran yang direkodkan daripada anggaran; nilai yang tidak tersedia digugurkan.
Dengan jarak dipilih, splits mungkin termasuk anggaran split kilometer dan batu. Ia boleh berbeza daripada split aplikasi rakaman, dan split akhir ditandai separa apabila lebih pendek daripada jarak sasaran. Bacaan jarak yang hilang atau jenis senaman yang tidak disokong boleh menghalang pengiraan split.
Skor Usaha Senaman
Eksport JSON dan Markdown Versi 2 boleh termasuk nilai Skor Usaha Senaman (effortScore) dan Skor Usaha Senaman Dianggarkan (estimatedEffortScore) yang dipilih. Setiap satu ialah objek dengan qty dan units: "appleEffortScore".
Skor memerlukan iOS 18 atau lebih baharu dan akses kepada data sepadan dalam Apple Health. Skor keseluruhan-senaman dan aktiviti adalah berasingan. Ia bebas daripada Pengumpulan Masa dan Sertakan Metrik Senaman; CSV tidak termasuknya.
Dalam Layari → Senaman, buka helaian eksport senarai atau tetapan eksport Versi 2 senaman, kemudian gunakan Pilih Medan Eksport untuk memilih skor usaha sebelum mengeksport.
Pengumpulan Masa Metrik Senaman
Apabila menggunakan Versi Eksport 2 dan "Sertakan Metrik Senaman" didayakan, anda boleh mengawal perincian data siri masa:
- Minit: Mengumpulkan metrik senaman mengikut minit jam. Minit pertama dan terakhir boleh termasuk beberapa saat sejurus sebelum senaman bermula atau sejurus selepas ia berakhir.
- Saat: Mengumpulkan metrik senaman mengikut saat jam, dengan setiap cap masa menandakan permulaan saatnya. Saat pertama dan terakhir boleh termasuk pecahan saat di luar senaman. Fail lebih besar daripada pengumpulan minit.
Tenaga aktif dan rehat menggunakan jumlah gabungan yang sama seperti metrik senaman lain dalam setiap kumpulan masa. Bacaan dari lebih daripada satu peranti atau aplikasi disertakan bersama.
Senaman Versi 1 (Legasi)
Versi 1 menggunakan struktur yang lebih ringkas. Untuk eksport baharu, Versi 2 disyorkan.
Struktur Versi 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"
}
]
}