データガイド
9P
9Pic AIチーム • 2026年11月13日 • 7分で読めます

イベント写真のデータをJSONでエクスポートする方法

イベントのタグはギャラリーの外でも役立ちます。リザルトを扱うパートナーへの提供、自社の記録、フォトグラファーのフォルダーにある元写真との照合などです。Photos to Data Exportは、処理済みのすべての写真を、ゼッケン番号など選んだ項目とともに1つのJSONファイルにまとめます。

イベント写真のデータをJSONでエクスポートする方法:写真1枚につき1エントリーで、ゼッケン番号、手動タグ、ファイル名、パスを出力

要約:イベントを開き、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 tagsManual Taggingで手動で追加したゼッケン番号です。
Original file name取り込んだ時点での写真のファイル名です。
File path取り込み元での写真の場所で、ファイル名も含みます。9Picにアップロードした写真ではアップロード内のフォルダー、Google Drive、Dropbox、OneDrive、Box、SharePointでは共有フォルダー内のパスです。カスタムリンクから取り込んだ写真では空になります。
Detected bibs写真から検出されたゼッケン番号で、削除する前のものです。
Removed bibsManual 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のページで解説しています。

さっそく始めましょう

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

Read the 9Pic AI website in English?

Your browser is set to English, and this page is also available in English.

This only changes the language of this website. Event galleries have their own language settings.

Switch to English

¿Leer el sitio web de 9Pic AI en español?

Tu navegador está configurado en español y esta página también está disponible en español.

Esto solo cambia el idioma de este sitio web. Las galerías de eventos tienen su propia configuración de idioma.

Cambiar a español

Ler o site da 9Pic AI em português?

Seu navegador está configurado em português e esta página também está disponível em português.

Isso muda apenas o idioma deste site. As galerias de eventos têm suas próprias configurações de idioma.

Mudar para português

Lire le site 9Pic AI en français ?

Votre navigateur est configuré en français et cette page est aussi disponible en français.

Cela change uniquement la langue de ce site. Les galeries d'événements ont leurs propres réglages de langue.

Passer au français

Die Website von 9Pic AI auf Deutsch lesen?

Ihr Browser ist auf Deutsch eingestellt, und diese Seite gibt es auch auf Deutsch.

Dadurch ändert sich nur die Sprache dieser Website. Eventgalerien haben eigene Spracheinstellungen.

Zu Deutsch wechseln

Vuoi leggere il sito di 9Pic AI in italiano?

Il tuo browser è impostato in italiano e questa pagina è disponibile anche in italiano.

Questa scelta cambia solo la lingua del sito. Le gallerie degli eventi hanno impostazioni di lingua proprie.

Passa all'italiano

Ingin membaca situs 9Pic AI dalam bahasa Indonesia?

Browser Anda menggunakan bahasa Indonesia dan halaman ini juga tersedia dalam bahasa Indonesia.

Pilihan ini hanya mengubah bahasa situs ini. Galeri acara memiliki pengaturan bahasanya sendiri.

Gunakan bahasa Indonesia

9Pic AI web sitesini Türkçe okumak ister misiniz?

Tarayıcınızın dili Türkçe ve bu sayfanın Türkçe sürümü de mevcut.

Bu seçim yalnızca bu web sitesinin dilini değiştirir. Etkinlik galerilerinin kendi dil ayarları vardır.

Türkçeye geçin

Bạn muốn xem trang web 9Pic AI bằng tiếng Việt?

Trình duyệt của bạn đang dùng tiếng Việt và trang này cũng có phiên bản tiếng Việt.

Lựa chọn này chỉ đổi ngôn ngữ của trang web. Thư viện ảnh sự kiện có cài đặt ngôn ngữ riêng.

Chuyển sang tiếng Việt

Zobrazit web 9Pic AI v češtině?

Váš prohlížeč používá češtinu a tato stránka je dostupná i česky.

Změní se jen jazyk tohoto webu. Galerie akcí mají vlastní nastavení jazyka.

Přepnout do češtiny

Želite li čitati web-stranicu 9Pic AI na hrvatskom?

Vaš je preglednik postavljen na hrvatski jezik, a ova je stranica dostupna i na hrvatskom.

Mijenja se samo jezik ove web-stranice. Galerije događanja imaju vlastite postavke jezika.

Prebacite na hrvatski

Da li želite da čitate sajt 9Pic AI na srpskom?

Vaš pretraživač je podešen na srpski jezik, a ova stranica je dostupna i na srpskom.

Menja se samo jezik ovog sajta. Galerije događaja imaju sopstvena podešavanja jezika.

Prebacite na srpski