Conheça a API Medications do HealthKit

O HealthKit introduziu novas APIs de medicamentos que permitem que apps para iOS, iPadOS e visionOS leiam e utilizem dados de medicamentos. O app Saúde no iOS 15 permite rastrear medicamentos, definir lembretes e registrar doses com segurança no HealthKit. Os desenvolvedores agora podem usar essas APIs para criar experiências de saúde personalizadas.

Os recursos de dados do HealthKit foram expandidos para incluir medicamentos e eventos de dose. Os apps podem acessar essas informações por meio de novos objetos e consultas. Você pode usar novos descritores de consulta e "HKQueries" para buscar esses medicamentos e eventos de dose, permitindo que os apps forneçam gerenciamento de medicamentos mais abrangente e interoperabilidade com outros sistemas de saúde.

No app Saúde, quando alguém adiciona um medicamento, como a amoxicilina, ele é representado como um objeto com propriedades personalizáveis. Esse objeto inclui o nome oficial do medicamento, a forma (como comprimido), o identificador exclusivo e um código RxNorm. A pessoa também pode montar um cronograma e dar um apelido como "Antibióticos", para facilitar a referência. Os apps pode usar consultas específicas para buscar esses dados. Para obter uma lista de medicamentos, os apps podem usar um novo descritor de consulta que permite filtrar por status ativo ou arquivado e presença no cronograma. Para obter eventos de dose, os apps podem usar consultas existentes baseadas em tipo de amostra, especificando o tipo "HKMedicationDoseEvent" e filtrando por medicação ou status do log.

O app de exemplo usa a API de medicamentos do HealthKit para permitir que os usuários vejam seus medicamentos autorizados, registrem a dose mais recente tomada e anotem efeitos colaterais. O app pede permissão do usuário para ler e compartilhar dados de medicamentos e amostras de sintomas, como dores de cabeça e náuseas. Após autorização, o app consulta o HealthKit para buscar a lista completa de medicamentos autorizados e seus eventos de dose correspondentes. O app recupera a dose mais recente de um medicamento específico registrado hoje usando uma consulta do HealthKit com um predicado composto. Se não encontrar uma dose, nada é exibido. O app então associa os medicamentos aos efeitos colaterais usando códigos RxNorm, um sistema que identifica exclusivamente medicamentos clínicos. Um dicionário estático no app mapeia códigos RxNorm para modelos de sintomas. As pessoas podem ver uma lista de efeitos colaterais associados a um medicamento e registrar a intensidade dos sintomas usando emojis, que são salvos como amostras de categorias no HealthKit.

Uma consideração é adicionar um recurso ao app para rastrear doses de medicamentos ao longo do tempo usando consultas de objeto ancorado. Uma consulta de objeto ancorado é uma solução ideal para atualizar gráficos com novos dados de dose do HealthKit. Esse método de consulta fornece uma visão rápida de amostras existentes e atualizações subsequentes, incluindo exclusões. No entanto, o manuseio cuidadoso é essencial devido à natureza dinâmica dos dados de eventos de dose, que você pode registrar retroativamente, editar ou salvar para lembretes. Ao implementar uma consulta de objeto ancorado, é crucial usar a âncora da consulta retornada para evitar o reprocessamento de dados. Configure a consulta com um predicado que filtra as doses por medicamento e se enquadra na janela de data relevante. A interface assíncrona do Swift é recomendada para uma execução eficiente em uma thread em segundo plano. Essa sincronização de dados em tempo real fornece às pessoas uma maneira conveniente de monitorar a ingestão de medicamentos ao longo do tempo.

Quando uma pessoa adiciona um novo medicamento ao seu app Saúde, ela pode escolher quais apps, já autorizados para dados de medicamentos, podem acessar o novo medicamento. Esse processo contínuo ocorre dentro do app Saúde e não requer nenhum trabalho de desenvolvimento adicional. Depois que o usuário seleciona o app, o medicamento é salvo e o app pode exibir o medicamento recém-adicionado. A API de medicamentos permite que os apps criem experiências abrangentes de gerenciamento de medicamentos, utilizando sistemas de codificação clínica como o RxNorm para aprimorar a categorização e a associação de dados.