Históricos médicos

A plataforma Conexão Saúde oferece uma variedade de tipos de dados, principalmente relacionados a casos de uso de bem-estar e fitness. Assim, os apps no ecossistema Android podem compartilhar dados sem a necessidade de integrações de API individuais de alto custo.

O recurso Registros médicos amplia essa capacidade para incluir dados médicos básicos no formato Fast Healthcare Interoperability Resources (FHIR®). O FHIR é uma especificação global de código aberto que descreve o esquema e a semântica dos dados médicos publicados pela HL7 (Health Level Seven International).

Recursos de histórico médico na Conexão Saúde:

  • Uma API para aplicativos que gravam dados médicos.
  • Uma experiência de navegador voltada ao usuário para dados médicos armazenados na Conexão Saúde como novos tipos de dados médicos, além de permissões refinadas para permitir leituras downstream.
  • Uma API para aplicativos que leem dados médicos com base nas permissões concedidas pelo usuário.
Uma visão geral de como os registros médicos funcionam com a Conexão Saúde.
Figura 1. Como os registros médicos funcionam com a Conexão Saúde.

Limitações

Como essas APIs ainda estão em desenvolvimento, há algumas limitações e alguns componentes não estão totalmente disponíveis.

As APIs de registros médicos são marcadas com uma anotação de ExperimentalPersonalHealthRecordApi, que indica que elas ainda estão em desenvolvimento e sujeitas a mudanças.

Ainda há algumas limitações e alguns componentes não estão totalmente disponíveis:

  • A política do Google Play para acesso a prontuários médicos ainda está em desenvolvimento, e os apps podem precisar atender a outros requisitos antes de serem lançados na Play Store.
  • Alguns recursos, como APIs baseadas em changelogs, ainda não foram desenvolvidos para APIs de registros médicos.

Primeiros passos

Como "Históricos médicos" é um conjunto de novos tipos de registros no app Conexão Saúde, o mesmo processo para começar a usar o app Conexão Saúde se aplica a "Históricos médicos". Consulte Começar a usar o app Conexão Saúde para mais informações.

Se você já testou as APIs do framework de registros médicos que estavam disponíveis inicialmente, recomendamos migrar para o Jetpack para ter uma experiência de desenvolvedor melhor pelos seguintes motivos:

  • Todos os guias e exemplos de código são escritos para o Jetpack.
  • As ferramentas do ecossistema usam as APIs Jetpack
  • A superfície da API é nativa do Kotlin
  • O Jetpack melhorou o suporte à compatibilidade, como a API Feature Availability.

As APIs de registros médicos estão disponíveis na versão 1.1.0-beta02 do Conexão Saúde no Jetpack. Para atualizar a dependência do Jetpack para essa versão, é necessário compilar os apps no SDK do Android 16.

Depois de configurar e se preparar para gravar e ler dados de histórico médico no seu app, consulte Gravar dados médicos e Ler dados médicos.

Experiência do usuário

Esta seção contém informações gerais sobre a experiência do usuário.

Permissões

A solicitação de permissões de leitura ou gravação de prontuários médicos funciona de maneira semelhante às telas de permissões atuais do Conexão Saúde, mas uma tela separada de prontuários médicos é mostrada:

Tela de permissões para registros médicos
Figura 2: tela de permissões de registros médicos

Navegação de dados

A Conexão Saúde também oferece visualização e navegação básicas dos dados de prontuários médicos armazenados, semelhante aos tipos de dados atuais da Conexão Saúde.

Tela de navegação de dados para registros médicos
Figura 3: tela de navegação de dados de registros médicos