# Samsung Health para FHIR

> Dados do Galaxy Watch através do Health Connect ou do Samsung Health Data SDK: uma comparação real, aprovação de parceiro, modo de desenvolvedor e o mapeamento FHIR.

Source: https://developers.anpheros.com/pt/guides/samsung-health-fhir

**Os dados do Galaxy Watch e do Galaxy Ring são registados pela aplicação Samsung Health no telemóvel, e existem duas formas de os ler: através do Health Connect, onde o Samsung Health exporta um subconjunto de acordo com o seu próprio cronograma, ou diretamente com o Samsung Health Data SDK, que lê tudo o que o Samsung Health mostra, mas necessita de aprovação de parceiro da Samsung antes de uma aplicação poder ser publicada.** Independentemente do caminho que escolher, os valores tornam-se Observações FHIR R4 da mesma forma que os dados do Apple Health ou do Health Connect. Esta página compara os dois caminhos com uma medição de um telemóvel real e explica o que cada um requer.

## Dois caminhos

| | Através do Health Connect | Samsung Health Data SDK |
|---|---|---|
| O que lê | O que o Samsung Health escolhe exportar para o Health Connect | Os dados no Samsung Health: passos, frequência cardíaca, sono, oxigénio no sangue, pressão arterial, glicose no sangue, composição corporal, temperatura da pele, exercício, nutrição, água e mais |
| Frescura | Quando o Samsung Health exporta, o que pode ter atraso | O que o Samsung Health tem agora |
| Requisitos | Permissões do Health Connect, declaração na Play Console | Android 10 (API 29) ou posterior, Samsung Health 6.30.2 ou posterior, um dispositivo Samsung (sem emulador) |
| Antes de publicar | Revisão do Google Play da declaração do Health Connect | **Pedido e aprovação de parceiro Samsung**; até lá, o SDK funciona apenas com o modo de programador do Samsung Health ativado |
| Mesmo código noutros telemóveis | Sim: uma integração para Samsung, Pixel, Fitbit, Garmin, Oura | Não: apenas dispositivos Samsung |

