# Données GPS (/docs/statistiques/donnees-gps)
## Vue d'ensemble [#vue-densemble]
FormaPulse intègre les données issues de **fournisseurs GPS** (Catapult, STATSports, Polar Team Pro, Playermaker, ou GPS génériques via CSV). Une fois la configuration GPS active, les sessions sont rapatriées et **liées à des événements** (séances ou matchs), pour produire des statistiques par sportif, par période d'activité (échauffement, opposition, retour au calme…), et des **références individualisées** servant de base à toutes les comparaisons.
Cette page explique :
* Le pré-requis : la **configuration GPS** dans Préférences
* Comment les données sont **lues** dans chacune des pages statistiques
* Comment fonctionnent les **références GPS individualisées** (croisements, méthodes, tendances)
Pour la **synchronisation** d'une session sur un événement (auto + manuelle/CSV), voir [Synchroniser une session GPS](/docs/statistiques/synchroniser-gps).
## 1. Configurer le GPS (pré-requis) [#1-configurer-le-gps-pré-requis]
### Accès [#accès]
**Profil > Préférences > section GPS**.
Sans configuration GPS active, l'onglet GPS des pages stats affiche un bandeau **« Configuration GPS requise »** avec un bouton qui redirige vers cette page.
### Modes de fournisseur [#modes-de-fournisseur]
* **Fournisseur connecté** — authentification directe vers le fournisseur (clé d'accès ou login). Les sessions sont récupérées automatiquement à la date de l'événement.
* **Fournisseur manuel (CSV)** — import de fichiers CSV avec un format personnalisé : séparateur, encodage (UTF-8 par défaut), lignes d'en-tête à ignorer, séparateur décimal. Permet de connecter n'importe quelle source GPS qui sait exporter un CSV (montre connectée, traceur amateur, etc.).
### Métriques sélectionnées [#métriques-sélectionnées]
Au moment de la configuration, tu choisis **les métriques à conserver** parmi celles que retourne le provider. Pour chaque métrique, FormaPulse stocke son libellé, son unité, sa catégorie.
Seules les métriques cochées sont stockées et apparaissent dans les statistiques. Pour ajouter une métrique manquante, modifier la configuration et **ré-importer** les sessions concernées.
### Une fois la configuration active [#une-fois-la-configuration-active]
Une fois configuré, l'accès suivant est débloqué :
* L'onglet GPS des pages stats > séances/matchs
* L'onglet Réf. GPS de stats individuelles
* L'onglet GPS du suivi longitudinal
* Les pages pro-analytics (Modélisation GPS athlètes, Modélisation GPS exercices, onglet GPS du dashboard)
* Le bouton **Synchroniser** dans les modales GPS
## 2. Lecture des données GPS dans chaque page [#2-lecture-des-données-gps-dans-chaque-page]
### Stats > Séances/Matchs — Onglet GPS [#stats--séancesmatchs--onglet-gps]
Trois cas d'affichage :
**Cas A — Données présentes** :
En-tête de l'activité :
* Nom de la session GPS chez le fournisseur.
* Heure de début / fin / durée.
* **Confiance de liaison** (en pourcentage) — qualité de la liaison automatique. Plus c'est haut, plus la liaison est fiable. Une valeur faible signale un horaire d'événement potentiellement décalé.
* Type de liaison : automatique ou manuelle.
Tableau :
* Une **ligne par sportif** filtré par le mode individuel / collectif de la page.
* Colonnes = métriques sélectionnées dans ta configuration GPS, avec une icône et une couleur dédiées par famille (distance, vitesse, charge, sprints, intensité…).
Vue **par périodes** si la session est découpée :
* Bascule **Afficher par période** : éclate les valeurs par échauffement, 1ère mi-temps, 2ème mi-temps, récupération…
* Une ligne *« Moyenne équipe »* est insérée en tête de chaque groupe de période.
* Bascule **Afficher par minute** : normalise en intensité par minute.
* Durée de chaque période affichée en minutes / secondes.
**Cas B — Pas de données mais configuration active** :
* Message *« Aucune donnée GPS pour cette séance »*.
* Bouton **Synchroniser** ([Synchroniser une session GPS](/docs/statistiques/synchroniser-gps)).
**Cas C — Pas de configuration GPS** :
* Message *« Configuration GPS requise »*.
* Bouton **Configurer le GPS** → redirige vers tes préférences.
### Stats > Individuelles — Onglet Réf. GPS [#stats--individuelles--onglet-réf-gps]
Vue spécifique au sportif sélectionné : ses **références GPS individualisées**.
#### Pré-requis : suffisamment d'historique [#pré-requis--suffisamment-dhistorique]
Si le sportif n'a pas assez d'historique pour calculer des normes individualisées, la page affiche un message explicatif. Sinon :
#### Sélecteur du type de croisement [#sélecteur-du-type-de-croisement]
Liste des **types de croisements disponibles** :
* Par tag d'événement uniquement
* Par poste du sportif uniquement
* Par type d'événement (séance / match)
* Croisements composites : type d'événement × poste, type d'événement × tag, poste × tag, etc.
Chaque croisement est calculé indépendamment et donne un **tableau de comparaison** distinct.
#### Tableau pour chaque croisement [#tableau-pour-chaque-croisement]
* En-tête : nombre d'échantillons individuels + date de dernier calcul
* Une **ligne par métrique GPS**
* Colonnes = **méthodes d'agrégation** disponibles : moyenne, médiane (P50), P75, P90, max, top 3 average, écart-type
* Cellules : valeur **individuelle** vs valeur **collective** + écart en valeur brute et en %
* **Icône de tendance** :
* **Hausse** (vert) — l'écart au collectif est en hausse depuis le dernier calcul
* **Baisse** (rouge) — en baisse
* **Stable** (gris) — pas de changement significatif
#### Lecture pratique [#lecture-pratique]
C'est ici qu'on lit, pour un joueur :
* « Sa **distance HI** moyenne en match championnat est à **+12%** du collectif au poste de milieu défensif » → tendance hausse = il s'écarte du collectif vers le haut
* « Sa **vitesse max** en séance est sous le **P75 collectif** depuis 3 mois » → tendance baisse = il décroche
### Suivi longitudinal — Onglet GPS [#suivi-longitudinal--onglet-gps]
Vue **série temporelle** des métriques GPS sur la période choisie. Voir [Suivi longitudinal](/docs/statistiques/suivi-longitudinal#onglet-gps).
### Pro-analytics — Modélisation et Pro Longitudinal GPS [#pro-analytics--modélisation-et-pro-longitudinal-gps]
* **Modélisation GPS athlètes** — page de calcul des **normes par croisements** (joueurs × poste × tag × métrique × méthode). Sert de base aux références individuelles. Voir [Modélisation GPS athlètes](/docs/pro-analytics/modelisation-gps-athletes).
* **Modélisation GPS exercices** — associer des **périodes GPS de référence** à des **exercices** pour construire un référentiel par exercice. Voir [Modélisation GPS exercices](/docs/pro-analytics/modelisation-gps-exercices).
* **Pro Longitudinal — Onglet GPS** — analyse longitudinale avancée (z-score, moyennes mobiles, alertes). Voir [Pro Longitudinal](/docs/pro-analytics/pro-longitudinal#onglet-gps).
## 3. Re-lier ou délier une activité GPS [#3-re-lier-ou-délier-une-activité-gps]
Si une activité est mal liée (mauvais événement, sportif manquant) :
1. Ouvre la fenêtre **Synchroniser** sur l'événement.
2. Sélectionne une **autre activité** dans la liste (ou ré-importe un CSV avec une correspondance corrigée).
3. La nouvelle liaison **remplace** la précédente — les statistiques se rafraîchissent.
→ Détail : [Synchroniser une session GPS](/docs/statistiques/synchroniser-gps).
## 4. Recalcul des références individualisées [#4-recalcul-des-références-individualisées]
Les références (Réf. GPS de stats individuelles) sont recalculées automatiquement :
* Quand de nouvelles données GPS sont importées
* Périodiquement par le système
Tu peux **forcer un recalcul** depuis la page **Modélisation GPS athlètes** (cf. lien plus haut).
## Erreurs à éviter [#erreurs-à-éviter]
* **Configurer le GPS depuis le mauvais compte** : la configuration est **par utilisateur**. Si tu utilises un compte coach partagé, vérifie que la clé est bien sur le bon profil.
* **Correspondance CSV oubliée** : un athlète présent dans le CSV mais non associé à un sportif FormaPulse verra ses données ignorées. Vérifie bien l'aperçu (athlètes total vs athlètes associés) avant la validation finale.
* **Importer un même CSV deux fois** : la liaison est unique par événement, le second import **remplace** le premier. Pour fusionner deux sources, fais la fusion en amont.
* **Confondre métriques sélectionnées et toutes les colonnes du CSV** : seules les métriques cochées dans la configuration sont conservées.
* **Comparer des seuils différents en cours de saison** : les références individuelles sont recalculées à partir de l'historique. Si tu modifies massivement la base d'événements (suppressions de séances, changements de poste), les normes peuvent évoluer de façon contre-intuitive.
* **Onglet GPS toujours vide** : vérifie l'**heure de l'événement** dans la planification ET la **correspondance athlètes** dans la configuration GPS (l'horaire pilote la liaison automatique).
* **Confiance de liaison faible** (sous 50 %) : la liaison est probablement erronée. Re-synchronise manuellement.
## Aller plus loin [#aller-plus-loin]