<!-- Source: https://9pic.ai/ja/blog/export-event-photo-data-json/ -->
![抽象的なストライプの背景](/images/stripes.svg)

[ブログ一覧に戻る](/ja/blog/)

![イベント写真のデータをJSONでエクスポートする方法：写真1枚につき1エントリーで、ゼッケン番号、手動タグ、ファイル名、パスを出力](https://bgimg.9pic.ai/images/blog/export-event-photo-data-json.jpg?title=%E3%82%A4%E3%83%99%E3%83%B3%E3%83%88%E5%86%99%E7%9C%9F%E3%81%AE%E3%83%87%E3%83%BC%E3%82%BF%E3%82%92JSON%E3%81%A7%E3%82%A8%E3%82%AF%E3%82%B9%E3%83%9D%E3%83%BC%E3%83%88%E3%81%99%E3%82%8B%E6%96%B9%E6%B3%95&amp;subtitle=%E5%86%99%E7%9C%9F1%E6%9E%9A%E3%81%AB%E3%81%A4%E3%81%8D1%E3%82%A8%E3%83%B3%E3%83%88%E3%83%AA%E3%83%BC%EF%BC%9A%E3%82%BC%E3%83%83%E3%82%B1%E3%83%B3%E7%95%AA%E5%8F%B7%E3%80%81%E6%89%8B%E5%8B%95%E3%82%BF%E3%82%B0%E3%80%81%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E5%90%8D%E3%80%81%E3%83%91%E3%82%B9%E3%82%921%E3%81%A4%E3%81%AE%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E3%81%AB%E3%80%82&amp;kicker=%E3%83%87%E3%83%BC%E3%82%BF%E3%82%AC%E3%82%A4%E3%83%89&amp;author=9Pic+AI%E3%83%81%E3%83%BC%E3%83%A0&amp;readTime=7%E5%88%86&amp;lang=ja)

**要約**：イベントを開き、**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](/ja/blog/export-race-photos-by-bib-number/)を使います。

ステップ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処理後にゼッケン番号を手動でタグ付けする方法](/ja/blog/manual-bib-tagging-after-ai/)をご覧ください。

### 修正内容を確認する

**Detected bibs**と**Removed bibs**にチェックを入れると、ゼッケン番号の読み取りで見つかったものと、チームが削除したものがわかります。タグ付け作業の見直しや、ランナーが写真を見つけられなくなった理由の説明にすぐ使えます。

ゼッケン番号として扱われるもの
---------------------------------------------

ファイルに含まれるのは**処理済み**の写真だけです。**Bibs**項目は、参加者の検索と同じルールに従います。

- イベントのゼッケン番号検出設定で見つかった番号が対象です。ゼッケン番号リストを使うイベントでは、リストにある番号だけが対象になります。
- 検出された番号のうち、削除したものは除きます。
- 手動タグは、参加者の検索に公開する前でも加わります。


そのため、ファイルの内容は参加者が見つけられる写真と一致し、最新の手動タグも先に反映されます。

よくある質問
------------------

### タグを変更するとファイルも更新されますか？

いいえ。ファイルには実行した時点のタグが反映されます。タグ付けの後は**Export again**を選んでください。

### どのプランで使えますか？

すべてのプランで使えます。プランの終了後も使えるので、データを手元に残せます。

### エクスポートに失敗した場合は？

**Export again**を選んでください。ダウンロードに失敗した場合は、もう一度お試しください。クリックするたびに新しいダウンロードリンクが用意されます。

### ファイルをスプレッドシートで開けますか？

JSONはソフトウェア向けの形式なので、リザルトや参加登録のシステムを運用する担当者に渡すのがいちばん簡単です。多くのデータツールやスプレッドシートのアドオンでもJSONを読み込めます。

次のステップ
------------------

まずは初期設定の項目でエクスポートし、File previewでイベントのデータの形を確認します。元写真との照合が必要なら、ファイル名とパスを追加します。ゼッケン番号ごとの写真一覧については[レース写真をゼッケン番号ごとにエクスポートする方法](/ja/blog/export-race-photos-by-bib-number/)をご覧ください。ゼッケン番号の読み取りについては[BibTrack](/ja/products/bibtrack/)のページで解説しています。

さっそく始めましょう
------------------------------

写真のホスティング、AI検索、メディア配信に9Pic AIを活用するイベント主催者は、これまでに5,000件以上のイベントで500万人以上の参加者に1億枚以上の写真を届けています。

[今すぐ始める](https://admin.9pic.ai/sign-up) [デモを予約](/ja/contact/)
