# Samsung Health를 FHIR로

> Health Connect 또는 Samsung Health Data SDK를 통한 Galaxy Watch 데이터: 실제 비교, 파트너 승인, 개발자 모드 및 FHIR 매핑.

Source: https://developers.anpheros.com/ko/guides/samsung-health-fhir

**Galaxy Watch 및 Galaxy Ring 데이터는 휴대폰의 Samsung Health 앱에 기록되며, 이를 읽는 두 가지 방법이 있습니다. Samsung Health가 자체 일정에 따라 일부 데이터를 내보내는 Health Connect를 통하거나, Samsung Health에 표시되는 모든 것을 읽지만 앱 게시 전에 Samsung의 파트너 승인이 필요한 Samsung Health Data SDK를 직접 사용하는 방법입니다.** 어떤 경로를 선택하든 값은 Apple Health 또는 Health Connect 데이터와 동일한 방식으로 FHIR R4 Observations가 됩니다. 이 페이지에서는 실제 휴대폰 측정값을 사용하여 두 경로를 비교하고 각 경로에 필요한 사항을 설명합니다.

## 두 가지 경로

| | Health Connect 경유 | Samsung Health Data SDK |
|---|---|---|
| 읽을 수 있는 내용 | Samsung Health가 Health Connect로 내보내도록 선택한 내용 | Samsung Health의 데이터: 걸음 수, 심박수, 수면, 혈중 산소, 혈압, 혈당, 체성분, 피부 온도, 운동, 영양, 수분 등 |
| 최신성 | Samsung Health가 내보낼 때, 지연될 수 있음 | Samsung Health가 현재 보유한 데이터 |
| 요구 사항 | Health Connect 권한, Play Console 선언 | Android 10 (API 29) 이상, Samsung Health 6.30.2 이상, Samsung 기기 (에뮬레이터 제외) |
| 게시 전 | Health Connect 선언에 대한 Google Play 검토 | **Samsung 파트너 요청 및 승인**; 그때까지 SDK는 Samsung Health의 개발자 모드에서만 작동 |
| 다른 휴대폰에서도 동일한 코드 사용 | 예: Samsung, Pixel, Fitbit, Garmin, Oura에 대한 통합 하나 | 아니요: Samsung 기기만 해당 |

