Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card
Samsung Health та FHIR
Дані Galaxy Watch через Health Connect або Samsung Health Data SDK: реальне порівняння, схвалення партнера, режим розробника та відображення FHIR.
Дані Galaxy Watch та Galaxy Ring записуються додатком Samsung Health на телефоні, і є два способи їх прочитати: через Health Connect, куди Samsung Health експортує підмножину за власним розкладом, або безпосередньо за допомогою Samsung Health Data SDK, який читає все, що показує Samsung Health, але потребує схвалення партнера від Samsung перед публікацією додатка. Який би шлях ви не обрали, значення стають FHIR R4 Observations так само, як і дані Apple Health або Health Connect. Ця сторінка порівнює два шляхи з вимірюванням з реального телефону та пояснює, що вимагає кожен з них.
Два шляхи
| Через 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 та процес.
Що ми виміряли на телефоні Galaxy
Під час розробки Anpheros Daily ми порівняли два шляхи на Galaxy S26 Ultra, підключеному до Galaxy Watch, одночасно 27 вересня 2026 року:
| Джерело | Кроки за день | Інші доступні типи |
|---|---|---|
| Додаток 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, чи затверджено ваш додаток (назва пакета та сертифікат підпису). До затвердження:
- На тестовому телефоні відкрийте Samsung Health › Налаштування › Про Samsung Health і багаторазово торкніться номера версії, доки не з'являться параметри розробника, а потім увімкніть режим розробника для Samsung Health Data SDK.
- Після цього ваш додаток зможе читати дані на цьому телефоні. Без режиму розробника 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 з 8480-6 та 8462-4 | mm[Hg] |
| Рівень глюкози в крові | 2339-0 | mg/dL |
| Вага тіла | 29463-7 | kg |
| Температура шкіри | немає загального коду LOINC для температури зап'ястя; використовуйте власний код і не позначайте його як температуру тіла | Cel |
Важливі дві деталі. Samsung Health Data SDK повертає рівень глюкози в крові в ммоль/л; конвертуйте його (Anpheros Daily зберігає в мг/дл) або збережіть одиницю вимірювання, як зазначено, але ніколи не змішуйте одиниці під одним кодом. І температура зап'ястя або шкіри не є температурою тіла: запис її під кодом 8310-5 введе в оману будь-кого, хто читатиме запис.
Створюйте один Observation на людину, метрику та день, позначений як дані пристрою, і оновлюйте його, коли той самий день синхронізується знову. Бекенд-код, що працює на платформі, знаходиться за адресою Wearable data in FHIR.
Вибір шляху
- Більшість додатків: починайте з Health Connect. Він охоплює Samsung та всіх інших постачальників Android одним інтеграційним рішенням, а прогалини стосуються поведінки експорту Samsung Health, а не вашого коду.
- Додатки, де дані Galaxy Watch повинні точно відповідати Samsung Health (змагання зі кроків, тенденції серцевого ритму, які люди порівнюють із додатком Samsung): додайте Samsung Health Data SDK на пристроях Samsung, подайте заявку на партнерство заздалегідь і використовуйте Health Connect як резервний варіант. Читайте кожен тип лише з одного джерела, інакше запис матиме дублікати.
Місце Anpheros
Платформа Anpheros зберігає результат — кожне значення як FHIR R4 Observation, позначене як дані пристрою, з дозволом, походженням та журналом доступу — і не читає Samsung Health самостійно. Власний додаток Anpheros, Anpheros Daily, читає дані Samsung Health на Android через Health Connect, як описано вище.
Часті запитання
Чи синхронізується Samsung Health із Health Connect?
Так, Samsung Health записує дані до Health Connect, якщо користувач це дозволяє, але експортує лише підмножину типів даних за власним розкладом, тому Health Connect може відставати або пропускати типи даних, які відображаються в Samsung Health.
Чи існує REST API для Samsung Health?
Немає загальнодоступного REST або веб-API для читання даних Samsung Health користувача. Дані читаються на телефоні через Health Connect або Samsung Health Data SDK, а ваш додаток надсилає їх на сервер.
Чи потрібен дозвіл Samsung для використання Samsung Health Data SDK?
Для публікації — так: Samsung вимагає запит від партнера перед розповсюдженням та реєструє схвалений додаток. Для розробки режим розробника Samsung Health дозволяє SDK працювати на тестовому телефоні.
Чи можу я читати дані з Galaxy Watch на iPhone?
Galaxy Watch розроблено для телефонів Android і записує дані в Samsung Health на них; немає підтримуваного шляху від Galaxy Watch до Apple Health.
Чому кроки з Galaxy Watch у моєму додатку нижчі, ніж у Samsung Health?
Якщо ви читаєте дані через Health Connect, Samsung Health, можливо, ще не експортував свої останні дані. Читання агрегованого загального підсумку Health Connect, синхронізація під час відкриття вашого додатку та, де це важливо, додавання Samsung Health Data SDK зменшують розрив.
Пов'язане
- Дані з носимих пристроїв у FHIR: таблиця відповідності та бекенд-код
- Health Connect до FHIR
- Apple Health (HealthKit) до FHIR
- Як створити додаток для особистої медичної картки
Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card