Garmin présente désormais un accès personnel aux données de Garmin Connect : activités en JSON et fichiers FIT, données de santé et de santé féminine en JSON. Le programme permet de récupérer ses propres informations à la demande. Il ne faut pas le confondre avec un service d’envoi de séances à la montre, ni avec une connexion automatique à un coach fondé sur l’IA.
L’essentiel
- Une offre Personal apparaît dans le Garmin Connect Developer Program, séparément des accès Business.
- Les activités sont proposées en JSON et FIT ; les deux autres familles de données annoncées utilisent JSON.
- Le fonctionnement est décrit comme « Pull only » : la récupération part de la demande du client.
- La page publique renvoie vers les réglages du compte Garmin Connect pour la clé personnelle et les jetons d’accès.
Un accès à ses données, sans application à installer sur la montre
L’accès Personal concerne le compte Garmin Connect et les données qui y sont synchronisées. Ce n’est pas un nouveau capteur et ce n’est pas une fonction à rechercher dans les menus d’une Forerunner ou d’une fenix. La présentation officielle invite l’utilisateur à se connecter au site Garmin Connect, à récupérer sa clé personnelle puis à générer les jetons nécessaires aux requêtes. L’entrée se trouve donc du côté du service en ligne, pas d’un cadran Connect IQ.
Cette distinction compte pour un coureur qui possède plusieurs appareils. Une montre enregistre la sortie, une autre peut servir au quotidien, et le compte centralise une partie de cet historique. L’API constitue une voie de récupération de ces données déjà présentes dans le service. Elle n’annonce ni une amélioration de la précision GPS ni le déblocage d’une métrique que le matériel ne mesure pas.
La page de présentation n’affiche pas de liste de montres compatibles ni de version minimale de firmware pour cette offre. Il serait donc trompeur de la réserver à une génération précise. Le périmètre dépend d’abord des informations réellement disponibles dans le compte et des autorisations applicables. Un champ absent de l’activité d’origine ne devient pas automatiquement disponible parce qu’un accès développeur existe.
JSON pour les tableaux de bord, FIT pour les fichiers d’activité
Deux formats sont annoncés pour les activités : JSON et FIT. Le premier convient à des données structurées qu’une application peut lire et organiser. Le second est le format de fichiers sportifs documenté par Garmin. Le programme distingue cette famille Activity Data des données de santé et de santé féminine, annoncées en JSON uniquement dans le tableau public.
Pour un marathonien, l’usage possible est un carnet personnel qui rapproche les sorties et les informations quotidiennes disponibles. Pour un traileur, ce peut être un archivage des fichiers d’activité avant de comparer plusieurs éditions d’une course. Ces exemples restent des applications à construire : Garmin ne livre pas avec l’accès Personal un nouveau tableau de bord universel qui ferait déjà toutes ces analyses.
La récupération de données n’efface pas non plus les différences entre sports. Une activité vélo, une sortie course à pied et une séance indoor ne se comparent pas simplement en additionnant les distances. Un outil personnel doit conserver le type d’activité, les unités et les dates pour éviter de fabriquer des tendances artificielles à partir de pratiques différentes.
| Accès | Données annoncées | Livraison / limite explicite |
|---|---|---|
| Personal | Activités JSON et FIT ; santé et santé féminine JSON | Pull only ; usage de ses propres données |
| Starter Business | Activity, Courses, Health, Training, Women’s Health | Push only ; historique non inclus ; utilisateurs limités |
| Enterprise Business | Périmètre professionnel étendu, dont Golf | Push ou Ping/Pull ; modalités adaptées au contrat |
Suivre les nouveautés montres GPS
Recevez les prochaines actualités Horloge du Coureur sur les montres, capteurs, firmware et applications sport.
Un fichier FIT n’est pas une nouvelle mesure physiologique
La documentation FIT précise la chaîne technique : les capteurs mesurent notamment fréquence cardiaque, vitesse, allure ou puissance ; leurs données peuvent être transmises en ANT+ ou Bluetooth ; l’appareil d’affichage les collecte ensuite dans un fichier FIT avant le transfert vers un ordinateur, un téléphone ou le cloud. L’accès au fichier intervient donc après l’acquisition. Il ne remplace ni le capteur ni les réglages d’enregistrement.
Le SDK officiel comprend des outils pour encoder et décoder ces fichiers, ainsi qu’un FitCSVTool pour convertir le binaire en texte exploitable. Plusieurs langages sont proposés, dont Python, JavaScript, Swift, Java, C et C++. Le format peut contenir différents types de fichiers, notamment activité, parcours et entraînement. Cette capacité du format n’étend pas pour autant les droits de l’offre Personal : un fichier d’entraînement décrit par FIT n’implique pas que l’API personnelle permette de l’envoyer à la montre.
« Pull only » ne signifie pas synchronisation dans les deux sens
La colonne Delivery de l’offre Personal indique « Pull only ». L’utilisateur ou son logiciel vient chercher les informations. Cette formulation ne promet pas que Garmin envoie spontanément chaque nouvelle sortie vers un serveur personnel, ni qu’un service reste synchronisé en permanence sans programmation supplémentaire.
Le tableau est également clair sur une autre limite : les API Courses et Training sont citées dans les offres Business, mais pas dans la liste Personal. La présentation personnelle ne permet donc pas d’affirmer que l’on pourra envoyer un parcours ou un entraînement structuré à sa montre par cette voie. Lire le fichier d’une séance terminée et créer la séance de demain sont deux opérations distinctes.
Cette séparation évite une confusion avec les outils de gestion Garmin sur Linux. Un logiciel qui dialogue avec un appareil connecté en USB ne réalise pas le même travail qu’un client qui interroge le compte en ligne. L’un ne remplace pas automatiquement l’autre : transfert local, synchronisation et consultation du cloud répondent à des besoins différents.
Personal, Starter et Enterprise : trois périmètres à ne pas mélanger
Le programme affiche aussi deux offres destinées aux organisations. Starter inclut notamment Activity, Courses, Health, Training et Women’s Health. Sa livraison est décrite comme Push only, l’historique n’est pas inclus et la capacité utilisateurs est limitée. Enterprise ajoute des possibilités adaptées aux organisations de plus grande taille, avec des modalités commerciales et techniques personnalisées.
Ces informations ne doivent pas être reportées telles quelles sur l’offre personnelle. Par exemple, la mention d’historique d’un mois ou plus apparaît dans la colonne Enterprise. Elle ne constitue pas une garantie de profondeur historique pour Personal. De même, une capacité dite illimitée dans une formule professionnelle ne décrit pas les quotas d’un compte individuel.
Un entraîneur qui souhaite réunir les données de plusieurs athlètes ne peut donc pas supposer que les clés personnelles de ses clients constituent une solution professionnelle équivalente. Les conditions d’accès, le consentement et le traitement des données doivent correspondre au service réellement proposé. Les restrictions autour des applications connectées à Strava rappellent également qu’une intégration dépend des règles du fournisseur, pas seulement de sa faisabilité informatique.
Un client Python officiel pour récupérer ses entraînements
Garmin met aussi à disposition un client Python et la commande gc-personal dans son dépôt officiel. Le logiciel nécessite Python 3.12 ou une version ultérieure, ainsi qu’une clé Personal API créée dans Garmin Connect. Il permet notamment de lister les activités, de consulter les données de sommeil et de VFC, puis de télécharger le fichier d’une activité sous forme d’archive ZIP. Les commandes de données renvoient du JSON, utilisable dans un carnet personnel ou un outil d’analyse.
Ce client reste un outil de lecture : son existence ne permet pas d’envoyer un plan d’entraînement vers la montre. Sa documentation avertit aussi qu’une clé passée directement dans une commande peut apparaître dans l’historique du terminal ou la liste des processus. Pour automatiser la récupération de ses sorties, un fichier privé aux permissions restreintes évite cette exposition ; la clé et le cache des jetons doivent rester hors des dépôts publics.
Clés et santé : l’export personnel reste une opération sensible
Une clé ou un jeton d’accès n’est pas un simple lien vers une activité publique. Ces éléments autorisent des requêtes dans un périmètre défini. Les copier dans un document partagé, une capture d’écran ou un dépôt de code public expose inutilement les données du compte. Pour un projet personnel, ils doivent rester dans un stockage privé adapté, distinct des fichiers que l’on diffuse.
La présence d’une famille dédiée à la santé féminine renforce cette vigilance. Il n’est pas nécessaire de récupérer toutes les informations accessibles pour comparer quelques entraînements. Limiter les données conservées à ce dont le projet a besoin réduit la quantité d’informations sensibles à protéger et simplifie aussi leur suppression ultérieure.
Le passage vers un service d’IA constitue encore une étape différente. L’API ne signifie pas que Garmin recommande de transmettre l’ensemble de son historique à n’importe quel assistant. Avant un tel transfert, il faut connaître le destinataire, l’usage des données et leur conservation. Aucun accès technique ne transforme une interprétation automatisée en diagnostic médical ou en prescription d’entraînement fiable.
Disponibilité et coût : ce que la présentation publique dit réellement
L’offre Personal est affichée sur le portail développeurs et un bouton de configuration renvoie vers le compte Garmin Connect. La page publique consultée ne comporte pas de date de lancement visible. Elle ne précise pas non plus de tarif, de quota de requêtes ou de profondeur d’historique pour cette formule. L’existence de l’offre est confirmée ; une gratuité sans limite ou un accès rétroactif intégral ne le sont pas.
Le bénéfice immédiat concerne surtout les sportifs capables d’exploiter une interface de programmation ou disposant d’un outil qui la prend correctement en charge. Pour qui veut simplement regarder sa sortie du jour, l’application reste plus directe. Pour qui souhaite conserver une archive indépendante ou organiser des analyses personnelles, cette voie officielle mérite d’être distinguée des connexions non documentées qui reposent sur les écrans du site.
Le point décisif reste le même : récupérer ses données n’est utile que si le résultat répond à une question précise. Comparer deux blocs de préparation, vérifier la continuité d’un historique ou rapprocher les entraînements d’un journal personnel sont des usages concrets. Accumuler des fichiers sans contrôler leur contenu et leurs dates produit surtout une archive difficile à exploiter.
Vidéo officielle Garmin
Présentation officielle du Garmin Connect Developer Program et des intégrations API. Cette vidéo générale est antérieure à l’offre Personal : elle n’en constitue pas un tutoriel d’activation.
À retenir
Garmin distingue désormais un accès Personal pour récupérer ses propres activités et données de santé. JSON et FIT ouvrent des usages d’archivage et d’analyse, mais la présentation publique ne promet ni envoi d’entraînements, ni historique intégral, ni quotas illimités. Les clés d’accès doivent rester privées.
Une erreur ou une information à compléter ? Contactez la rédaction : contact@horloge-du-coureur.fr.
Formats annoncés
Activités : JSON et FIT. Santé et santé féminine : JSON. Mode Personal : Pull only.
Non précisé publiquement
Tarif Personal, quotas, historique accessible et liste détaillée des champs ne figurent pas dans le tableau de présentation.
Sources
- Garmin Developers – Garmin Connect Developer Program, Overview : https://developer.garmin.com/gc-developer-program/overview/
- Garmin Developers – FIT SDK, Overview : https://developer.garmin.com/fit/overview/
- Garmin Connect – présentation officielle du service : https://connect.garmin.com/
- Garmin – Introduction to API Integrations, vidéo officielle : https://www.youtube.com/watch?v=vUBQk1tjrEs
- Garmin – Client Python officiel pour la Personal API, documentation : https://github.com/garmin/connect-personal-api-python
Partager l’article :
À lire aussi sur les données et applications sportives
