レース写真をゼッケン番号ごとにエクスポートする方法
計測会社、リザルトサイト、大会事務局は、ゼッケン番号を軸にデータを扱います。Bib to Data Exportはまさにその形で渡せます。イベントのすべてのゼッケン番号と、その番号が写る写真IDの一覧を、1つのJSONファイルにまとめます。
要約:イベントを開き、Photo、Toolsの順に進んでBib to Data Exportを選びます。選ぶ項目はないので、そのままExportを選びます。Readyと表示されたらDownload JSONを選びます。ファイルでは、各ゼッケン番号に写真IDのシンプルなリストが対応します。
ゼッケン番号ごとの写真が必要なとき
データを使う人が写真ではなくランナーを起点に考える場合は、このエクスポートが適しています。
- リザルトや計測のパートナー:完走者ごとに写真の枚数や写真へのリンクを表示したい場合。
- 大会事務局:「ゼッケン番号1024の写真は何枚あるか」という質問に、ギャラリーを開かずに答えたい場合。
- 撮影漏れの確認:登録したランナーのうち、写真が1枚もない人を調べたい場合。
写真を起点に、写真ごとのゼッケン番号、タグ、ファイル名、パスが必要な場合はPhotos to Data Exportを使います。
ステップ1:エクスポート
ダッシュボードでイベントを開き、Photoに進んでToolsタブを選びます。次にBib to Data Exportを選択します。以前の名称はBib to Photos Exportで、古いリンクからも開けます。
このエクスポートには設定がないため、左側にはExportボタンだけがあります。これを選ぶと、エクスポートがバックグラウンドで実行され、読み込んだ写真の枚数が表示されます。ページを離れても問題ありません。大規模なイベントでは1分ほどかかります。
Readyと表示されると、Latest export欄に実行日時、ファイルサイズ、3つの件数(Photos、Bibs、Photos without bibs)が表示されます。Download JSONを選んでファイルを保存します。
ステップ2:ファイルを読む
ファイルの冒頭にはevent_id、export_type、generated_at、options(このエクスポートでは常に空)、countsが入ります。ゼッケン番号はdataの下に並び、それぞれに写真IDの配列が付きます。
{
"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"]
}
}
- ゼッケン番号は順番に並びます:数字だけの番号が小さい順に並び、その後に英字を含む番号が続きます。
- 1枚の写真が複数のゼッケン番号の下に入ることがあります。例の写真
3f2a...c91eには1024とA17の両方が写っているため、それぞれの下に記載されています。 - 記載されるのは写真のあるゼッケン番号だけです。写真のないランナーにはエントリーがありません。ゼッケン番号のない写真も記載されませんが、その枚数は
photos_without_bibsでわかります。
写真IDは9Pic AI内で写真ごとに一意のIDで、ファイル名ではありません。ファイル名を取得する方法は次のセクションで説明します。
File previewで確認する
最新のエクスポートの下にあるFile previewには、ファイルの冒頭が表示されます。ゼッケン番号を選ぶと、その写真IDの一覧が開きます。プレビューには最初の20件のゼッケン番号と、それぞれ最大5件の写真IDが表示され、それより長いリストは「… 12 more photos in the download」のような行で終わります。dataの行には、完全なファイルでの実際のゼッケン番号の数が表示されます。
Rawでは行番号付きのプレーンテキストを表示できます。Copyでプレビューをコピーしてパートナーへのメッセージに貼り付ければ、ファイル全体を送る前にデータの形を見てもらえます。
写真IDをファイル名に変換する
フォトグラファーのフォルダーから元写真を取り出すときなど、パートナーがIDではなくファイル名を必要とすることがあります。その場合はOriginal file nameにチェックを入れてPhotos to Data Exportを実行します。エントリーのキーは同じ写真IDなので、2つのファイルをIDで結び付けられます。
数行のPythonを書ける方なら、次のように処理できます。
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))
各行にゼッケン番号、写真の枚数、ファイル名が出力されます。2つのファイルが同じタグを反映するよう、両方を同じタイミングでエクスポートしてください。
写真のないランナーを探す
ファイルには写真のあるゼッケン番号しか入らないため、スタートリストと比べれば誰が抜けているかがわかります。参加登録データからゼッケン番号を取り出し、dataの下のキーと1つずつ照合します。見つからない番号には、まだタグ付けされた写真がありません。
出走しなかったランナーもいれば、集団の中やジャケットの陰でゼッケンが隠れていたランナーもいます。そうしたランナーをギャラリーで探し(イベントでセルフィー検索が使えるならセルフィーで)、見つかった写真を手動でタグ付けします。詳しくはAI処理後にゼッケン番号をタグ付けする方法をご覧ください。その後、もう一度エクスポートします。
ゼッケン番号として扱われるもの
対象は処理済みの写真だけで、ゼッケン番号は参加者の検索と同じルールに従います。
- イベントのゼッケン番号検出設定で見つかった番号が対象です。ゼッケン番号リストを使うイベントでは、リストにある番号だけが対象になります。
- 検出された番号のうち、Manual Taggingで削除したものは除きます。
- 手動タグは、参加者の検索に公開する前でも加わります。
そのため、各ランナーのリストは本人がゼッケン番号を入力して見つけられる写真と一致し、最新の手動タグも加わります。
よくある質問
各写真から読み取った文字も追加できますか?
このエクスポートではできません。写真IDだけを記載するので、ファイルが小さくシンプルに保たれます。写真ごとの文字が必要な場合は、Detected textにチェックを入れてPhotos to Data Exportを実行してください。
タグが変わるとファイルも更新されますか?
いいえ。ファイルには実行した時点のタグが反映されます。タグ付け作業の後はExport againを選んでください。イベントごとに最新のエクスポートが保存されます。
どのプランで使えますか?
すべてのプランで使えます。プランの終了後も引き続き使えます。
計測パートナーがこのデータを自動で取得できますか?
このエクスポートは、ダウンロードして共有するファイルです。自社のアプリでゼッケン番号をリアルタイムに検索したいパートナーは、9Pic APIをご確認ください。
次のステップ
最初のタグ付け作業が終わったらエクスポートを実行し、File previewを確認してから、リザルトの担当者にファイルを送ります。ファイル名やパスも必要なら、Photos to Data Exportと組み合わせます。そもそもファイルに入るゼッケン番号を増やしたい場合は、BibTrackによる読み取りの仕組みをご覧ください。