Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card
Samsung Health in FHIR
Dati da Galaxy Watch tramite Health Connect o Samsung Health Data SDK: confronto reale, approvazione partner, modalità sviluppatore e mappatura FHIR.
I dati di Galaxy Watch e Galaxy Ring sono registrati dall'app Samsung Health sul telefono e ci sono due modi per leggerli: tramite Health Connect, dove Samsung Health esporta un sottoinsieme secondo una propria pianificazione, o direttamente con il Samsung Health Data SDK, che legge tutto ciò che mostra Samsung Health ma necessita dell'approvazione partner di Samsung prima che un'app possa essere pubblicata. Qualunque sia il percorso scelto, i valori diventano FHIR R4 Observations allo stesso modo dei dati di Apple Health o Health Connect. Questa pagina confronta i due percorsi con una misurazione da un telefono reale e spiega cosa richiede ciascuno.
Due percorsi
| Tramite Health Connect | Samsung Health Data SDK | |
|---|---|---|
| Cosa leggi | Cosa Samsung Health sceglie di esportare su Health Connect | I dati in Samsung Health: passi, frequenza cardiaca, sonno, ossigeno nel sangue, pressione sanguigna, glicemia, composizione corporea, temperatura cutanea, esercizio fisico, nutrizione, acqua e altro |
| Freschezza | Quando Samsung Health esporta, il che può comportare un ritardo | Ciò che Samsung Health ha ora |
| Requisiti | Autorizzazioni di Health Connect, dichiarazione Play Console | Android 10 (API 29) o versioni successive, Samsung Health 6.30.2 o versioni successive, un dispositivo Samsung (nessun emulatore) |
| Prima della pubblicazione | Revisione di Google Play della dichiarazione di Health Connect | Richiesta e approvazione del partner Samsung; fino ad allora l'SDK funziona solo con la modalità sviluppatore di Samsung Health attiva |
| Stesso codice su altri telefoni | Sì: un'integrazione per Samsung, Pixel, Fitbit, Garmin, Oura | No: solo dispositivi Samsung |
Fonti: Panoramica di Samsung Health Data SDK e processo.
Cosa abbiamo misurato su un telefono Galaxy
Durante la creazione di Anpheros Daily, abbiamo confrontato i due percorsi su un Galaxy S26 Ultra accoppiato con un Galaxy Watch, nello stesso momento il 27 settembre 2026:
| Sorgente | Passi quel giorno | Altri dati disponibili |
|---|---|---|
| App Samsung Health (su schermo) | 4.566 | frequenza cardiaca, sonno, ossigeno nel sangue |
| Health Connect, dati scritti da Samsung Health | 3.211 | nessuno: solo i passi erano stati esportati, l'ultimo batch circa 90 minuti prima |
| Samsung Health Data SDK | 4.566 | i passi erano il tipo testato quel giorno; test successivi hanno letto frequenza cardiaca, sonno e allenamenti nello stesso modo |
Samsung Health aveva tutte le autorizzazioni di scrittura in Health Connect; semplicemente esportava meno e più tardi. Questo è un telefono e un giorno, non una regola, ma corrisponde a quanto riportano le persone: se i tuoi utenti hanno orologi Galaxy e vedono numeri diversi nella tua app e in Samsung Health, il percorso Health Connect è la causa probabile, e un'app non può forzare Samsung Health a esportare più frequentemente.
Testare con l'SDK prima dell'approvazione
Il Samsung Health Data SDK verifica con Samsung se la tua app (nome del pacchetto e certificato di firma) è approvata. Prima dell'approvazione:
- Sul telefono di test, apri Samsung Health › Impostazioni › Informazioni su Samsung Health e tocca ripetutamente il numero di versione finché non compaiono le opzioni sviluppatore, quindi attiva la modalità sviluppatore per il Samsung Health Data SDK.
- La tua app potrà quindi leggere i dati su quel telefono. Senza la modalità sviluppatore, l'SDK rifiuta con un errore di autorizzazione, quindi prevedi un fallback per Health Connect.
La modalità sviluppatore è solo per il test e non è qualcosa da chiedere agli utenti di abilitare. Per la pubblicazione, invia la richiesta di partnership a Samsung; dopo l'approvazione, Samsung registrerà il tuo pacchetto e la tua firma.
Da Samsung Health a FHIR
La mappatura è la stessa degli altri health store:
| Dati Samsung Health | LOINC | UCUM |
|---|---|---|
| Passi (totale giornaliero) | 41950-7 | {steps} |
| Frequenza cardiaca (media giornaliera, min, max) | 8867-4 | /min |
| Ossigeno nel sangue | 59408-5 | % |
| Durata e fasi del sonno | 93832-4; 93831-6, 93830-8, 93829-0 | min |
| Pressione sanguigna | 85354-9 con 8480-6 e 8462-4 | mm[Hg] |
| Glicemia | 2339-0 | mg/dL |
| Peso corporeo | 29463-7 | kg |
| Temperatura cutanea | nessun codice LOINC generale per la temperatura del polso; utilizzare un proprio codice e non etichettarlo come temperatura corporea | Cel |
Due dettagli sono importanti. Il Samsung Health Data SDK restituisce la glicemia in mmol/L; convertirla (Anpheros Daily memorizza mg/dL) o mantenere l'unità così come riportata, ma non mescolare mai unità diverse sotto lo stesso codice. E la temperatura del polso o cutanea non è temperatura corporea: scriverla sotto 8310-5 indurrebbe in errore chiunque legga il record.
Scrivere una Observation per persona, metrica e giorno, contrassegnata come dati del dispositivo, e aggiornarla quando lo stesso giorno viene sincronizzato nuovamente. Il codice backend, eseguito sulla piattaforma, si trova su Wearable data in FHIR.
Scegliere un percorso
- La maggior parte delle app: inizia con Health Connect. Copre Samsung e tutti gli altri produttori Android con una singola integrazione, e le lacune riguardano il comportamento di esportazione di Samsung Health, non il tuo codice.
- App in cui i dati di Galaxy Watch devono corrispondere esattamente a Samsung Health (sfide di passi, tendenze della frequenza cardiaca che le persone confrontano con l'app Samsung): aggiungi il Samsung Health Data SDK sui dispositivi Samsung, richiedi la partnership in anticipo e mantieni Health Connect come fallback. Leggi ogni tipo da un'unica fonte, altrimenti il record avrà duplicati.
Dove si inserisce Anpheros
La Piattaforma Anpheros memorizza il risultato — ogni valore come un'Osservazione FHIR R4 contrassegnata come dati del dispositivo, con consenso, provenienza e un registro degli accessi — e non legge Samsung Health direttamente. L'app di Anpheros, Anpheros Daily, legge i dati di Samsung Health su Android tramite Health Connect, come descritto sopra.
Domande frequenti
Samsung Health si sincronizza con Health Connect?
Sì, Samsung Health scrive su Health Connect quando l'utente lo consente, ma esporta un sottoinsieme di tipi e secondo una pianificazione propria, pertanto Health Connect potrebbe essere in ritardo o non includere tipi visualizzati da Samsung Health.
Esiste un'API REST di Samsung Health?
Nessuna API REST o web pubblica legge i dati di Samsung Health di un utente. I dati vengono letti sul telefono, tramite Health Connect o il Samsung Health Data SDK, e la tua app li invia a un server.
Ho bisogno dell'approvazione di Samsung per utilizzare il Samsung Health Data SDK?
Per la pubblicazione, sì: Samsung richiede una richiesta di partnership prima della distribuzione e registra l'app approvata. Per lo sviluppo, la modalità sviluppatore di Samsung Health consente all'SDK di funzionare su un telefono di test.
Posso leggere i dati di Galaxy Watch su un iPhone?
Galaxy Watch è progettato per telefoni Android e registra i dati su Samsung Health; non esiste un percorso supportato da Galaxy Watch ad Apple Health.
Perché i passi di Galaxy Watch nella mia app sono inferiori rispetto a Samsung Health?
Se leggi tramite Health Connect, Samsung Health potrebbe non aver ancora esportato i suoi dati più recenti. La lettura del totale aggregato di Health Connect, la sincronizzazione all'apertura della tua app e, dove è importante, l'aggiunta del Samsung Health Data SDK riducono il divario.
Correlati
- Dati indossabili in FHIR: la tabella di mappatura e il codice backend
- Health Connect a FHIR
- Apple Health (HealthKit) a FHIR
- Come creare un'app di cartella clinica personale
Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card