Fontes: [Visão geral do Samsung Health Data SDK](https://developer.samsung.com/health/data/overview.html) e [processo](https://developer.samsung.com/health/data/process.html).

## O que medimos num telemóvel Galaxy

Ao desenvolver o Anpheros Daily, comparámos os dois caminhos num Galaxy S26 Ultra emparelhado com um Galaxy Watch, no mesmo momento em 27 de setembro de 2026:

| Fonte | Passos nesse dia | Outros tipos disponíveis |
|---|---|---|
| Aplicação Samsung Health (no ecrã) | 4.566 | frequência cardíaca, sono, oxigénio no sangue |
| Health Connect, dados escritos pela Samsung Health | 3.211 | nenhum: apenas os passos tinham sido exportados, o último lote cerca de 90 minutos antes |
| Samsung Health Data SDK | 4.566 | os passos foram o tipo testado nesse dia; testes posteriores leram a frequência cardíaca, o sono e os treinos da mesma forma |

A Samsung Health tinha todas as permissões de escrita no Health Connect; simplesmente exportou menos e mais tarde. Este é um telemóvel e um dia, não uma regra, mas corresponde ao que as pessoas relatam: se os seus utilizadores tiverem relógios Galaxy e virem números diferentes na sua aplicação e na Samsung Health, o caminho do Health Connect é a causa provável, e uma aplicação não pode forçar a Samsung Health a exportar com mais frequência.

## Testar com o SDK antes da aprovação

O Samsung Health Data SDK verifica com a Samsung se a sua aplicação (nome do pacote e certificado de assinatura) está aprovada. Antes da aprovação:

1. No telemóvel de teste, abra o Samsung Health › Definições › Acerca do Samsung Health e toque no número da versão repetidamente até que as opções de programador apareçam, depois ative o **modo de programador para o Samsung Health Data SDK**.
2. A sua aplicação poderá então ler dados nesse telemóvel. Sem o modo de programador, o SDK recusa com um erro de autorização, pelo que deve incluir uma alternativa para o Health Connect.

O modo de programador destina-se apenas a testes e não deve ser solicitado aos utilizadores para ativar. Para publicar, envie o pedido de parceria à Samsung; após a aprovação, a Samsung registará o seu pacote e assinatura.

## De Samsung Health para FHIR

O mapeamento é o mesmo que para as outras lojas de saúde:

| Dados Samsung Health | LOINC | UCUM |
|---|---|---|
| Passos (total diário) | 41950-7 | `{steps}` |
| Frequência cardíaca (média diária, min, max) | 8867-4 | `/min` |
| Oxigénio no sangue | 59408-5 | `%` |
| Duração e fases do sono | 93832-4; 93831-6, 93830-8, 93829-0 | `min` |
| Pressão arterial | 85354-9 com 8480-6 e 8462-4 | `mm[Hg]` |
| Glicose no sangue | 2339-0 | `mg/dL` |
| Peso corporal | 29463-7 | `kg` |
| Temperatura da pele | não há código LOINC geral para temperatura do pulso; use o seu próprio código e não o rotule como temperatura corporal | `Cel` |

Dois detalhes são importantes. O Samsung Health Data SDK retorna a glicose no sangue em mmol/L; converta-a (Anpheros Daily armazena mg/dL) ou mantenha a unidade conforme reportada, mas nunca misture unidades sob um mesmo código. E a temperatura do pulso ou da pele não é temperatura corporal: escrevê-la sob 8310-5 induziria em erro qualquer pessoa que lesse o registo.

Escreva uma Observation por pessoa, métrica e dia, marcada como dados de dispositivo, e atualize-a quando o mesmo dia for sincronizado novamente. O código de backend, executado na plataforma, encontra-se em [Wearable data in FHIR](https://developers.anpheros.com/pt/guides/wearable-data-fhir).

## Escolhendo um caminho

- **A maioria das aplicações:** comece com o Health Connect. Ele abrange a Samsung e todos os outros fornecedores Android com uma única integração, e as lacunas são o comportamento de exportação do Samsung Health, não o seu código.
- **Aplicações onde os dados do Galaxy Watch devem corresponder exatamente ao Samsung Health** (desafios de passos, tendências de frequência cardíaca que as pessoas comparam com a aplicação Samsung): adicione o Samsung Health Data SDK em dispositivos Samsung, candidate-se a parceria antecipadamente e mantenha o Health Connect como fallback. Leia cada tipo de uma única fonte, caso contrário, o registo terá duplicados.

## Onde o Anpheros se encaixa

A Plataforma Anpheros armazena o resultado — cada valor como uma Observação FHIR R4 marcada como dados de dispositivo, com consentimento, proveniência e um registo de acesso — e não lê o Samsung Health diretamente. A própria aplicação do Anpheros, **Anpheros Daily**, lê dados do Samsung Health no Android através do Health Connect, conforme descrito acima.

## Perguntas Frequentes

### O Samsung Health sincroniza com o Health Connect?
Sim, o Samsung Health escreve para o Health Connect quando o utilizador o permite, mas exporta um subconjunto de tipos e no seu próprio horário, pelo que o Health Connect pode ficar atrasado ou perder tipos que o Samsung Health exibe.

### Existe uma API REST do Samsung Health?
Nenhuma API REST ou web pública lê os dados do Samsung Health de um utilizador. Os dados são lidos no telemóvel, através do Health Connect ou do Samsung Health Data SDK, e a sua aplicação envia-os para um servidor.

### Preciso da aprovação da Samsung para usar o Samsung Health Data SDK?
Para publicar, sim: a Samsung solicita um pedido de parceria antes da distribuição e regista a aplicação aprovada. Para desenvolvimento, o modo de programador do Samsung Health permite que o SDK funcione num telemóvel de teste.

### Posso ler dados do Galaxy Watch num iPhone?
O Galaxy Watch foi concebido para telemóveis Android e regista os dados no Samsung Health nesse dispositivo; não existe um caminho suportado de um Galaxy Watch para o Apple Health.

### Porque é que os passos do Galaxy Watch são inferiores na minha aplicação do que no Samsung Health?
Se ler através do Health Connect, o Samsung Health pode ainda não ter exportado os seus dados mais recentes. Ler o total agregado do Health Connect, sincronizar quando a sua aplicação abre e, onde for relevante, adicionar o Samsung Health Data SDK reduz a diferença.

## Relacionado

- [Dados de wearables em FHIR](https://developers.anpheros.com/pt/guides/wearable-data-fhir): a tabela de mapeamento e o código de backend
- [Health Connect para FHIR](https://developers.anpheros.com/pt/guides/health-connect-fhir)
- [Apple Health (HealthKit) para FHIR](https://developers.anpheros.com/pt/guides/apple-health-fhir)
- [Como criar uma aplicação de registo de saúde pessoal](https://developers.anpheros.com/pt/guides/personal-health-record-app)