# Samsung Health a FHIR

> Dati Galaxy Watch tramite Health Connect o Samsung Health Data SDK: un confronto reale, approvazione partner, modalità sviluppatore e mapping FHIR.

Source: https://developers.anpheros.com/it/guides/samsung-health-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](https://developer.samsung.com/health/data/overview.html) e [processo](https://developer.samsung.com/health/data/process.html).

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

1. 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**.
2. 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](https://developers.anpheros.com/it/guides/wearable-data-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](https://developers.anpheros.com/it/guides/wearable-data-fhir): la tabella di mappatura e il codice backend
- [Health Connect a FHIR](https://developers.anpheros.com/it/guides/health-connect-fhir)
- [Apple Health (HealthKit) a FHIR](https://developers.anpheros.com/it/guides/apple-health-fhir)
- [Come creare un'app di cartella clinica personale](https://developers.anpheros.com/it/guides/personal-health-record-app)
