# Synchroniser une session GPS (/docs/statistiques/synchroniser-gps)
## Vue d'ensemble [#vue-densemble]
Quand FormaPulse n'a pas pu lier automatiquement une session GPS à un événement (horaires décalés, source CSV, fournisseur sans synchronisation directe…), l'onglet GPS de la page **Stats > Séances** ou **Stats > Matchs** affiche un bouton **Synchroniser** qui ouvre une fenêtre de synchronisation. Cette page détaille tout ce qu'on peut y faire.
## Pré-requis [#pré-requis]
* Configuration GPS active sur ton compte. Sinon, le bouton Synchroniser n'apparaît pas et on est redirigé vers **Préférences > GPS**.
* Voir [Données GPS](/docs/statistiques/donnees-gps) pour la configuration initiale.
## Ouvrir la fenêtre [#ouvrir-la-fenêtre]
Depuis l'onglet **GPS** d'une page stats :
* **Stats > Séances** → onglet GPS → bouton **Synchroniser**.
* **Stats > Matchs** → onglet GPS → bouton **Synchroniser**.
À l'ouverture, la fenêtre interroge le fournisseur GPS pour la **date de l'événement**. La réponse détermine le **mode** :
* Si ton compte est connecté à un fournisseur (Catapult, STATSports…) → mode **Fournisseur connecté** (liste d'activités).
* Si ton compte est en fournisseur manuel (CSV) → mode **CSV manuel** avec ta configuration de lecture pré-chargée.
## Mode 1 — Fournisseur connecté [#mode-1--fournisseur-connecté]
### Affichage [#affichage]
La fenêtre affiche la **liste des activités GPS** disponibles à la date de l'événement.
Pour chaque activité :
* Nom de la session.
* Heure de début / fin.
* Durée.
* Nombre d'athlètes inclus.
* **Score de correspondance automatique** : la confiance calculée par FormaPulse pour la liaison automatique (si elle a échoué).
### Action [#action]
1. Tu sélectionnes une activité (clic).
2. Tu cliques sur **Synchroniser**.
3. La liaison est créée et marquée comme **manuelle**.
4. La page se recharge automatiquement et les statistiques GPS apparaissent.
## Mode 2 — Fournisseur manuel (CSV) [#mode-2--fournisseur-manuel-csv]
Activé quand ton compte est configuré en fournisseur générique CSV.
### Paramètres de lecture [#paramètres-de-lecture]
La fenêtre utilise les **paramètres de lecture** que tu as définis dans ta configuration GPS :
* Séparateur de colonnes (virgule, point-virgule, tabulation…).
* Encodage du fichier (UTF-8 par défaut, ou autre selon le format d'export).
* Lignes à ignorer en début de fichier (en-têtes avant les données réelles).
* Séparateur décimal (point ou virgule).
Et :
* La **liste de correspondances athlète CSV ↔ sportif FormaPulse** mémorisée des imports précédents.
* Les **métriques** que tu as cochées dans la configuration.
### Étape 1 — Choix du fichier [#étape-1--choix-du-fichier]
Tu sélectionnes un fichier CSV. Il est **lu localement** dans ton navigateur (pas d'envoi tant que la lecture n'est pas validée).
### Étape 2 — Aperçu et correspondances [#étape-2--aperçu-et-correspondances]
Après lecture, la fenêtre affiche un **aperçu** :
* Nombre total d'athlètes détectés dans le CSV.
* Combien sont associés à un sportif FormaPulse.
* Nombre de lignes valides.
* Nombre de périodes détectées (si le CSV contient une colonne période).
* Nombre de métriques exploitables.
Tu peux **ajuster les correspondances** athlètes CSV → sportifs FormaPulse. Elles sont mémorisées pour les imports suivants.
### Étape 3 — Sélection des métriques [#étape-3--sélection-des-métriques]
Tu coches les colonnes du CSV à conserver. Toutes les autres colonnes sont ignorées même si présentes.
### Étape 4 — Validation finale [#étape-4--validation-finale]
Au clic **Synchroniser**, le fichier est transmis :
* Création de la session GPS à partir des données lues.
* Liaison à l'événement (marquée comme manuelle).
* Calcul des stats par sportif et par période (si des périodes existent).
Les **références GPS individualisées** du sportif (visibles dans Stats > Individuelles > onglet Réf. GPS) sont automatiquement rafraîchies après l'import.
## Re-lier ou délier [#re-lier-ou-délier]
Pour **re-lier** une activité (changer la liaison existante) :
1. Rouvrir la fenêtre Synchroniser.
2. Sélectionner une autre activité ou ré-importer un autre CSV.
3. La nouvelle liaison **remplace** la précédente — pas besoin de délier explicitement.
Pour **délier** complètement (pas de bouton dédié dans la fenêtre) : il faut passer par l'**administration GPS** (selon les permissions) ou contacter le support. La logique privilégie le remplacement.
## Confiance de liaison [#confiance-de-liaison]
Une fois liée, l'activité conserve un **score de confiance de liaison** (0-100 %) :
* **Liaison automatique** : score calculé par le système (proximité horaire, durée, nombre d'athlètes correspondants).
* **Liaison manuelle** : généralement 100 % (la liaison a été validée explicitement par un humain).
## Erreurs à éviter [#erreurs-à-éviter]
* **Ré-importer le même CSV deux fois** : la deuxième liaison **remplace** la première. Si tu as ajouté des athlètes aux correspondances entre-temps, le ré-import est nécessaire pour qu'ils soient pris en compte.
* **Format de date dans le CSV non standard** : si la colonne date n'est pas dans un format reconnu, la lecture peut échouer. Vérifier l'aperçu avant validation.
* **Encodage incorrect** : un CSV exporté dans un encodage différent de celui déclaré dans ta configuration produit des accents cassés. Adapter l'encodage dans la config GPS.
* **Séparateur décimal incorrect** : si tu déclares la virgule comme séparateur décimal alors que le CSV utilise le point, les valeurs numériques sont lues comme du texte. Vérifier la config.
* **Lignes d'en-tête incorrectes** : si le nombre de lignes à ignorer est mal réglé, l'app lit les en-têtes comme des données. L'aperçu te le montrera (lignes très bizarres).
* **Cliquer Synchroniser sans avoir attendu la lecture** : pendant la lecture locale, le bouton doit être désactivé. Si tu vois un état de chargement, attends.
* **Croire que la fenêtre recharge automatiquement les stats** : si tu fermes la fenêtre via la croix, le rechargement n'a pas lieu. Il n'est déclenché qu'après une synchronisation aboutie.
## Aller plus loin [#aller-plus-loin]