Como exportar os dados das fotos do seu evento em JSON
As marcações do seu evento também são úteis fora da galeria: para um parceiro de resultados, para os seus próprios registros ou para ligar as fotos às pastas do fotógrafo. O Photos to Data Export coloca todas as fotos processadas em um único arquivo JSON, com os números de peito e os outros campos que você escolher.
Em resumo: abra o seu evento, vá em Photo, depois em Tools, e escolha Photos to Data Export. Marque os Fields to include, selecione Export e baixe o arquivo JSON quando aparecer Ready. Cada foto processada ganha uma entrada, inclusive as fotos sem número de peito.
O que a exportação entrega
O Photos to Data Export responde a uma pergunta para cada foto do seu evento: o que sabemos sobre ela? O arquivo tem uma entrada por foto processada, identificada pelo ID da foto, com os campos que você escolheu.
É a exportação certa quando você parte das fotos:
- Ligar as marcações aos originais. O nome e o caminho do arquivo mostram a qual arquivo da pasta do fotógrafo cada entrada corresponde.
- Achar as fotos que ninguém encontra. As fotos sem número de peito estão no arquivo com uma lista vazia, prontas para uma segunda olhada.
- Manter o seu próprio registro. Uma cópia das marcações do evento como estavam em um determinado dia, para o seu arquivo ou para outro sistema.
Se você parte dos corredores e quer cada número de peito com as suas fotos, use o Bib to Data Export.
Passo 1: abra a ferramenta
No painel, abra o evento, vá em Photo e selecione a aba Tools. Escolha Photos to Data Export. Antes ela se chamava Photos to Bib Export, e os links antigos ainda abrem a ferramenta.
A página tem duas colunas. À esquerda ficam os campos e o botão Export. À direita fica o Latest export com uma prévia do arquivo. Antes da sua primeira exportação, o lado direito mostra um Example file para você ver o formato.
Passo 2: escolha os campos
Bibs e Manual tags já vêm marcados. Adicione os outros de que precisar. É preciso marcar pelo menos um.
| Campo | O que contém |
|---|---|
| Bibs | Os números de peito pelos quais os participantes encontram a foto: os detectados mais as suas marcações manuais, menos os que você removeu. |
| Manual tags | Números de peito que você adicionou à mão no Manual Tagging. |
| Original file name | O nome da foto quando ela foi importada. |
| File path | Onde a foto está na origem, incluindo o nome. Para um upload na 9Pic, a pasta dentro do upload. Para Google Drive, Dropbox, OneDrive, Box ou SharePoint, o caminho dentro da pasta compartilhada. Fica vazio para fotos de um link personalizado. |
| Detected bibs | Números de peito encontrados na foto, antes de qualquer remoção. |
| Removed bibs | Números de peito detectados que você removeu no Manual Tagging. |
| Detected text | Todo o texto lido na foto, como nomes de patrocinadores e placas. |
Cada campo extra deixa o arquivo maior. O Detected text é o que mais pesa, então deixe-o desmarcado se não for usá-lo.
As caixas começam com os campos da sua última exportação. Se você mudar a seleção, um aviso lembra de exportar de novo para que o arquivo corresponda.
Passo 3: exporte e baixe
Selecione Export. A exportação roda em segundo plano e mostra quantas fotos já leu. Você pode sair da página e voltar depois. Um evento grande leva cerca de um minuto.
Quando aparecer Ready, o quadro Latest export mostra quando ela rodou, o tamanho do arquivo e três contagens: Photos, Bibs e Photos without bibs. Ele também lista os campos do arquivo. Selecione Download JSON para salvá-lo.
Cada evento guarda a última exportação de cada tipo, então uma nova exportação substitui a que aparece na página.
Passo 4: leia o arquivo
Todo arquivo começa com os mesmos dados: event_id, export_type, generated_at, options (os campos incluídos) e counts. As fotos ficam em data. Veja um arquivo com nome do arquivo, caminho, números de peito e marcações manuais:
{
"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": []
}
}
}
Alguns pontos importantes na hora de ler:
- A chave de cada entrada é o ID da foto na 9Pic AI. Não é o nome do arquivo. Marque Original file name quando precisar dele.
- As fotos sem número de peito continuam no arquivo, com uma lista vazia. É assim que
photos_without_bibsé contado. - Uma foto de um link personalizado tem
nullcomo caminho do arquivo, porque não tem pasta.
Confira antes de baixar
Abaixo da última exportação, o File preview mostra o início do arquivo, com o mesmo formato. Selecione uma chave ou a sua seta para abrir ou recolher, ou use Expand all e Collapse all. Raw mostra texto simples com números de linha, e Copy copia a prévia.
A prévia traz as primeiras 20 fotos, e as listas longas são cortadas com uma linha como "… 5 more items in the download". As entradas recolhidas mostram quantas chaves ou itens têm no arquivo completo, então as contagens são reais mesmo quando a prévia é curta.
Três usos práticos
Ligue as marcações aos originais do fotógrafo
Marque Original file name e File path. Agora cada entrada informa de qual arquivo e de qual pasta veio, então um fotógrafo ou editor encontra o original de um número de peito sem procurar na galeria.
Encontre as fotos sem número de peito
Procure as entradas com a lista bibs vazia. Muitas serão fotos de público, de paisagem ou da largada. Outras podem ser de corredores com o número escondido. Vale a pena revisá-las no Manual Tagging; veja como marcar números de peito à mão depois da IA.
Confira o que foi corrigido
Marque Detected bibs e Removed bibs para ver o que a leitura de números de peito encontrou e o que a sua equipe removeu. É um jeito rápido de revisar uma rodada de marcação ou de explicar por que um corredor não encontra mais uma foto.
O que conta como número de peito
Só as fotos processadas entram no arquivo. O campo Bibs segue as mesmas regras da busca dos participantes:
- Números de peito encontrados com as configurações de detecção do evento. Quando o evento usa a sua lista de números, só contam os números da lista.
- Menos os números detectados que você removeu.
- Mais as suas marcações manuais, mesmo antes de serem publicadas na busca dos participantes.
Assim, o arquivo corresponde ao que os participantes encontram, já com as suas marcações manuais mais recentes.
Perguntas frequentes
O arquivo é atualizado quando mudo as marcações?
Não. Um arquivo mostra as marcações do momento em que foi gerado. Depois de marcar, selecione Export again.
Quais planos incluem essa exportação?
Todos os planos. Ela também continua funcionando depois que um plano termina, então você ainda pode levar os seus dados.
A exportação falhou. E agora?
Selecione Export again. Se um download falhar, tente mais uma vez: cada clique prepara um novo link de download.
Posso abrir o arquivo em uma planilha?
JSON é feito para software, então o caminho mais fácil é entregá-lo a quem cuida do seu sistema de resultados ou de inscrições. A maioria das ferramentas de dados e dos complementos de planilhas também importa JSON.
Próximos passos
Faça uma primeira exportação com os campos padrão e abra o File preview para ver o formato do seu evento. Depois adicione o nome e o caminho do arquivo se precisar ligar as fotos aos originais. Para uma lista de cada número de peito com as suas fotos, leia como exportar fotos de corrida por número de peito. A leitura dos números de peito é explicada na página do BibTrack.