Cara mengekspor data foto acara Anda sebagai JSON
Tag acara Anda juga berguna di luar galeri: untuk mitra hasil lomba, arsip Anda sendiri, atau mencocokkan foto dengan folder fotografer. Photos to Data Export memasukkan setiap foto yang sudah diproses ke satu file JSON, beserta nomor BIB dan kolom lain yang Anda pilih.
Ringkasan: buka acara Anda, masuk ke Photo, lalu Tools, dan pilih Photos to Data Export. Centang kolom di Fields to include, pilih Export, lalu unduh file JSON saat muncul Ready. Setiap foto yang sudah diproses mendapat satu entri, termasuk foto tanpa nomor BIB.
Isi file ekspor
Photos to Data Export menjawab satu pertanyaan untuk setiap foto di acara Anda: informasi apa saja yang tersedia tentang foto ini? File berisi satu entri per foto yang sudah diproses, dengan ID foto sebagai kunci, beserta kolom yang Anda pilih.
Ekspor ini tepat digunakan saat Anda berangkat dari foto:
- Mencocokkan tag dengan file asli. Nama file dan jalurnya menunjukkan file mana di folder fotografer yang sesuai dengan setiap entri.
- Menemukan foto yang tidak bisa ditemukan siapa pun. Foto tanpa nomor BIB tetap ada di file dengan daftar kosong, siap diperiksa ulang.
- Menyimpan catatan sendiri. Salinan tag acara sebagaimana adanya pada hari tertentu, untuk arsip Anda atau sistem lain.
Jika Anda justru berangkat dari pelari dan ingin setiap nomor BIB beserta fotonya, gunakan Bib to Data Export.
Langkah 1: Buka alat ekspor
Di dashboard, buka acara, masuk ke Photo, lalu pilih tab Tools. Pilih Photos to Data Export. Sebelumnya alat ini bernama Photos to Bib Export, dan tautan lama tetap membukanya.
Halaman ini terbagi menjadi dua bagian. Di sebelah kiri ada daftar kolom data dan tombol Export. Di sebelah kanan ada Latest export dan pratinjau filenya. Sebelum ekspor pertama, sisi kanan menampilkan Example file agar Anda bisa melihat strukturnya.
Langkah 2: Pilih kolom data
Bibs dan Manual tags sudah dicentang secara default. Tambahkan kolom lain yang Anda perlukan. Minimal satu kolom harus dipilih.
| Kolom | Isi |
|---|---|
| Bibs | Nomor BIB yang dipakai peserta untuk menemukan foto: nomor BIB yang terdeteksi ditambah tag manual Anda, dikurangi yang Anda hapus. |
| Manual tags | Nomor BIB yang Anda tambahkan secara manual di Manual Tagging. |
| Original file name | Nama foto saat diimpor. |
| File path | Lokasi foto di sumbernya, termasuk namanya. Untuk unggahan 9Pic, folder di dalam unggahan. Untuk Google Drive, Dropbox, OneDrive, Box, atau SharePoint, jalur di dalam folder bersama. Kosong untuk foto dari tautan kustom. |
| Detected bibs | Nomor BIB yang ditemukan di foto, sebelum ada yang Anda hapus. |
| Removed bibs | Nomor BIB terdeteksi yang Anda hapus di Manual Tagging. |
| Detected text | Semua teks yang terbaca di foto, seperti nama sponsor dan papan petunjuk. |
Setiap kolom tambahan membuat file lebih besar. Detected text menambah ukuran paling banyak, jadi biarkan tidak dicentang kecuali Anda akan memakainya.
Kotak centang awalnya mengikuti kolom ekspor terakhir Anda. Jika Anda mengubahnya, sebuah catatan mengingatkan Anda untuk mengekspor lagi agar file sesuai.
Langkah 3: Ekspor dan unduh
Pilih Export. Ekspor berjalan di latar belakang dan menampilkan jumlah foto yang sudah dibaca. Anda bisa meninggalkan halaman lalu kembali lagi. Acara besar butuh sekitar satu menit.
Saat muncul Ready, kotak Latest export menampilkan waktu ekspor, ukuran file, dan tiga hitungan: Photos, Bibs, dan Photos without bibs. Kotak ini juga menyebutkan kolom yang ada di file. Pilih Download JSON untuk menyimpannya.
Setiap acara menyimpan ekspor terbaru untuk tiap jenis, jadi ekspor baru menggantikan ekspor yang tampil di halaman.
Langkah 4: Baca file
Setiap file diawali dengan detail yang sama: event_id, export_type, generated_at, options (kolom yang disertakan), dan counts. Foto ada di bawah data. Berikut contoh file dengan nama file, jalur file, nomor BIB, dan tag manual:
{
"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": []
}
}
}
Beberapa hal yang perlu diketahui saat membacanya:
- Kunci setiap entri adalah ID foto di 9Pic AI, bukan nama file. Centang Original file name jika Anda memerlukan nama file.
- Foto tanpa nomor BIB tetap dicantumkan, dengan daftar kosong. Dari situlah
photos_without_bibsdihitung. - Foto dari tautan kustom memiliki jalur file
nullkarena tidak berada di folder.
Periksa sebelum mengunduh
Di bawah ekspor terbaru, File preview menampilkan awal file dengan susunan yang sama. Pilih kunci atau tanda panahnya untuk membuka atau menutupnya, atau gunakan Expand all dan Collapse all. Raw menampilkan teks biasa dengan nomor baris, dan Copy menyalin pratinjau.
Pratinjau memuat 20 foto pertama, dan daftar panjang dipotong dengan baris seperti "… 5 more items in the download". Entri yang ditutup menunjukkan jumlah kunci atau item di dalamnya pada file lengkap, jadi angkanya tetap akurat meski pratinjaunya pendek.
Tiga penggunaan praktis
Cocokkan tag dengan file asli fotografer
Centang Original file name dan File path. Setiap entri kini menunjukkan file dan folder asalnya, sehingga fotografer atau editor bisa menemukan file asli untuk suatu nomor BIB tanpa mencari di galeri.
Temukan foto tanpa nomor BIB
Cari entri dengan daftar bibs yang kosong. Banyak di antaranya foto penonton, pemandangan, atau garis start. Sebagian lain mungkin foto pelari dengan nomor BIB yang tertutup. Foto seperti itu layak diperiksa di Manual Tagging; lihat cara menandai nomor BIB secara manual setelah AI.
Periksa apa yang dikoreksi
Centang Detected bibs dan Removed bibs untuk melihat apa yang ditemukan pembacaan nomor BIB dan apa yang dihapus tim Anda. Ini cara cepat meninjau hasil penandaan, atau menjelaskan mengapa seorang pelari tidak lagi menemukan suatu foto.
Apa yang dihitung sebagai nomor BIB
Hanya foto yang sudah diproses yang masuk ke file. Kolom Bibs mengikuti aturan yang sama dengan pencarian peserta:
- Nomor BIB yang ditemukan dengan pengaturan deteksi nomor BIB acara. Jika acara memakai daftar nomor BIB, hanya nomor yang ada di daftar yang dihitung.
- Dikurangi nomor BIB terdeteksi yang Anda hapus.
- Ditambah tag manual Anda, bahkan sebelum dipublikasikan ke pencarian peserta.
Jadi isi file sesuai dengan yang ditemukan peserta, dan tag manual terbaru Anda sudah disertakan lebih awal.
FAQ
Apakah file diperbarui saat saya mengubah tag?
Tidak. File menampilkan tag pada saat ekspor dijalankan. Setelah menandai, pilih Export again.
Paket mana yang menyertakan fitur ini?
Semua paket. Fitur ini juga tetap berfungsi setelah paket berakhir, jadi Anda tetap bisa membawa data Anda.
Ekspor gagal. Apa yang harus dilakukan?
Pilih Export again. Jika unduhan gagal, coba sekali lagi: setiap klik menyiapkan tautan unduhan baru.
Bisakah saya membuka file di spreadsheet?
JSON dibuat untuk perangkat lunak, jadi cara termudah adalah menyerahkannya kepada pengelola sistem hasil lomba atau pendaftaran Anda. Sebagian besar alat data dan add-on spreadsheet juga bisa mengimpor JSON.
Langkah selanjutnya
Jalankan ekspor pertama dengan kolom default dan buka File preview untuk melihat struktur data acara Anda. Lalu tambahkan nama file dan jalur jika Anda perlu mencocokkan dengan file asli. Untuk daftar setiap nomor BIB beserta fotonya, baca cara mengekspor foto lomba lari berdasarkan nomor BIB. Pembacaan nomor BIB sendiri dibahas di halaman BibTrack.