Découvrez l’API Medications de HealthKit

HealthKit a introduit de nouvelles API Medications qui permettent aux apps iOS, iPadOS et visionOS de lire et d’exploiter les données relatives aux médicaments. L’app Santé d’iOS 15 permet aux utilisateurs d’effectuer un suivi des médicaments, de définir des rappels et d’enregistrer les doses en toute sécurité dans HealthKit. Les développeurs peuvent désormais exploiter ces API pour créer des expériences de santé personnalisées.

Les capacités de données de HealthKit sont désormais étendues pour inclure les évènements relatifs aux médicaments et aux doses. Les apps peuvent accéder à ces infos via de nouveaux objets et requêtes. Vous pouvez utiliser de nouveaux descripteurs de requête et « HKQueries » pour récupérer ces évènements relatifs aux médicaments et aux doses, ce qui permet aux apps de fournir une gestion plus complète des médicaments et une interopérabilité avec d’autres systèmes de santé.

Dans l’app Santé, lorsqu’une personne ajoute un médicament, comme l’amoxicilline, ce dernier est représenté sous forme d’un objet aux propriétés personnalisables. Cet objet comprend le nom officiel du médicament, sa forme (de type comprimé par exemple), son identifiant unique et un code RxNorm. La personne peut également établir un planning et lui donner un surnom, tel que « antibiotiques », pour pouvoir s’y référer facilement. Les apps peuvent utiliser des requêtes spécifiques pour récupérer ces données. Pour récupérer une liste de médicaments, les apps peuvent utiliser un nouveau descripteur de requête qui permet de filtrer par statut actif ou archivé et par présence dans le planning. Pour récupérer les évènements relatifs aux doses, les apps peuvent utiliser les requêtes existantes basées sur le type d’échantillon, en spécifiant le type d’échantillon « HKMedicationDoseEvent » et en filtrant selon le médicament ou l’état du journal.

L’exemple d’app utilise l’API Medications de HealthKit pour permettre aux utilisateurs de consulter leurs médicaments autorisés, d’enregistrer la dernière dose prise, ainsi que les effets secondaires. L’app demande à l’utilisateur l’autorisation de lire et de partager les données relatives aux médicaments et les exemples de symptômes tels que les maux de tête et les nausées. Après autorisation, l’app demande à HealthKit d’obtenir la liste complète des médicaments autorisés et les doses correspondantes. L’app récupère la dose la plus récente d’un médicament spécifique enregistré aujourd’hui avec une requête HealthKit à l’aide d’un prédicat composé. Si aucune dose n’est trouvée, rien ne s’affiche. L’app associe ensuite les médicaments aux effets secondaires à l’aide de codes RxNorm, un système qui identifie de manière unique les médicaments cliniques. Un dictionnaire statique dans l’app associe les codes RxNorm aux modèles de symptômes. Les personnes peuvent consulter une liste des effets secondaires associés à un médicament et consigner l’intensité de leurs symptômes à l’aide d’emojis, qui sont ensuite enregistrés en tant qu’exemples de catégorie dans HealthKit.

On peut envisager d’ajouter une fonction à l’app pour suivre les doses de médicaments au fil du temps à l’aide de requêtes d’objets ancrées. Une requête d’objet ancrée est une solution idéale pour mettre à jour les graphiques avec les nouvelles données de dose de HealthKit. Cette méthode de requête fournit un instantané des échantillons existants et des mises à jour ultérieures, y compris les suppressions. Cependant, une manipulation prudente est essentielle en raison de la nature dynamique des données sur les évènements de dose, que vous pouvez consigner rétroactivement, modifier ou enregistrer à des fins de rappel. Lors de l’implémentation d’une requête d’objet ancrée, il est essentiel d’utiliser l’ancre de requête renvoyée pour éviter un retraitement des données. Configurez la requête avec un prédicat qui filtre les doses par médicament et se situe dans la fenêtre de date appropriée. L’interface asynchrone de Swift est recommandée pour une exécution efficace sur un thread d’arrière-plan. Cette synchronisation des données en temps réel offre aux gens un moyen pratique de suivre leur consommation de médicaments au fil du temps.

Lorsqu’une personne ajoute un nouveau médicament à son app Santé, elle est invitée à choisir les apps, déjà autorisées pour les données relatives aux médicaments, qui peuvent accéder au nouveau médicament. Ce processus fluide se déroule au sein de l’app Santé et ne nécessite aucun travail de développement supplémentaire. Une fois que l’utilisateur a sélectionné l’app, le médicament est enregistré et l’app peut alors afficher le médicament nouvellement ajouté. L’API Medications permet aux apps de créer des expériences complètes de gestion des médicaments, en utilisant des systèmes de codage clinique comme RxNorm pour améliorer la catégorisation et l’association des données.