Comment exporter les données des photos de votre événement en JSON
Les tags de votre événement servent aussi en dehors de la galerie : pour un partenaire résultats, pour vos propres archives ou pour retrouver les photos dans les dossiers du photographe. Photos to Data Export réunit toutes les photos traitées dans un seul fichier JSON, avec les dossards et les autres champs de votre choix.
En bref : ouvrez votre événement, allez dans Photo, puis Tools, et choisissez Photos to Data Export. Cochez les Fields to include, sélectionnez Export et téléchargez le fichier JSON quand il affiche Ready. Chaque photo traitée a une entrée, y compris les photos sans dossard.
Ce que contient l'export
Photos to Data Export répond à une question pour chaque photo de votre événement : que savons-nous d'elle ? Le fichier contient une entrée par photo traitée, indexée par l'identifiant de la photo, avec les champs que vous avez choisis.
C'est le bon export quand vous partez des photos :
- Relier les tags aux originaux. Le nom et le chemin du fichier indiquent à quel fichier du dossier du photographe correspond chaque entrée.
- Retrouver les photos que personne ne trouve. Les photos sans dossard figurent dans le fichier avec une liste vide, prêtes pour un second passage.
- Garder votre propre trace. Une copie des tags de l'événement tels qu'ils étaient à une date donnée, pour vos archives ou un autre système.
Si vous partez plutôt des coureurs et voulez chaque dossard avec ses photos, utilisez Bib to Data Export.
Étape 1 : ouvrez l'outil
Dans le tableau de bord, ouvrez l'événement, allez dans Photo et sélectionnez l'onglet Tools. Choisissez Photos to Data Export. L'outil s'appelait auparavant Photos to Bib Export, et les anciens liens l'ouvrent toujours.
La page a deux colonnes. À gauche, les champs et le bouton Export. À droite, le bloc Latest export et un aperçu de son fichier. Avant votre premier export, la partie droite affiche un Example file pour vous montrer la structure.
Étape 2 : choisissez les champs
Bibs et Manual tags sont cochés par défaut. Ajoutez les autres champs dont vous avez besoin. Il en faut au moins un.
| Champ | Contenu |
|---|---|
| Bibs | Les dossards qui permettent aux participants de trouver la photo : dossards détectés plus vos tags manuels, moins ceux que vous avez retirés. |
| Manual tags | Les dossards ajoutés à la main dans Manual Tagging. |
| Original file name | Le nom de la photo au moment de son import. |
| File path | L'emplacement de la photo dans sa source, nom compris. Pour un import 9Pic, le dossier dans l'import. Pour Google Drive, Dropbox, OneDrive, Box ou SharePoint, le chemin dans le dossier partagé. Vide pour les photos issues d'un lien personnalisé. |
| Detected bibs | Les dossards trouvés sur la photo, avant tout retrait. |
| Removed bibs | Les dossards détectés que vous avez retirés dans Manual Tagging. |
| Detected text | Tout le texte lu sur la photo, comme les noms de sponsors et les panneaux. |
Chaque champ supplémentaire alourdit le fichier. Detected text est celui qui pèse le plus : laissez-le décoché si vous ne comptez pas l'utiliser.
Les cases reprennent les champs de votre dernier export. Si vous les modifiez, une note vous rappelle de relancer l'export pour que le fichier corresponde.
Étape 3 : exportez et téléchargez
Sélectionnez Export. L'export tourne en arrière-plan et indique combien de photos il a lues. Vous pouvez quitter la page et revenir. Un grand événement prend environ une minute.
Quand il affiche Ready, le bloc Latest export indique quand il a été lancé, la taille du fichier et trois compteurs : Photos, Bibs et Photos without bibs. Il liste aussi les champs du fichier. Sélectionnez Download JSON pour l'enregistrer.
Chaque événement conserve son dernier export de chaque type : un nouvel export remplace donc celui affiché sur la page.
Étape 4 : lisez le fichier
Chaque fichier commence par les mêmes informations : event_id, export_type, generated_at, options (les champs inclus) et counts. Les photos se trouvent sous data. Voici un fichier avec nom de fichier, chemin, dossards et tags manuels :
{
"event_id": 6109,
"export_type": "photos_to_bib",
"generated_at": "2026-11-13T09:30:00+00:00",
"options": ["file_name", "file_path", "bibs", "manual_tags"],
"counts": {"photos": 30240, "bibs": 7374, "photos_without_bibs": 2086},
"data": {
"3f2a...c91e": {
"file_name": "IMG_4821.jpg",
"file_path": "Habit Run 2026/Finish line/IMG_4821.jpg",
"bibs": ["1024", "2210"],
"manual_tags": ["2210"]
},
"9d03...6b7f": {
"file_name": "IMG_4822.jpg",
"file_path": "Habit Run 2026/Finish line/IMG_4822.jpg",
"bibs": [],
"manual_tags": []
}
}
}
Quelques points à connaître pour le lire :
- La clé de chaque entrée est l'identifiant de la photo dans 9Pic AI. Ce n'est pas le nom du fichier. Cochez Original file name si vous en avez besoin.
- Les photos sans dossard restent listées, avec une liste vide. C'est ainsi qu'est calculé
photos_without_bibs. - Une photo issue d'un lien personnalisé a
nullcomme chemin de fichier, car elle n'a pas de dossier.
Vérifiez avant de télécharger
Sous le dernier export, File preview affiche le début du fichier, avec la même structure. Sélectionnez une clé ou sa flèche pour l'ouvrir ou la replier, ou utilisez Expand all et Collapse all. Raw affiche le texte brut avec les numéros de ligne, et Copy copie l'aperçu.
L'aperçu contient les 20 premières photos, et les longues listes sont coupées par une ligne comme « … 5 more items in the download ». Les entrées repliées indiquent combien de clés ou d'éléments elles contiennent dans le fichier complet : les compteurs sont donc exacts même quand l'aperçu est court.
Trois usages concrets
Relier les tags aux originaux du photographe
Cochez Original file name et File path. Chaque entrée indique alors de quel fichier et de quel dossier elle provient : un photographe ou un éditeur retrouve l'original d'un dossard sans chercher dans la galerie.
Retrouver les photos sans dossard
Repérez les entrées dont la liste bibs est vide. Beaucoup seront des photos de foule, de paysage ou de la ligne de départ. D'autres peuvent montrer des coureurs au dossard masqué. Celles-là méritent un passage dans Manual Tagging ; voir comment identifier les dossards à la main après l'IA.
Vérifier ce qui a été corrigé
Cochez Detected bibs et Removed bibs pour voir ce que la lecture des dossards a trouvé et ce que votre équipe a retiré. C'est un moyen rapide de contrôler une passe d'identification, ou d'expliquer pourquoi un coureur ne trouve plus une photo.
Ce qui compte comme dossard
Seules les photos traitées figurent dans le fichier. Le champ Bibs suit les mêmes règles que la recherche des participants :
- Les dossards trouvés avec les réglages de détection des dossards de l'événement. Quand l'événement utilise sa liste de dossards, seuls les dossards de la liste comptent.
- Moins les dossards détectés que vous avez retirés.
- Plus vos tags manuels, même avant leur publication dans la recherche des participants.
Le fichier correspond donc à ce que trouvent les participants, avec en plus vos tags manuels les plus récents.
Questions fréquentes
Le fichier se met-il à jour quand je modifie les tags ?
Non. Un fichier reflète les tags au moment de l'export. Après une identification, sélectionnez Export again.
Quelles offres l'incluent ?
Toutes les offres. Il continue aussi de fonctionner après la fin d'une offre, pour que vous puissiez toujours récupérer vos données.
L'export a échoué. Que faire ?
Sélectionnez Export again. Si un téléchargement échoue, réessayez : chaque clic prépare un nouveau lien de téléchargement.
Puis-je ouvrir le fichier dans un tableur ?
Le JSON est fait pour les logiciels : le plus simple est de le transmettre à la personne qui gère votre système de résultats ou d'inscriptions. La plupart des outils de données et des extensions de tableur savent aussi importer du JSON.
Prochaines étapes
Lancez un premier export avec les champs par défaut et ouvrez File preview pour voir la structure de votre événement. Ajoutez ensuite le nom et le chemin du fichier si vous devez retrouver les originaux. Pour une liste de chaque dossard avec ses photos, lisez comment exporter les photos de course par numéro de dossard. La lecture des dossards elle-même est présentée sur la page BibTrack.