Conoce la HealthKit Medications API

HealthKit ha introducido nuevas API de medicamentos que permiten que las apps de iOS, iPadOS y visionOS lean y utilicen datos de medicamentos. La app Salud en iOS 15 permite a los usuarios realizar un seguimiento de los medicamentos, establecer recordatorios y registrar dosis de forma segura dentro de HealthKit. Los desarrolladores ahora pueden aprovechar estas API para crear experiencias de salud personalizadas.

Las capacidades de datos de HealthKit ahora se han ampliado para incluir medicamentos y eventos de dosis. Las apps pueden acceder a esta información a través de nuevos objetos y consultas. Puede utilizar nuevos descriptores de consultas y "HKQueries" para obtener estos medicamentos y eventos de dosis, lo que permite que las apps proporcionen una gestión de medicamentos más integral e interoperabilidad con otros sistemas de salud.

En la app Salud, cuando alguien agrega un medicamento, como amoxicilina, se representa como un objeto con propiedades personalizables. Este objeto incluye el nombre oficial del medicamento, la forma (como tableta), el identificador único y un código RxNorm. La persona también puede establecer un cronograma y darle un apodo, como "Antibióticos", para facilitar su consulta. Las apps pueden utilizar consultas específicas para obtener estos datos. Para recuperar una lista de medicamentos, las apps pueden usar un nuevo descriptor de consulta que permite filtrar por estado activo o archivado y presencia en el cronograma. Para obtener eventos de dosis, las apps pueden usar consultas existentes basadas en tipos de muestra, especificando el tipo de muestra "HKMedicationDoseEvent" y filtrando por medicación o estado del registro.

La app de muestra utiliza la API de medicamentos de HealthKit para permitir a los usuarios ver sus medicamentos autorizados, registrar la dosis más reciente tomada y registrar los efectos secundarios. La app solicita permiso al usuario para leer y compartir datos de medicamentos y muestras de síntomas como dolores de cabeza y náuseas. Tras la autorización, la app consulta a HealthKit para obtener la lista completa de medicamentos autorizados y sus eventos de dosis correspondientes. La app recupera la dosis más reciente de un medicamento específico registrada hoy utilizando una consulta HealthKit con un predicado compuesto. Si no encuentra una dosis, no se muestra nada. Luego, la app asocia los medicamentos con sus efectos secundarios utilizando códigos RxNorm, un sistema que identifica de forma única los medicamentos clínicos. Un diccionario estático en la app asigna los códigos RxNorm a modelos de síntomas. Las personas pueden ver una lista de efectos secundarios asociados a un medicamento y registrar la intensidad de sus síntomas mediante emojis, que luego se guardan como muestras de categorías en HealthKit.

Una consideración es agregar una función a la app para rastrear las dosis de medicamentos a lo largo del tiempo utilizando consultas de objetos anclados. Una consulta de objeto anclado es una solución ideal para actualizar gráficos con nuevos datos de dosis de HealthKit. Este método de consulta proporciona una instantánea de las muestras existentes y las actualizaciones posteriores, incluidas las eliminaciones. Sin embargo, es esencial un manejo cuidadoso debido a la naturaleza dinámica de los datos de eventos de dosis, que puede registrar de manera retroactiva, editar o guardar para recordatorios. Al implementar una consulta de objeto anclado, es fundamental utilizar el ancla de consulta devuelto para evitar el reprocesamiento de datos. Configure la consulta con un predicado que filtre las dosis por medicación y caiga dentro de la ventana de fecha relevante. Se recomienda la interfaz asíncrona Swift para una ejecución eficiente en un hilo en segundo plano. Esta sincronización de datos en tiempo real proporciona a las personas una forma conveniente de monitorear su consumo de medicamentos a lo largo del tiempo.

Cuando una persona agrega un nuevo medicamento a su app de Salud, se le solicita que elija qué apps ya autorizadas para los datos de medicamentos, pueden acceder al nuevo medicamento. Este proceso continuo ocurre dentro de la app Salud y no requiere ningún trabajo de desarrollo adicional. Después de que el usuario selecciona la app, el medicamento se guarda y la app puede mostrar el medicamento recién agregado. La API de medicamentos permite que las apps creen experiencias integrales de gestión de medicamentos, utilizando sistemas de codificación clínica como RxNorm para una mejor categorización y asociación de datos.