Apple Health 내보내기를 CSV와 JSON으로 변환하기
건강 앱에서 받은 export.zip을 고르면 스프레드시트에 바로 쓸 수 있는 파일을 돌려받아요. 지표별 일일 합계, 수면 등 범주형 항목의 하루 분 단위 기록, 모든 운동, 그리고 고른 지표의 원본 기록이에요. 무료이고 이 브라우저 안에서만 실행돼요. 이 페이지는 네트워크 요청을 할 수 없게 되어 있어서 건강 데이터가 내 컴퓨터 밖으로 나가지 않아요.
내 파일
한 지표의 모든 기록
예를 들어 심박수는 하루에 수천 개의 샘플로 나와요. 지표를 고르면 각 샘플과 출처, 시간이 담긴 CSV를 받아요.
내보내기에 들어 있는 것
iPhone에서 export.zip은 어떻게 받나요?
- 건강 앱을 열고 오른쪽 위의 사진이나 이니셜을 탭하세요.
- 맨 아래의 모든 건강 데이터 내보내기를 탭한 다음 내보내기를 탭하세요.
- 파일을 만드는 동안 기다리세요. 데이터가 수년 치라면 몇 분이 걸릴 수 있어요.
- AirDrop으로
export.zip을 컴퓨터에 보내거나, 파일 앱에 저장한 뒤 iPhone의 Safari에서 이 페이지를 여세요.
용량이 큰 내보내기는 컴퓨터에서 하는 게 더 좋아요. 수 기가바이트짜리 내보내기는 휴대폰 브라우저에서 메모리가 부족해질 수 있어요.
각 파일에는 무엇이 들어 있나요?
| 파일 | 한 행의 단위 | 열 |
|---|---|---|
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 |
날짜는 각 샘플이 시작된 날이며, 휴대폰이 기록한 시간대를 따라요. 유형 이름에서는 Apple의 접두사가 빠지므로 HKQuantityTypeIdentifierStepCount는 StepCount가 돼요. 하루 동안 더해지는 값(걸음 수, 거리, 활동 에너지, 식이 영양소)에는 sum을, 측정값(심박수, 체중, 혈중 산소)에는 average, min, max를 쓰세요.
걸음 수가 건강 앱보다 더 높게 나오는 이유는 뭔가요?
iPhone과 Apple Watch가 둘 다 걸음을 세고, Apple Health가 두 샘플을 모두 보관하기 때문이에요. 건강 앱은 샘플이 겹칠 때 한 출처를 우선해서 합계를 하나만 보여 줘요. 내보내기 파일에는 그 작업이 되어 있지 않아서, 이 변환기는 출처별로 행을 따로 두고 더하지 않아요. 하루 걸음 수가 필요하면 합계 대신 한 출처(보통 워치)의 행을 쓰거나 두 값 중 높은 쪽을 쓰세요.
내 데이터가 업로드되나요?
아니요. 변환기는 내 컴퓨터에서 실행되는 스크립트 두 개예요(페이지와 파서, 둘 다 읽어볼 수 있어요). 이 페이지는 모든 네트워크 연결을 막는 보안 정책과 함께 제공되므로 버그가 있더라도 파일이 어디로도 전송될 수 없고, 분석 도구도 없어요. 페이지를 불러온 뒤 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 에이전트에 접근 권한 주기.