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 (не эмулятор) |
| Перед публикацией | Проверка Google Play декларации Health Connect | Запрос и одобрение от партнера 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