Come esportare in JSON i dati delle foto del tuo evento
I tag del tuo evento servono anche fuori dalla galleria: per un partner che gestisce le classifiche, per il tuo archivio o per ricollegare le foto alle cartelle del fotografo. Photos to Data Export mette ogni foto elaborata in un unico file JSON, con i pettorali e gli altri campi che scegli.
In breve: apri il tuo evento, vai su Photo, poi su Tools, e scegli Photos to Data Export. Spunta i campi in Fields to include, seleziona Export e scarica il file JSON quando compare Ready. Ogni foto elaborata ha una voce, comprese le foto senza pettorali.
Cosa contiene l'esportazione
Photos to Data Export risponde a una domanda per ogni foto del tuo evento: cosa sappiamo di questa foto? Il file ha una voce per ogni foto elaborata, identificata dall'ID della foto, con i campi che hai scelto.
È l'esportazione giusta quando parti dalle foto:
- Ricollegare i tag agli originali. Il nome e il percorso del file ti dicono a quale file nella cartella del fotografo corrisponde ogni voce.
- Trovare le foto che nessuno trova. Le foto senza pettorali sono nel file con un elenco vuoto, pronte per un secondo controllo.
- Conservare una tua copia. I tag dell'evento com'erano in un certo giorno, per il tuo archivio o per un altro sistema.
Se invece parti dai partecipanti e vuoi ogni pettorale con le sue foto, usa Bib to Data Export.
Passo 1: apri lo strumento
Nella dashboard, apri l'evento, vai su Photo e seleziona la scheda Tools. Scegli Photos to Data Export. Prima si chiamava Photos to Bib Export, e i vecchi link lo aprono ancora.
La pagina ha due colonne. A sinistra ci sono i campi e il pulsante Export. A destra trovi il riquadro Latest export e un'anteprima del suo file. Finché non fai la prima esportazione, a destra compare un Example file, così vedi la struttura.
Passo 2: scegli i campi
Bibs e Manual tags sono spuntati di default. Aggiungi gli altri che ti servono. Ne serve almeno uno.
| Campo | Cosa contiene |
|---|---|
| Bibs | I pettorali con cui i partecipanti trovano la foto: pettorali rilevati più i tuoi tag manuali, meno quelli che hai rimosso. |
| Manual tags | Pettorali che hai aggiunto a mano in Manual Tagging. |
| Original file name | Il nome della foto al momento dell'importazione. |
| File path | Dove si trova la foto nella sua origine, nome incluso. Per un caricamento su 9Pic, la cartella all'interno del caricamento. Per Google Drive, Dropbox, OneDrive, Box o SharePoint, il percorso all'interno della cartella condivisa. Vuoto per le foto da un link personalizzato. |
| Detected bibs | Pettorali trovati sulla foto, prima di eventuali rimozioni. |
| Removed bibs | Pettorali rilevati che hai rimosso in Manual Tagging. |
| Detected text | Tutto il testo letto sulla foto, come nomi degli sponsor e cartelli. |
Ogni campo in più rende il file più grande. Detected text è quello che pesa di più, quindi lascialo disattivato se non ti serve.
Le caselle partono dai campi della tua ultima esportazione. Se le cambi, una nota ti ricorda di esportare di nuovo perché il file corrisponda.
Passo 3: esporta e scarica
Seleziona Export. L'esportazione avviene in background e mostra quante foto ha letto. Puoi lasciare la pagina e tornare dopo. Per un evento grande serve circa un minuto.
Quando compare Ready, il riquadro Latest export indica quando è stata eseguita, la dimensione del file e tre conteggi: Photos, Bibs e Photos without bibs. Indica anche i campi presenti nel file. Seleziona Download JSON per salvarlo.
Ogni evento conserva l'ultima esportazione di ciascun tipo, quindi una nuova esportazione sostituisce quella mostrata nella pagina.
Passo 4: leggi il file
Ogni file inizia con gli stessi dati: event_id, export_type, generated_at, options (i campi inclusi) e counts. Le foto sono sotto data. Ecco un file con nome del file, percorso, pettorali e tag manuali:
{
"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": []
}
}
}
Alcune cose da sapere quando lo leggi:
- La chiave di ogni voce è l'ID della foto in 9Pic AI, non il nome del file. Se ti serve il nome, spunta Original file name.
- Le foto senza pettorali sono comunque elencate, con un elenco vuoto. È così che si conta
photos_without_bibs. - Una foto da un link personalizzato ha
nullcome percorso del file, perché non ha una cartella.
Controllalo prima di scaricarlo
Sotto l'ultima esportazione, File preview mostra l'inizio del file, con la stessa struttura. Seleziona una chiave o la sua freccia per aprirla o chiuderla, oppure usa Expand all e Collapse all. Raw mostra il testo semplice con i numeri di riga, e Copy copia l'anteprima.
L'anteprima contiene le prime 20 foto, e gli elenchi lunghi sono tagliati con una riga come “… 5 more items in the download”. Le voci chiuse mostrano quante chiavi o elementi contengono nel file completo, quindi i conteggi sono reali anche quando l'anteprima è breve.
Tre usi pratici
Ricollega i tag agli originali del fotografo
Spunta Original file name e File path. Ora ogni voce ti dice da quale file e da quale cartella proviene, così chi fotografa o chi fa l'editing trova l'originale di un pettorale senza cercare nella galleria.
Trova le foto senza pettorali
Cerca le voci con l'elenco bibs vuoto. Molte saranno foto del pubblico, paesaggi o la linea di partenza. Altre potrebbero ritrarre runner con il pettorale nascosto. Vale la pena ripassarle in Manual Tagging; vedi come taggare a mano i pettorali dopo l'AI.
Controlla cosa è stato corretto
Spunta Detected bibs e Removed bibs per vedere cosa ha trovato la lettura dei pettorali e cosa ha tolto il tuo team. È un modo rapido per rivedere un giro di tagging o per spiegare perché un runner non trova più una foto.
Cosa conta come pettorale
Nel file ci sono solo le foto elaborate. Il campo Bibs segue le stesse regole della ricerca dei partecipanti:
- Pettorali trovati con le impostazioni di rilevamento dei pettorali dell'evento. Se l'evento usa il suo elenco di pettorali, contano solo quelli in elenco.
- Meno i pettorali rilevati che hai rimosso.
- Più i tuoi tag manuali, anche prima che siano pubblicati nella ricerca dei partecipanti.
Il file corrisponde quindi a ciò che trovano i partecipanti, con in anticipo i tuoi tag manuali più recenti.
Domande frequenti
Il file si aggiorna quando cambio i tag?
No. Un file mostra i tag al momento dell'esportazione. Dopo il tagging, seleziona Export again.
Quali piani la includono?
Tutti i piani. Funziona anche dopo la fine di un piano, così puoi sempre portare con te i tuoi dati.
L'esportazione non è riuscita. E ora?
Seleziona Export again. Se un download non va a buon fine, riprova: ogni clic prepara un nuovo link di download.
Posso aprire il file in un foglio di calcolo?
Il JSON è pensato per i software, quindi la strada più semplice è passarlo a chi gestisce il tuo sistema di classifiche o di iscrizione. Anche la maggior parte degli strumenti per i dati e dei componenti aggiuntivi per fogli di calcolo può importare JSON.
Cosa fare dopo
Fai una prima esportazione con i campi predefiniti e apri File preview per vedere la struttura del tuo evento. Poi aggiungi nome e percorso del file se devi ritrovare gli originali. Per un elenco di ogni pettorale con le sue foto, leggi come esportare le foto di gara per numero di pettorale. La lettura dei pettorali è spiegata nella pagina di BibTrack.