イベント写真のデータをJSONでエクスポートする方法
イベントのタグはギャラリーの外でも役立ちます。リザルトを扱うパートナーへの提供、自社の記録、フォトグラファーのフォルダーにある元写真との照合などです。Photos to Data Exportは、処理済みのすべての写真を、ゼッケン番号など選んだ項目とともに1つのJSONファイルにまとめます。
要約:イベントを開き、Photo、Toolsの順に進んでPhotos to Data Exportを選びます。Fields to includeで項目にチェックを入れてExportを選び、Readyと表示されたらJSONファイルをダウンロードします。ゼッケン番号のない写真も含め、処理済みの写真はすべて1エントリーずつ出力されます。
エクスポートで得られるデータ
Photos to Data Exportは、イベントの写真1枚ごとに「その写真について何がわかっているか」をまとめます。ファイルには処理済みの写真が1枚につき1エントリーずつ、写真IDをキーとして、選んだ項目とともに入ります。
写真を起点にデータを扱うときに向いているエクスポートです。
- タグを元写真と照合する。ファイル名とパスから、各エントリーがフォトグラファーのフォルダー内のどのファイルかがわかります。
- 誰も見つけられない写真を探す。ゼッケン番号のない写真も空のリストとしてファイルに入るので、見直しにすぐ使えます。
- 自社の記録として残す。ある日の時点でのイベントのタグを、アーカイブや別のシステム用に保存できます。
ランナーを起点に、ゼッケン番号ごとの写真一覧が必要な場合はBib to Data Exportを使います。
ステップ1:ツールを開く
ダッシュボードでイベントを開き、Photoに進んでToolsタブを選びます。次にPhotos to Data Exportを選択します。以前の名称はPhotos to Bib Exportで、古いリンクからも開けます。
画面は2列に分かれています。左側には項目とExportボタン、右側にはLatest exportとそのファイルのプレビューがあります。初めてエクスポートする前は、右側にExample fileが表示され、ファイルの形を確認できます。
ステップ2:項目を選ぶ
BibsとManual tagsには最初からチェックが入っています。必要に応じてほかの項目も追加します。少なくとも1つは選択してください。
| 項目 | 内容 |
|---|---|
| Bibs | 参加者がその写真を検索できるゼッケン番号です。検出された番号に手動タグを加え、削除したものを除きます。 |
| Manual tags | Manual Taggingで手動で追加したゼッケン番号です。 |
| Original file name | 取り込んだ時点での写真のファイル名です。 |
| File path | 取り込み元での写真の場所で、ファイル名も含みます。9Picにアップロードした写真ではアップロード内のフォルダー、Google Drive、Dropbox、OneDrive、Box、SharePointでは共有フォルダー内のパスです。カスタムリンクから取り込んだ写真では空になります。 |
| Detected bibs | 写真から検出されたゼッケン番号で、削除する前のものです。 |
| Removed bibs | Manual Taggingで削除した、検出済みのゼッケン番号です。 |
| Detected text | スポンサー名や看板など、写真から読み取ったすべての文字です。 |
項目を追加するほどファイルは大きくなります。特にDetected textは容量が大きく増えるため、使う予定がなければオフのままにしてください。
チェックボックスには前回のエクスポートの項目が最初から入っています。変更すると、ファイルと一致させるために再度エクスポートするよう案内が表示されます。
ステップ3:エクスポートしてダウンロード
Exportを選びます。エクスポートはバックグラウンドで実行され、読み込んだ写真の枚数が表示されます。ページを離れて後から戻っても問題ありません。大規模なイベントでは1分ほどかかります。
Readyと表示されると、Latest export欄に実行日時、ファイルサイズ、3つの件数(Photos、Bibs、Photos without bibs)が表示されます。ファイルに含まれる項目も確認できます。Download JSONを選んで保存します。
イベントごとに種類別の最新のエクスポートが保存されるため、新しくエクスポートすると画面に表示中のものが置き換わります。
ステップ4:ファイルを読む
どのファイルも冒頭は共通で、event_id、export_type、generated_at、options(含まれる項目)、countsが入ります。写真はdataの下に並びます。以下は、ファイル名、ファイルパス、ゼッケン番号、手動タグを含むファイルの例です。
{
"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": []
}
}
}
読むときのポイントは次のとおりです。
- 各エントリーのキーは9Pic AI内の写真IDで、ファイル名ではありません。ファイル名が必要な場合はOriginal file nameにチェックを入れてください。
- ゼッケン番号のない写真も、空のリストとして含まれます。
photos_without_bibsはこうした写真の枚数です。 - カスタムリンクから取り込んだ写真はフォルダーがないため、ファイルパスが
nullになります。
ダウンロード前に確認する
最新のエクスポートの下にあるFile previewには、ファイルの冒頭が同じ構造で表示されます。キーまたはその矢印を選ぶと開閉でき、Expand allとCollapse allでまとめて操作することもできます。Rawでは行番号付きのプレーンテキストが表示され、Copyでプレビューをコピーできます。
プレビューには最初の20枚の写真が表示され、長いリストは「… 5 more items in the download」のような行で省略されます。折りたたんだエントリーには完全なファイルでのキー数や要素数が表示されるため、プレビューが短くても件数は正確です。
3つの活用例
タグをフォトグラファーの元写真と照合する
Original file nameとFile pathにチェックを入れます。各エントリーにどのフォルダーのどのファイルかが入るので、フォトグラファーや編集担当者はギャラリーを検索しなくても、ゼッケン番号から元写真を見つけられます。
ゼッケン番号のない写真を探す
bibsのリストが空のエントリーを探します。多くは観客や風景、スタートラインの写真ですが、ゼッケンが隠れたランナーの写真もあります。そうした写真はManual Taggingで見直す価値があります。詳しくはAI処理後にゼッケン番号を手動でタグ付けする方法をご覧ください。
修正内容を確認する
Detected bibsとRemoved bibsにチェックを入れると、ゼッケン番号の読み取りで見つかったものと、チームが削除したものがわかります。タグ付け作業の見直しや、ランナーが写真を見つけられなくなった理由の説明にすぐ使えます。
ゼッケン番号として扱われるもの
ファイルに含まれるのは処理済みの写真だけです。Bibs項目は、参加者の検索と同じルールに従います。
- イベントのゼッケン番号検出設定で見つかった番号が対象です。ゼッケン番号リストを使うイベントでは、リストにある番号だけが対象になります。
- 検出された番号のうち、削除したものは除きます。
- 手動タグは、参加者の検索に公開する前でも加わります。
そのため、ファイルの内容は参加者が見つけられる写真と一致し、最新の手動タグも先に反映されます。
よくある質問
タグを変更するとファイルも更新されますか?
いいえ。ファイルには実行した時点のタグが反映されます。タグ付けの後はExport againを選んでください。
どのプランで使えますか?
すべてのプランで使えます。プランの終了後も使えるので、データを手元に残せます。
エクスポートに失敗した場合は?
Export againを選んでください。ダウンロードに失敗した場合は、もう一度お試しください。クリックするたびに新しいダウンロードリンクが用意されます。
ファイルをスプレッドシートで開けますか?
JSONはソフトウェア向けの形式なので、リザルトや参加登録のシステムを運用する担当者に渡すのがいちばん簡単です。多くのデータツールやスプレッドシートのアドオンでもJSONを読み込めます。
次のステップ
まずは初期設定の項目でエクスポートし、File previewでイベントのデータの形を確認します。元写真との照合が必要なら、ファイル名とパスを追加します。ゼッケン番号ごとの写真一覧についてはレース写真をゼッケン番号ごとにエクスポートする方法をご覧ください。ゼッケン番号の読み取りについてはBibTrackのページで解説しています。