Apple HealthのエクスポートをCSVとJSONに変換
ヘルスケアアプリから書き出したexport.zipを選ぶと、スプレッドシートにそのまま使えるファイルが手に入ります。全指標の日ごとの合計、睡眠などのカテゴリの1日あたりの分数、すべてのワークアウト、選んだ指標の生のレコードです。無料で、すべてこのブラウザ内で動きます。このページにはネットワークリクエストを行う権限がないので、健康データがパソコンの外に出ることはありません。
変換したファイル
1つの指標のすべてのレコード
たとえば心拍数は、1日に数千件のサンプルになります。指標を選ぶと、サンプルごとに値、ソース、時刻を並べたCSVが作れます。
エクスポートに含まれるもの
iPhoneからexport.zipを取り出すには?
- ヘルスケアアプリを開き、右上の自分の写真またはイニシャルをタップします。
- 下にあるすべてのヘルスケアデータを書き出すをタップし、続けて書き出すをタップします。.
- ファイルが作られるまで待ちます。何年分ものデータだと、数分かかることがあります。
export.zipをAirDropでパソコンに送るか、「ファイル」に保存して、iPhoneのSafariでこのページを開きます。
大きなエクスポートはパソコンで扱うのがおすすめです。数ギガバイトのエクスポートでは、スマホのブラウザはメモリ不足になることがあります。
各ファイルの中身は?
| ファイル | 1行の単位 | 列 |
|---|---|---|
apple-health-daily-metrics.csv | 日、指標、ソース、単位 | date, type, source, unit, samples, sum, average, min, max |
apple-health-daily-categories.csv | 日、カテゴリ、ソース、値 | date, type, source, value(睡眠の場合:InBed, AsleepCore, AsleepDeep, AsleepREM, Awake), samples, minutes |
apple-health-workouts.csv | ワークアウト | start, end, activity, minutes, source, distance, distance unit, active energy, energy unit, average heart rate |
apple-health-summary.json | 上のすべて | 同じ行をJSONにしたものと、すべてのタイプについてレコード数と日付範囲をまとめた一覧 |
apple-health-<metric>.csv | サンプル(選んだ指標) | type, source, unit, value, start, end |
日付は、各サンプルが始まった日で、iPhoneが記録したタイムゾーンで表されます。タイプ名からはAppleの接頭辞が取り除かれるので、HKQuantityTypeIdentifierStepCountはStepCountになります。1日で積み上がるもの(歩数、距離、アクティブエネルギー、食事の栄養素)にはsumを、測定値(心拍数、体重、血中酸素)にはaverage、min、maxを使います。
歩数がヘルスケアアプリより多いのはなぜ?
iPhoneとApple Watchの両方が歩数を数え、Apple Healthは両方のサンプルを保存しているためです。ヘルスケアアプリは、重なる場合に片方のソースを優先して、1つの合計を表示します。エクスポートではその処理はされないので、このコンバーターは、ソースごとに別の行のまま残し、足し合わせません。1日の歩数を知りたいときは、足し合わせた値ではなく、1つのソース(たいていはApple Watch)の行か、2つのうち大きいほうを使ってください。
データはアップロードされますか?
いいえ。このコンバーターは、パソコン上で動く2つのスクリプトです(ページとパーサー。どちらも読めます)。このページはすべてのネットワーク接続を遮断するセキュリティポリシーで配信されているので、不具合があってもファイルがどこかに送られることはありません。アクセス解析もありません。ページを読み込んだ後でWi-Fiをオフにしても、同じように動きます。
どのくらい大きなエクスポートまで扱えますか?
数ギガバイトまで扱えます。zipを丸ごと読み込まずにストリームとして読むので、export.xmlがどれほど大きくても、メモリ使用量は低く保たれます。Appleが大きなエクスポートで使うラージファイル形式(zip64)にも対応しています。テストでは、1.1 GB(400万件以上のレコード)のエクスポートが約20秒で終わりました。最新のSafari(16.4以降)、Chrome、Edge、Firefoxが必要です。
毎回エクスポートせずに使いたいですか?
ヘルスケアアプリのエクスポートは、そのたびにゼロから作り直されるフルバックアップです。Marrow HealthはiPhone上でApple Healthを直接読み取るので、好きなタイミングで、どの指標もCSVかJSONで、ワークアウトのルートはGPXでエクスポートできます。日ごとの合計はAppleの集計と突き合わせて調整されます(歩数の二重カウントなし)。スケジュールを決めてデータをURLに送ったり、AIに読ませたりもできます。どれも無料です。
選択肢について詳しくは:Apple Healthデータをエクスポートするすべての方法、スケジュールエクスポート、AIエージェントにアクセスを許可する方法.