출처: [Samsung Health Data SDK 개요](https://developer.samsung.com/health/data/overview.html) 및 [프로세스](https://developer.samsung.com/health/data/process.html).

## Galaxy 휴대폰에서 측정한 내용

Anpheros Daily를 구축하면서 2026년 9월 27일 같은 시각에 Galaxy S26 Ultra와 Galaxy Watch를 페어링하여 두 가지 경로를 비교했습니다.

| 소스 | 해당 일의 걸음 수 | 사용 가능한 기타 데이터 |
|---|---|---|
| Samsung Health 앱 (화면) | 4,566 | 심박수, 수면, 혈중 산소 |
| Health Connect, Samsung Health에서 기록한 데이터 | 3,211 | 없음: 걸음 수만 내보내졌으며, 마지막 데이터는 약 90분 전 |
| Samsung Health Data SDK | 4,566 | 해당 일에 테스트한 데이터 유형은 걸음 수였으며, 이후 테스트에서는 심박수, 수면, 운동 데이터를 동일한 방식으로 읽었습니다. |

Samsung Health는 Health Connect에서 모든 쓰기 권한을 가지고 있었지만, 단순히 더 적은 데이터를 더 늦게 내보냈습니다. 이는 하나의 휴대폰과 하루에 대한 결과이며 규칙은 아니지만, 사용자들이 보고하는 내용과 일치합니다. 만약 사용자들이 Galaxy 워치를 사용하고 앱과 Samsung Health에서 다른 수치를 본다면, Health Connect 경로가 원인일 가능성이 높으며, 앱은 Samsung Health가 더 자주 데이터를 내보내도록 강제할 수 없습니다.

## 승인 전 SDK를 이용한 테스트

Samsung Health Data SDK는 Samsung에 앱(패키지 이름 및 서명 인증서)이 승인되었는지 확인합니다. 승인 전에는 다음 단계를 따르세요:

1. 테스트 폰에서 Samsung Health › 설정 › Samsung Health 정보로 이동하여 버전 번호를 반복해서 탭하여 개발자 옵션을 표시한 다음, **Samsung Health Data SDK용 개발자 모드**를 켭니다.
2. 그러면 앱에서 해당 폰의 데이터를 읽을 수 있습니다. 개발자 모드가 없으면 SDK는 권한 오류를 반환하므로 Health Connect로 대체 기능을 제공해야 합니다.

개발자 모드는 테스트 전용이며 사용자에게 활성화하도록 요청하는 기능이 아닙니다. 게시하려면 Samsung에 파트너 요청을 제출하십시오. 승인 후 Samsung에서 패키지와 서명을 등록합니다.

## Samsung Health에서 FHIR로

다른 건강 스토어와 동일한 매핑을 사용합니다.

| Samsung Health 데이터 | LOINC | UCUM |
|---|---|---|
| 걸음 수 (일일 총계) | 41950-7 | `{steps}` |
| 심박수 (일일 평균, 최저, 최고) | 8867-4 | `/min` |
| 혈중 산소 | 59408-5 | `%` |
| 수면 시간 및 단계 | 93832-4; 93831-6, 93830-8, 93829-0 | `min` |
| 혈압 | 85354-9 with 8480-6 and 8462-4 | `mm[Hg]` |
| 혈당 | 2339-0 | `mg/dL` |
| 체중 | 29463-7 | `kg` |
| 피부 온도 | 손목 온도에 대한 일반적인 LOINC 코드는 없습니다. 자체 코드를 사용하고 체온으로 표시하지 마십시오. | `Cel` |

두 가지 세부 사항이 중요합니다. Samsung Health Data SDK는 혈당을 mmol/L 단위로 반환합니다. 이를 변환하거나(Anpheros Daily는 mg/dL로 저장) 보고된 단위로 유지하되, 한 코드 아래에 단위를 혼합하지 마십시오. 또한 손목 또는 피부 온도는 체온이 아닙니다. 8310-5 아래에 기록하면 해당 기록을 읽는 모든 사람에게 오해를 줄 수 있습니다.

사람, 측정 항목 및 날짜별로 하나의 Observation을 작성하고 장치 데이터로 표시하며, 동일한 날짜가 다시 동기화될 때 업데이트하십시오. 플랫폼에서 실행되는 백엔드 코드는 [FHIR의 웨어러블 데이터](https://developers.anpheros.com/ko/guides/wearable-data-fhir)에 있습니다.

## 경로 선택

- **대부분의 앱:** Health Connect로 시작합니다. Health Connect는 삼성 및 기타 모든 Android 공급업체를 하나의 통합으로 지원하며, 격차는 코드 자체가 아닌 Samsung Health의 내보내기 동작에 있습니다.
- **Galaxy Watch 데이터가 Samsung Health와 정확히 일치해야 하는 앱** (단계별 챌린지, Samsung 앱과 비교하는 심박수 추세 등): 삼성 기기에 Samsung Health Data SDK를 추가하고, 파트너십을 조기에 신청하며, Health Connect를 대체 수단으로 유지합니다. 중복 레코드가 발생하지 않도록 각 유형은 하나의 소스에서만 읽으십시오.

## Anpheros의 역할

Anpheros Platform은 각 값을 동의, 출처, 접근 로그와 함께 기기 데이터로 표시된 FHIR R4 Observation으로 저장하며, Samsung Health 자체를 읽지는 않습니다. Anpheros 자체 앱인 **Anpheros Daily**는 위에서 설명한 대로 Health Connect를 통해 Android에서 Samsung Health 데이터를 읽습니다.

## 자주 묻는 질문

### Samsung Health는 Health Connect와 동기화되나요?
예, 사용자가 허용한 경우 Samsung Health는 Health Connect로 데이터를 작성합니다. 하지만 데이터 유형의 일부만 자체 일정에 따라 내보내므로 Health Connect의 데이터가 지연되거나 Samsung Health에 표시되는 데이터 유형을 놓칠 수 있습니다.

### Samsung Health REST API가 있나요?
개인의 Samsung Health 데이터를 읽을 수 있는 공개 REST 또는 웹 API는 없습니다. 데이터는 Health Connect 또는 Samsung Health Data SDK를 통해 휴대폰에서 읽히며, 앱은 이 데이터를 서버로 전송합니다.

### Samsung Health Data SDK를 사용하기 위해 Samsung의 승인이 필요한가요?
게시하려면 예: Samsung은 배포 전에 파트너 요청을 받고 승인된 앱을 등록합니다. 개발을 위해 Samsung Health의 개발자 모드를 사용하면 테스트 휴대폰에서 SDK를 작동시킬 수 있습니다.

### iPhone에서 Galaxy Watch 데이터를 읽을 수 있나요?
Galaxy Watch는 Android 휴대폰용으로 설계되었으며 해당 휴대폰의 Samsung Health에 기록됩니다. Galaxy Watch에서 Apple Health로의 지원되는 경로는 없습니다.

### 제 앱에서 Galaxy Watch 걸음 수가 Samsung Health보다 적은 이유는 무엇인가요?
Health Connect를 통해 데이터를 읽는 경우 Samsung Health가 최신 데이터를 아직 내보내지 않았을 수 있습니다. Health Connect의 집계된 총계를 읽고, 앱을 열 때 동기화하고, 중요한 경우 Samsung Health Data SDK를 추가하면 이러한 차이를 줄일 수 있습니다.

## 관련 자료

- [FHIR에서의 웨어러블 데이터](https://developers.anpheros.com/ko/guides/wearable-data-fhir): 매핑 테이블 및 백엔드 코드
- [Health Connect를 FHIR로](https://developers.anpheros.com/ko/guides/health-connect-fhir)
- [Apple Health (HealthKit)를 FHIR로](https://developers.anpheros.com/ko/guides/apple-health-fhir)
- [개인 건강 기록 앱 구축 방법](https://developers.anpheros.com/ko/guides/personal-health-record-app)