वर्कआउट - JSON निर्यात प्रारूप

JSON निर्यात में वर्कआउट संरचना के लिए दस्तावेज़

Last updated: February 6, 2026

On this page

वर्कआउट

वर्कआउट डेटा में Apple Health में दर्ज किए गए आपके सभी व्यायाम सत्र शामिल हैं, जैसे दौड़ना, साइकिल चलाना, तैराकी, स्ट्रेंथ ट्रेनिंग और अधिक। 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): सेकंड में वर्कआउट अवधि

वैकल्पिक फ़ील्ड

निम्नलिखित फ़ील्ड केवल तभी शामिल होते हैं जब डेटा उपलब्ध हो:

स्थान जानकारी

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

activeEnergyBurned (Object): वर्कआउट के दौरान जली हुई सक्रिय कैलोरी
totalEnergy (Object): जली हुई कुल कैलोरी (सक्रिय + आराम)
intensity (Object): कार्य का चयापचय समतुल्य (MET) मान

दूरी और गति

{
  "distance": {
    "qty": 3.5,
    "units": "mi"
  },
  "speed": {
    "qty": 7.0,
    "units": "mph"
  },
  "avgSpeed": {
    "qty": 7.0,
    "units": "mph"
  },
  "maxSpeed": {
    "qty": 8.5,
    "units": "mph"
  }
}

distance (Object): कुल तय की गई दूरी
speed (Object): वर्तमान या औसत गति
avgSpeed (Object): पूरे वर्कआउट के दौरान औसत गति
maxSpeed (Object): प्राप्त की गई अधिकतम गति

इकाइयाँ:

दूरी: "mi" (मील) या "km" (किलोमीटर)
गति: "mph" (प्रति घंटा मील) या "kmph" (प्रति घंटा किलोमीटर)

ऊंचाई

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

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": "spm"
  },
  "flightsClimbed": {
    "qty": 10,
    "units": "count"
  }
}

stepCount (Array): समय के साथ कदम गिनती मापों की सरणी
stepCadence (Object): प्रति मिनट कदम
flightsClimbed (Object): चढ़ी गई सीढ़ियों की संख्या

हृदय गति डेटा

{
  "heartRate": {
    "min": {
      "qty": 120,
      "units": "bpm"
    },
    "avg": {
      "qty": 150,
      "units": "bpm"
    },
    "max": {
      "qty": 175,
      "units": "bpm"
    }
  },
  "maxHeartRate": {
    "qty": 175,
    "units": "bpm"
  },
  "avgHeartRate": {
    "qty": 150,
    "units": "bpm"
  },
  "heartRateData": [
    {
      "date": "2024-02-06 07:00:00 -0800",
      "Min": 120,
      "Avg": 150,
      "Max": 175,
      "units": "bpm",
      "source": "Apple Watch"
    }
  ],
  "heartRateRecovery": [
    {
      "date": "2024-02-06 07:30:00 -0800",
      "Min": 140,
      "Avg": 145,
      "Max": 150,
      "units": "bpm",
      "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": "rpm",
      "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": "mph",
      "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): इकाई (आमतौर पर "bpm")
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": "value",
    "anotherField": 123
  }
}

metadata (Object): वर्कआउट से जुड़े अतिरिक्त कस्टम मेटाडेटा

वर्कआउट संस्करण 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": "count"
    }
  ],
  "route": [
    {
      "lat": 37.7749,
      "lon": -122.4194,
      "altitude": 50.5,
      "timestamp": "2024-02-06 07:00:00 -0800"
    }
  ]
}

वर्कआउट मेट्रिक्स समय समूहीकरण

निर्यात संस्करण 2 का उपयोग करते समय और "वर्कआउट मेट्रिक्स शामिल करें" सक्षम होने पर, आप समय-श्रृंखला डेटा की सूक्ष्मता को नियंत्रित कर सकते हैं:

मिनट: मिनट अंतराल द्वारा वर्कआउट मेट्रिक्स को समूहित करता है
सेकंड: सेकंड अंतराल द्वारा वर्कआउट मेट्रिक्स को समूहित करता है (अधिक विस्तृत, बड़ा फ़ाइल आकार)

सुझाव

मार्ग डेटा शामिल करें: आउटडोर वर्कआउट के लिए GPS मार्ग जानकारी प्राप्त करने के लिए इस विकल्प को सक्षम करें
वर्कआउट मेट्रिक्स शामिल करें: हृदय गति, शक्ति और कैडेंस जैसे मेट्रिक्स के लिए विस्तृत समय-श्रृंखला डेटा प्राप्त करने के लिए इसे सक्षम करें
निर्यात संस्करण: सबसे व्यापक डेटा संरचना के लिए संस्करण 2 का उपयोग करें
GPX निर्यात: मार्ग डेटा को मैपिंग एप्लिकेशन में उपयोग के लिए अलग GPX फ़ाइलों के रूप में भी निर्यात किया जा सकता है