# Samsung Health から FHIR へ

> Health Connect または Samsung Health Data SDK を介した Galaxy Watch データ：実際の比較、パートナー承認、開発者モード、および FHIR マッピング。

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

**Galaxy Watch および Galaxy Ring のデータは、スマートフォンの Samsung Health アプリによって記録されます。このデータを読み取る方法は 2 つあります。1 つは Health Connect を介する方法で、Samsung Health が独自のスケジュールでサブセットをエクスポートします。もう 1 つは Samsung Health Data SDK を直接使用する方法で、Samsung Health が表示するすべてのものを読み取りますが、アプリを公開するには Samsung のパートナー承認が必要です。** どちらのパスを選択した場合でも、値は Apple Health または Health Connect データと同様に FHIR R4 Observations になります。このページでは、実際のスマートフォンからの測定値を使用して 2 つのパスを比較し、それぞれに必要なものを説明します。

## 2つのパス

| | 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 用に 1 つの統合 | いいえ: Samsung デバイスのみ |

出典: [Samsung Health Data SDK の概要](https://developer.samsung.com/health/data/overview.html) および [プロセス](https://developer.samsung.com/health/data/process.html)。

## Galaxy Phoneで測定したこと

Anpheros Dailyを開発中に、2026年9月27日の同時刻に、Galaxy WatchとペアリングされたGalaxy S26 Ultraで2つのパスを比較しました。

| ソース | その日の歩数 | その他の利用可能なデータ |
|---|---|---|
| Samsung Healthアプリ (画面上) | 4,566 | 心拍数、睡眠、血中酸素 |
| Health Connect、Samsung Healthによって書き込まれたデータ | 3,211 | なし: 歩数のみがエクスポートされており、最後のバッチは約90分前でした |
| Samsung Health Data SDK | 4,566 | その日テストされたデータ型は歩数でした。その後のテストでは、心拍数、睡眠、ワークアウトも同様の方法で読み取りました |

Samsung HealthはHealth Connectのすべての書き込み権限を持っていましたが、単にエクスポートする量が少なく、タイミングも遅れていました。これは1台の電話と1日のデータであり、規則ではありませんが、ユーザーが報告していることと一致しています。もしユーザーがGalaxy Watchを使用しており、アプリと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 |
|---|---|---|
| ステップ数（1日の合計） | 41950-7 | `{steps}` |
| 心拍数（1日の平均、最小、最大） | 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` |

2つの詳細が重要です。Samsung Health Data SDK は血糖値を mmol/L で返しますが、変換するか（Anpheros Daily は mg/dL で保存します）、報告された単位のままにする必要があります。ただし、1つのコードの下で単位を混在させることは絶対にしないでください。また、手首または皮膚の温度は体温ではありません。8310-5 の下に記録すると、レコードを読む人を誤解させます。

人、メトリック、および日ごとに1つの Observation を作成し、デバイスデータとしてマークし、同じ日が再度同期されたときに更新します。プラットフォームに対して実行されるバックエンドコードは、[Wearable data in FHIR](https://developers.anpheros.com/ja/guides/wearable-data-fhir) にあります。

## パスの選択

- **ほとんどのアプリ:** Health Connect から開始します。これにより、Samsung と他のすべての Android ベンダーに対して 1 つの統合で対応でき、ギャップはコードではなく Samsung Health のエクスポート動作にあります。
- **Galaxy Watch のデータを Samsung Health と完全に一致させる必要があるアプリ** (ステップチャレンジ、Samsung アプリと比較する心拍数トレンドなど): Samsung デバイスで Samsung Health Data SDK を追加し、早期にパートナーシップを申請し、フォールバックとして Health Connect を維持します。重複レコードが発生しないように、各タイプは 1 つのソースからのみ読み取ってください。

## Anpheros の位置づけ

Anpheros Platform は、結果を FHIR R4 Observation として保存します。各値はデバイスデータとしてマークされ、同意、来歴、アクセスログが付与されます。Anpheros は 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 または Web 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/ja/guides/wearable-data-fhir): マッピングテーブルとバックエンドコード
- [Health Connect から FHIR へ](https://developers.anpheros.com/ja/guides/health-connect-fhir)
- [Apple Health (HealthKit) から FHIR へ](https://developers.anpheros.com/ja/guides/apple-health-fhir)
- [個人健康記録アプリの構築方法](https://developers.anpheros.com/ja/guides/personal-health-record-app)
