Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card

Samsung Health do FHIR

Dane z Galaxy Watch przez Health Connect lub Samsung Health Data SDK: porównanie, zgoda partnera, tryb deweloperski i mapowanie FHIR.

Dane z Galaxy Watch i Galaxy Ring są rejestrowane przez aplikację Samsung Health na telefonie i istnieją dwa sposoby ich odczytu: przez Health Connect, gdzie Samsung Health eksportuje podzbiór danych według własnego harmonogramu, lub bezpośrednio za pomocą Samsung Health Data SDK, który odczytuje wszystko, co pokazuje Samsung Health, ale wymaga zatwierdzenia partnera firmy Samsung przed publikacją aplikacji. Niezależnie od wybranej ścieżki, wartości stają się FHIR R4 Observations w ten sam sposób, co dane z Apple Health lub Health Connect. Ta strona porównuje obie ścieżki z pomiarem z rzeczywistego telefonu i wyjaśnia, czego wymaga każda z nich.

Dwie ścieżki

Źródła: Przegląd Samsung Health Data SDK i proces.

Co zmierzyliśmy na telefonie Galaxy

Podczas tworzenia Anpheros Daily porównaliśmy obie ścieżki na telefonie Galaxy S26 Ultra sparowanym z zegarkiem Galaxy Watch, w tym samym momencie 27 września 2026 r.:

Samsung Health miał wszystkie uprawnienia zapisu w Health Connect; po prostu eksportował mniej i później. To jeden telefon i jeden dzień, a nie reguła, ale zgadza się z tym, co zgłaszają użytkownicy: jeśli Twoi użytkownicy mają zegarki Galaxy i widzą różne liczby w Twojej aplikacji i w Samsung Health, przyczyną jest prawdopodobnie ścieżka Health Connect, a aplikacja nie może zmusić Samsung Health do częstszego eksportu.

Testowanie z użyciem SDK przed zatwierdzeniem

Samsung Health Data SDK sprawdza w firmie Samsung, czy Twoja aplikacja (nazwa pakietu i certyfikat podpisu) została zatwierdzona. Przed zatwierdzeniem:

1. Na telefonie testowym otwórz Samsung Health › Ustawienia › Informacje o Samsung Health i wielokrotnie dotknij numeru wersji, aż pojawią się opcje deweloperskie, a następnie włącz tryb deweloperski dla Samsung Health Data SDK.
2. Twoja aplikacja będzie mogła wtedy odczytywać dane z tego telefonu. Bez trybu deweloperskiego SDK odrzuci żądanie z błędem autoryzacji, dlatego należy zapewnić mechanizm zastępczy dla Health Connect.

Tryb deweloperski służy wyłącznie do testowania i nie należy prosić użytkowników o jego włączenie. Aby opublikować aplikację, złóż wniosek partnerski do firmy Samsung; po zatwierdzeniu firma Samsung zarejestruje Twój pakiet i podpis.

Od Samsung Health do FHIR

Mapowanie jest takie samo jak dla innych repozytoriów danych zdrowotnych:

Dwie kwestie są istotne. SDK Samsung Health Data zwraca poziom glukozy we krwi w mmol/L; należy go przeliczyć (Anpheros Daily przechowuje dane w mg/dL) lub zachować jednostkę zgodnie z raportem, ale nigdy nie mieszać jednostek pod jednym kodem. Temperatura nadgarstka lub skóry nie jest temperaturą ciała: zapisanie jej pod kodem 8310-5 wprowadziłoby w błąd każdego, kto odczyta rekord.

Należy utworzyć jedną obserwację (Observation) na osobę, metrykę i dzień, oznaczoną jako dane urządzenia, i zaktualizować ją, gdy ten sam dzień zostanie ponownie zsynchronizowany. Kod backendowy, uruchamiany na platformie, znajduje się w Wearable data in FHIR.

Wybór ścieżki

• Większość aplikacji: zacznij od Health Connect. Integruje się z Samsungiem i wszystkimi innymi dostawcami Androida za pomocą jednej integracji, a luki dotyczą zachowania eksportu Samsung Health, a nie Twojego kodu.
• Aplikacje, w których dane Galaxy Watch muszą dokładnie odpowiadać Samsung Health (wyzwania krokowe, trendy tętna, które ludzie porównują z aplikacją Samsung): dodaj Samsung Health Data SDK na urządzeniach Samsung, aplikuj wcześnie o partnerstwo i zachowaj Health Connect jako rozwiązanie zastępcze. Odczytuj każdy typ tylko z jednego źródła, w przeciwnym razie rekord będzie zawierał duplikaty.

Gdzie Anpheros się mieści

Platforma Anpheros przechowuje wynik — każdą wartość jako obserwację FHIR R4 oznaczoną jako dane urządzenia, z zgodą, pochodzeniem i dziennikiem dostępu — i nie odczytuje bezpośrednio Samsung Health. Własna aplikacja Anpheros, Anpheros Daily, odczytuje dane Samsung Health na Androidzie za pośrednictwem Health Connect, jak opisano powyżej.

Najczęściej zadawane pytania

Czy Samsung Health synchronizuje się z Health Connect?

Tak, Samsung Health zapisuje dane do Health Connect, gdy użytkownik na to zezwoli, ale eksportuje podzbiór typów danych i według własnego harmonogramu, więc Health Connect może mieć opóźnienia lub pomijać typy danych widoczne w Samsung Health.

Czy istnieje REST API dla Samsung Health?

Nie ma publicznego REST ani web API do odczytu danych Samsung Health użytkownika. Dane są odczytywane na telefonie, za pośrednictwem Health Connect lub Samsung Health Data SDK, a Twoja aplikacja wysyła je na serwer.

Czy potrzebuję zgody firmy Samsung, aby używać Samsung Health Data SDK?

Aby opublikować aplikację, tak: firma Samsung wymaga zgłoszenia partnerskiego przed dystrybucją i rejestruje zatwierdzoną aplikację. Do celów deweloperskich tryb deweloperski Samsung Health pozwala na działanie SDK na telefonie testowym.

Czy mogę odczytywać dane z Galaxy Watch na iPhonie?

Galaxy Watch jest przeznaczony dla telefonów z systemem Android i zapisuje dane w Samsung Health na tym urządzeniu; nie ma obsługiwanej ścieżki z Galaxy Watch do Apple Health.

Dlaczego kroki z Galaxy Watch są niższe w mojej aplikacji niż w Samsung Health?

Jeśli odczytujesz dane za pośrednictwem Health Connect, Samsung Health mógł jeszcze nie wyeksportować swoich najnowszych danych. Odczytywanie zagregowanej sumy z Health Connect, synchronizacja po otwarciu aplikacji i, tam gdzie to istotne, dodanie Samsung Health Data SDK zmniejszają różnicę.

Powiązane

• Dane z urządzeń noszonych w FHIR: tabela mapowania i kod backendowy
• Health Connect do FHIR
• Apple Health (HealthKit) do FHIR
• Jak zbudować aplikację osobistej dokumentacji medycznej

Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card