ワークアウト - JSON エクスポート形式
JSON エクスポートにおけるワークアウト構造のドキュメント
最終更新: 2026年10月31日
このページの内容
JSON エクスポートはワークアウトを workouts 配列に保存します。
エクスポートバージョン
Health Auto Export は 2 つのワークアウトエクスポートバージョンをサポートします:
- バージョン 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(文字列): ワークアウトの一意の識別子name(文字列): ワークアウトの種類名(例: "Running"、"Cycling"、"Swimming")start(日付):yyyy-MM-dd HH:mm:ss Z形式のワークアウト開始時刻end(日付):yyyy-MM-dd HH:mm:ss Z形式のワークアウト終了時刻duration(数値): 秒単位のワークアウト時間
任意フィールド
任意フィールドは利用可能なデータとエクスポート選択によって異なります:
記録ソース
{
"source": {
"name": "Workout App",
"identifier": "com.example.workouts"
}
}
source(オブジェクト): ワークアウトを記録したアプリまたはデバイス。名前とアプリ識別子を持ちます。個別の指標測定には別のソース文字列があり、別のアプリまたはデバイスからの場合があります。
場所情報
{
"location": "Outdoor",
"isIndoor": false
}
location(文字列):"Indoor"、"Outdoor"、"Pool"、"Open Water"のいずれかisIndoor(真偽値): ワークアウトが屋内で行われたか
エネルギーと強度
{
"activeEnergyBurned": {
"qty": 350,
"units": "kcal"
},
"totalEnergy": {
"qty": 450,
"units": "kcal"
},
"intensity": {
"qty": 8.5,
"units": "kcal/hr\u00b7kg"
}
}
activeEnergyBurned(オブジェクト): ワークアウト中に消費したアクティブカロリーtotalEnergy(オブジェクト): 消費した総カロリー(アクティブ + 安静)intensity(オブジェクト): 代謝当量(MET)の値
距離と速度
{
"distance": {
"qty": 3.5,
"units": "mi"
}
}
distance(オブジェクト): 総移動距離speed(オブジェクト): 距離と時間から計算した平均速度avgSpeed(オブジェクト): ワークアウト全体の平均速度maxSpeed(オブジェクト): 到達した最高速度
各オブジェクトには qty と units が含まれます。
標高
{
"elevationUp": {
"qty": 500,
"units": "ft"
},
"elevationDown": {
"qty": 450,
"units": "ft"
}
}
elevationUp(オブジェクト): 総上昇標高elevationDown(オブジェクト): 総下降標高
単位: "ft"(フィート)または "m"(メートル)
環境データ
{
"temperature": {
"qty": 72,
"units": "degF"
},
"humidity": {
"qty": 65,
"units": "%"
}
}
temperature(オブジェクト): ワークアウト中の周囲温度humidity(オブジェクト): 相対湿度の割合
温度単位: "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(オブジェクト): 各ラップの長さstrokeStyle(文字列): 次のいずれか:"Backstroke""Breaststroke""Butterfly""Freestyle""Mixed""Kickboard""Unknown"
swolfScore(数値): 水泳効率スコアsalinity(文字列):"Fresh Water"または"Salt Water"totalSwimmingStrokeCount(オブジェクト): 総ストローク数swimCadence(オブジェクト): 1 分あたりのストローク数
ステップとケイデンスデータ
{
"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(配列): 時間経過に伴う歩数測定の配列stepCadence(オブジェクト): 1 分あたりの歩数flightsClimbed(オブジェクト): 登った階段の階数
心拍数データ
{
"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(オブジェクト): ワークアウト中の最小、平均、最大心拍数の要約maxHeartRate(オブジェクト): ワークアウト中の最大心拍数avgHeartRate(オブジェクト): ワークアウト中の平均心拍数heartRateData(配列): ワークアウトからの詳細な測定。ワークアウト終了時に終わりますheartRateRecovery(配列): ワークアウト終了直後の 2 分間からの別の測定
要約心拍数は、利用可能な場合は記録されたワークアウト値を使い、なければワークアウトの心拍数測定にフォールバックします。エクスポートされた測定には一時停止中の測定が含まれるため、ピークと平均は要約と異なる場合があります。
時系列データ配列
「ワークアウト指標を含める」が有効な場合、多くの指標を時系列配列として含められます:
{
"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(日付): 測定のタイムスタンプqty(数値): 数量の値units(文字列): 測定単位source(文字列、任意): データソースのデバイスまたはアプリ
HeartRateData 構造:
date(日付): 測定のタイムスタンプMin(数値): 最小心拍数Avg(数値): 平均心拍数Max(数値): 最大心拍数units(文字列): 単位(単位をローカライズがオフの場合はcount/min)source(文字列、任意): データソースのデバイスまたはアプリ
ルートデータ
「ルートデータを含める」が有効で、ワークアウトに 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(数値): GPS 緯度座標longitude(数値): GPS 経度座標altitude(数値): メートル単位の標高course(数値): 進行方向(度、0–360)courseAccuracy(数値): コース測定の精度(度)horizontalAccuracy(数値): 水平位置の精度(メートル)verticalAccuracy(数値): 垂直位置の精度(メートル)timestamp(日付): 位置が記録された時刻speed(数値): メートル毎秒の速度speedAccuracy(数値): 速度測定の精度(m/s)
メタデータ
{
"metadata": {
"customField": {
"label": "value",
"quantity": 123
},
"anotherField": [
1,
2,
3
]
}
}
metadata(オブジェクト): ワークアウトに関連する追加のカスタムメタデータ
イベント、アクティビティ、スプリット
バージョン 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"
}
]
}