वर्कआउट - JSON निर्यात प्रारूप
JSON निर्यात में वर्कआउट संरचना का दस्तावेज़ीकरण
अंतिम अपडेट: 31 अक्टूबर 2026
इस पृष्ठ पर
JSON निर्यात वर्कआउट workouts सरणी में संग्रहीत करते हैं।
निर्यात संस्करण
Health Auto Export दो वर्कआउट निर्यात संस्करण समर्थित करता है:
- संस्करण 2 (अनुशंसित): अधिक विस्तृत मेटाडेटा और संरचित डेटा वाला उन्नत प्रारूप
- संस्करण 1 (लेगेसी): मौजूदा वर्कफ़्लो संगतता के लिए बनाए रखा पुराना प्रारूप
वर्कआउट संस्करण 2
संस्करण 2 में निम्न आवश्यक फ़ील्ड और वैकल्पिक डेटा शामिल हैं। उदाहरण इकाइयाँ स्थानीयकृत करें बंद उपयोग करते हैं; इसे सक्षम करने से मेट्रिक श्रृंखला में इकाई लेबल बदल सकते हैं।
मूल संरचना
{
"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
}
आवश्यक फ़ील्ड
id(String): वर्कआउट के लिए अद्वितीय पहचानकर्ताname(String): वर्कआउट प्रकार नाम (उदा. "Running", "Cycling", "Swimming")start(Date):yyyy-MM-dd HH:mm:ss Zप्रारूप में वर्कआउट प्रारंभ समयend(Date):yyyy-MM-dd HH:mm:ss Zप्रारूप में वर्कआउट समाप्ति समयduration(Number): सेकंड में वर्कआउट अवधि
वैकल्पिक फ़ील्ड
वैकल्पिक फ़ील्ड उपलब्ध डेटा और आपके निर्यात चयन पर निर्भर करते हैं:
रिकॉर्डिंग स्रोत
{
"source": {
"name": "Workout App",
"identifier": "com.example.workouts"
}
}
source(Object): वर्कआउट रिकॉर्ड करने वाला ऐप या डिवाइस, उसके नाम और ऐप पहचानकर्ता के साथ। व्यक्तिगत मेट्रिक रीडिंग के अलग स्रोत स्ट्रिंग होते हैं और किसी अन्य ऐप या डिवाइस से आ सकते हैं।
स्थान जानकारी
{
"location": "Outdoor",
"isIndoor": false
}
location(String):"Indoor","Outdoor","Pool","Open Water"में से एकisIndoor(Boolean): क्या वर्कआउट घर के अंदर किया गया
ऊर्जा और तीव्रता
{
"activeEnergyBurned": {
"qty": 350,
"units": "kcal"
},
"totalEnergy": {
"qty": 450,
"units": "kcal"
},
"intensity": {
"qty": 8.5,
"units": "kcal/hr\u00b7kg"
}
}
activeEnergyBurned(Object): वर्कआउट के दौरान जली सक्रिय कैलोरीtotalEnergy(Object): कुल कैलोरी (सक्रिय + विश्राम)intensity(Object): मेटाबॉलिक इक्विवेलेंट ऑफ़ टास्क (MET) मान
दूरी और गति
{
"distance": {
"qty": 3.5,
"units": "mi"
}
}
distance(Object): तय की गई कुल दूरीspeed(Object): दूरी और अवधि से गणना औसत गतिavgSpeed(Object): पूरे वर्कआउट की औसत गतिmaxSpeed(Object): पहुँची अधिकतम गति
प्रत्येक ऑब्जेक्ट में qty और units शामिल हैं।
ऊँचाई
{
"elevationUp": {
"qty": 500,
"units": "ft"
},
"elevationDown": {
"qty": 450,
"units": "ft"
}
}
elevationUp(Object): कुल ऊँचाई लाभelevationDown(Object): कुल ऊँचाई हानि
इकाइयाँ: "ft" (फीट) या "m" (मीटर)
पर्यावरण डेटा
{
"temperature": {
"qty": 72,
"units": "degF"
},
"humidity": {
"qty": 65,
"units": "%"
}
}
temperature(Object): वर्कआउट के दौरान परिवेश तापमानhumidity(Object): सापेक्ष आर्द्रता प्रतिशत
तापमान इकाइयाँ: "degF" (फ़ारेनहाइट) या "degC" (सेल्सियस)
स्विमिंग-विशिष्ट फ़ील्ड
{
"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): प्रत्येक लैप की लंबाईstrokeStyle(String): इनमें से एक:"Backstroke""Breaststroke""Butterfly""Freestyle""Mixed""Kickboard""Unknown"
swolfScore(Number): स्विमिंग दक्षता स्कोरsalinity(String):"Fresh Water"या"Salt Water"totalSwimmingStrokeCount(Object): स्ट्रोक की कुल संख्याswimCadence(Object): प्रति मिनट स्ट्रोक
कदम और कैडेंस डेटा
{
"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): समय के साथ कदम गणना माप की सरणीstepCadence(Object): प्रति मिनट कदमflightsClimbed(Object): चढ़ी सीढ़ियों की उड़ानों की संख्या
हृदय गति डेटा
{
"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): वर्कआउट के दौरान न्यूनतम, औसत, और अधिकतम हृदय गति वाला सारांशmaxHeartRate(Object): वर्कआउट के दौरान अधिकतम हृदय गतिavgHeartRate(Object): वर्कआउट के दौरान औसत हृदय गतिheartRateData(Array): वर्कआउट से विस्तृत माप, वर्कआउट समाप्त होने पर समाप्तheartRateRecovery(Array): वर्कआउट समाप्त होने के तुरंत बाद दो मिनट के अलग माप
सारांश हृदय गति उपलब्ध होने पर रिकॉर्ड वर्कआउट मान उपयोग करते हैं, अन्यथा वर्कआउट की हृदय-गति रीडिंग पर वापस जाते हैं। निर्यातित रीडिंग में विराम के दौरान लिए माप शामिल होते हैं, इसलिए उनके शिखर और औसत सारांश से भिन्न हो सकते हैं।
समय-श्रृंखला डेटा सरणियाँ
"वर्कआउट मेट्रिक शामिल करें" सक्षम होने पर कई मेट्रिक समय-श्रृंखला सरणियों के रूप में शामिल हो सकते हैं:
{
"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 संरचना:
date(Date): माप का टाइमस्टैम्पqty(Number): मात्रा मानunits(String): माप की इकाईsource(String, वैकल्पिक): डेटा स्रोत डिवाइस या ऐप
HeartRateData संरचना:
date(Date): माप का टाइमस्टैम्पMin(Number): न्यूनतम हृदय गतिAvg(Number): औसत हृदय गतिMax(Number): अधिकतम हृदय गतिunits(String): इकाई (इकाइयाँ स्थानीयकृत करें बंद होने परcount/min)source(String, वैकल्पिक): डेटा स्रोत डिवाइस या ऐप
मार्ग डेटा
जब "मार्ग डेटा शामिल करें" सक्षम हो और वर्कआउट में 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
}
]
}
स्थान फ़ील्ड:
latitude(Number): GPS अक्षांश निर्देशांकlongitude(Number): GPS देशांतर निर्देशांकaltitude(Number): मीटर में ऊँचाईcourse(Number): डिग्री में यात्रा दिशा (0-360)courseAccuracy(Number): डिग्री में कोर्स माप सटीकताhorizontalAccuracy(Number): मीटर में क्षैतिज स्थिति सटीकताverticalAccuracy(Number): मीटर में ऊर्ध्वाधर स्थिति सटीकताtimestamp(Date): स्थान रिकॉर्ड होने का समयspeed(Number): मीटर प्रति सेकंड में गतिspeedAccuracy(Number): m/s में गति माप सटीकता
मेटाडेटा
{
"metadata": {
"customField": {
"label": "value",
"quantity": 123
},
"anotherField": [
1,
2,
3
]
}
}
metadata(Object): वर्कआउट से जुड़ा अतिरिक्त कस्टम मेटाडेटा
इवेंट, गतिविधियाँ, और स्प्लिट
संस्करण 2 JSON और Markdown निर्यात वर्कआउट ऐप द्वारा रिकॉर्ड events, segments, laps, और activities शामिल कर सकते हैं। वर्कआउट मेट्रिक शामिल करें बंद होने पर भी ये उपलब्ध रहते हैं। CSV और GPX इन रिकॉर्ड को शामिल नहीं करते।
वर्कआउट मेट्रिक शामिल करें चालू और प्रासंगिक मेट्रिक चयनित होने पर, अंतराल दूरी, सक्रिय ऊर्जा, हृदय-गति सारांश, और सक्रिय-समय पेस या गति भी शामिल कर सकते हैं। मान रिकॉर्ड माप को अनुमानों से अलग करते हैं; अनुपलब्ध मान छोड़ दिए जाते हैं।
दूरी चयनित होने पर, splits अनुमानित किलोमीटर और मील स्प्लिट शामिल कर सकते हैं। वे रिकॉर्डिंग ऐप के स्प्लिट से भिन्न हो सकते हैं, और अंतिम स्प्लिट लक्ष्य दूरी से छोटा होने पर आंशिक चिह्नित होता है। गायब दूरी रीडिंग या असमर्थित वर्कआउट प्रकार स्प्लिट गणना रोक सकते हैं।
वर्कआउट प्रयास स्कोर
संस्करण 2 JSON और Markdown निर्यात चयनित वर्कआउट प्रयास स्कोर (effortScore) और अनुमानित वर्कआउट प्रयास स्कोर (estimatedEffortScore) मान शामिल कर सकते हैं। प्रत्येक qty और units: "appleEffortScore" वाला ऑब्जेक्ट है।
स्कोर के लिए iOS 18 या बाद का और Apple Health में संबंधित डेटा की पहुँच आवश्यक है। पूरे-वर्कआउट और गतिविधि स्कोर अलग हैं। वे समय समूहन और वर्कआउट मेट्रिक शामिल करें से स्वतंत्र हैं; CSV उन्हें शामिल नहीं करता।
ब्राउज़ → वर्कआउट में, सूची की निर्यात शीट या वर्कआउट की संस्करण 2 निर्यात सेटिंग्स खोलें, फिर निर्यात से पहले प्रयास स्कोर चुनने के लिए निर्यात फ़ील्ड चुनें उपयोग करें।
वर्कआउट मेट्रिक समय समूहन
निर्यात संस्करण 2 उपयोग करते समय और "वर्कआउट मेट्रिक शामिल करें" सक्षम होने पर, आप समय-श्रृंखला डेटा की बारीकी नियंत्रित कर सकते हैं:
- मिनट: घड़ी मिनटों पर वर्कआउट मेट्रिक समूहित करता है। पहला और अंतिम मिनट वर्कआउट शुरू होने से ठीक पहले या समाप्त होने के ठीक बाद कुछ सेकंड शामिल कर सकता है।
- सेकंड: घड़ी सेकंड पर वर्कआउट मेट्रिक समूहित करता है, प्रत्येक टाइमस्टैम्प अपने सेकंड का प्रारंभ चिह्नित करता है। पहला और अंतिम सेकंड वर्कआउट के ठीक बाहर का भिन्नात्मक सेकंड शामिल कर सकता है। फ़ाइलें मिनट समूहन से बड़ी होती हैं।
सक्रिय और विश्राम ऊर्जा प्रत्येक समय समूह में अन्य वर्कआउट मेट्रिक जैसे ही संयुक्त योग उपयोग करती हैं। एक से अधिक डिवाइस या ऐप की रीडिंग एक साथ शामिल होती हैं।
वर्कआउट संस्करण 1 (लेगेसी)
संस्करण 1 सरल संरचना उपयोग करता है। नए निर्यात के लिए संस्करण 2 अनुशंसित है।
संस्करण 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"
}
]
}