Como exportar fotos de corrida por número de peito
Parceiros de cronometragem, sites de resultados e a secretaria da prova pensam em números de peito. O Bib to Data Export entrega exatamente isso: cada número de peito do seu evento com a lista de IDs das fotos em que aparece, em um só arquivo JSON.
Em resumo: abra o seu evento, vá em Photo, depois em Tools, e escolha Bib to Data Export. Selecione Export; não há campos para escolher. Quando aparecer Ready, selecione Download JSON. Cada número de peito no arquivo aponta para uma lista simples de IDs de fotos.
Quando você quer as fotos por número de peito
Comece por aqui quando quem usa os dados parte de um corredor, e não de uma foto:
- Um parceiro de resultados ou de cronometragem que quer mostrar a quantidade de fotos ou um link para as fotos ao lado de cada finisher.
- A secretaria da prova, respondendo "quantas fotos temos do número 1024?" sem abrir a galeria.
- Uma verificação de cobertura: quais corredores inscritos não têm nenhuma foto.
Se você parte das fotos e quer números de peito, marcações, nomes de arquivo ou caminhos de cada uma, use o Photos to Data Export.
Passo 1: exporte
No painel, abra o evento, vá em Photo e selecione a aba Tools. Escolha Bib to Data Export. Antes ela se chamava Bib to Photos Export, e os links antigos ainda abrem a ferramenta.
Essa exportação não tem nada para configurar, então a coluna da esquerda só tem o botão Export. Selecione-o. A exportação roda em segundo plano e mostra quantas fotos já leu. Você pode sair da página, e 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. Selecione Download JSON para salvar o arquivo.
Passo 2: leia o arquivo
O arquivo começa com event_id, export_type, generated_at, options (sempre vazio nessa exportação) e counts. Os números de peito ficam em data, cada um com uma lista de IDs de fotos:
{
"event_id": 6109,
"export_type": "bib_to_photos",
"generated_at": "2026-11-17T09:30:00+00:00",
"options": [],
"counts": {"photos": 30240, "bibs": 7374, "photos_without_bibs": 2086},
"data": {
"7": ["a81c...04de"],
"1024": ["3f2a...c91e", "8b10...77e1", "c4e9...1a52"],
"1025": ["9d03...6b7f"],
"A17": ["5be2...90cd", "3f2a...c91e"]
}
}
- Os números de peito vêm em ordem: primeiro os numéricos, do menor para o maior, depois os que têm letras.
- Uma foto pode aparecer em vários números de peito. No exemplo, a foto
3f2a...c91emostra o 1024 e o A17, então aparece nos dois. - Só aparecem os números de peito com fotos. Um corredor sem fotos não tem entrada. As fotos sem número de peito também não aparecem; a contagem
photos_without_bibsdiz quantas são.
O ID da foto é o identificador único da foto na 9Pic AI, não o nome do arquivo. A próxima seção mostra como obter os nomes de arquivo.
Confira no File preview
Abaixo da última exportação, o File preview mostra o início do arquivo. Selecione um número de peito para abrir a lista de IDs de fotos. A prévia traz os primeiros 20 números e até 5 IDs de fotos para cada um; uma lista mais longa termina com uma linha como "… 12 more photos in the download". A linha data mostra a quantidade real de números de peito no arquivo completo.
Use Raw para ver texto simples com números de linha, ou Copy para colar a prévia em uma mensagem para o seu parceiro, que assim vê o formato antes de você enviar o arquivo completo.
Troque os IDs das fotos por nomes de arquivo
Às vezes os parceiros precisam de nomes de arquivo em vez de IDs, por exemplo para pegar os originais na pasta do fotógrafo. Faça uma exportação Photos to Data Export com Original file name marcado. As entradas dela usam os mesmos IDs de fotos como chave, então os dois arquivos se cruzam pelo ID.
Quem tem familiaridade com algumas linhas de Python pode fazer assim:
import json
bibs = json.load(open("bib-to-data.json"))["data"]
photos = json.load(open("photos-to-data.json"))["data"]
for bib, photo_ids in bibs.items():
names = [photos[photo_id]["file_name"] for photo_id in photo_ids]
print(bib, len(names), ", ".join(names))
Cada linha mostra um número de peito, quantas fotos ele tem e os nomes dos arquivos. Exporte os dois arquivos ao mesmo tempo para que descrevam as mesmas marcações.
Encontre corredores sem fotos
Como o arquivo só tem números de peito com fotos, compará-lo com a sua lista de largada mostra quem está faltando. Pegue os números da sua exportação de inscrições e procure cada um entre as chaves em data. Os que não estão lá ainda não têm fotos marcadas.
Alguns não largaram. Outros ficaram escondidos no pelotão ou atrás de uma jaqueta. Procure esses corredores na galeria, por selfie se o seu evento tiver busca por selfie, e marque à mão as fotos que encontrar; veja como marcar números de peito depois da IA. Depois exporte de novo.
O que conta como número de peito
Só as fotos processadas entram, e os números de peito seguem 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 no Manual Tagging.
- Mais as suas marcações manuais, mesmo antes de serem publicadas na busca dos participantes.
Assim, a lista de um corredor corresponde ao que ele encontra ao digitar o seu número, mais as suas marcações manuais mais recentes.
Perguntas frequentes
Posso incluir o texto lido em cada foto?
Não nessa exportação: ela lista só IDs de fotos, para o arquivo ficar pequeno e simples. Para o texto de cada foto, use o Photos to Data Export com Detected text marcado.
O arquivo é atualizado quando as marcações mudam?
Não. Ele reflete as marcações do momento em que foi gerado. Depois de uma rodada de marcação, selecione Export again. Cada evento guarda a sua última exportação.
Quais planos incluem essa exportação?
Todos os planos, e ela continua funcionando depois que um plano termina.
Meu parceiro de cronometragem pode puxar isso automaticamente?
A exportação é um arquivo que você baixa e compartilha. Parceiros que querem busca por número de peito em tempo real no próprio app podem conhecer a 9Pic API.
Próximos passos
Faça uma exportação depois da primeira rodada de marcação, abra o File preview e envie o arquivo para quem cuida dos seus resultados. Se também precisar de nomes de arquivo ou caminhos, use junto o Photos to Data Export. Para que mais números de peito entrem no arquivo desde o início, veja como o BibTrack faz a leitura.