# Samsung Health do FHIR

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

Source: https://developers.anpheros.com/pl/guides/samsung-health-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

| | Przez Health Connect | Samsung Health Data SDK |
|---|---|---|
| Co odczytujesz | Dane, które Samsung Health wybiera do wyeksportowania do Health Connect | Dane w Samsung Health: kroki, tętno, sen, natlenienie krwi, ciśnienie krwi, poziom glukozy we krwi, skład ciała, temperatura skóry, ćwiczenia, odżywianie, woda i inne |
| Aktualność | Kiedy Samsung Health eksportuje dane, co może powodować opóźnienia | Dane, które Samsung Health posiada obecnie |
| Wymagania | Uprawnienia Health Connect, deklaracja w Play Console | Android 10 (API 29) lub nowszy, Samsung Health 6.30.2 lub nowszy, urządzenie Samsung (nie emulator) |
| Przed publikacją | Przegląd deklaracji Health Connect przez Google Play | **Wniosek do partnera Samsung i jego zatwierdzenie**; do tego czasu SDK działa tylko z włączonym trybem deweloperskim Samsung Health |
| Ten sam kod na innych telefonach | Tak: jedna integracja dla Samsung, Pixel, Fitbit, Garmin, Oura | Nie: tylko urządzenia Samsung |

Źródła: [Przegląd Samsung Health Data SDK](https://developer.samsung.com/health/data/overview.html) i [proces](https://developer.samsung.com/health/data/process.html).

## 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.:

| Źródło | Kroki tego dnia | Inne dostępne typy danych |
|---|---|---|
| Aplikacja Samsung Health (na ekranie) | 4 566 | tętno, sen, poziom tlenu we krwi |
| Health Connect, dane zapisane przez Samsung Health | 3 211 | brak: wyeksportowano tylko kroki, ostatnia partia około 90 minut wcześniej |
| Samsung Health Data SDK | 4 566 | kroki były typem testowanym tego dnia; późniejsze testy odczytały w ten sam sposób tętno, sen i treningi |

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:

| Dane Samsung Health | LOINC | UCUM |
|---|---|---|
| Kroki (dzienny łączny wynik) | 41950-7 | `{steps}` |
| Tętno (średnia dzienna, min, max) | 8867-4 | `/min` |
| Tlen we krwi | 59408-5 | `%` |
| Czas trwania i etapy snu | 93832-4; 93831-6, 93830-8, 93829-0 | `min` |
| Ciśnienie krwi | 85354-9 z 8480-6 i 8462-4 | `mm[Hg]` |
| Poziom glukozy we krwi | 2339-0 | `mg/dL` |
| Masa ciała | 29463-7 | `kg` |
| Temperatura skóry | brak ogólnego kodu LOINC dla temperatury nadgarstka; użyj własnego kodu i nie oznaczaj go jako temperatura ciała | `Cel` |

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](https://developers.anpheros.com/pl/guides/wearable-data-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](https://developers.anpheros.com/pl/guides/wearable-data-fhir): tabela mapowania i kod backendowy
- [Health Connect do FHIR](https://developers.anpheros.com/pl/guides/health-connect-fhir)
- [Apple Health (HealthKit) do FHIR](https://developers.anpheros.com/pl/guides/apple-health-fhir)
- [Jak zbudować aplikację osobistej dokumentacji medycznej](https://developers.anpheros.com/pl/guides/personal-health-record-app)