Cách xuất dữ liệu ảnh sự kiện của bạn dưới dạng JSON
Thẻ của sự kiện còn hữu ích ngoài thư viện ảnh: cho đối tác kết quả, cho hồ sơ của riêng bạn, hoặc để đối chiếu ảnh với thư mục của nhiếp ảnh gia. Photos to Data Export đưa mọi ảnh đã xử lý vào một tệp JSON, kèm số BIB và các trường khác mà bạn chọn.
Tóm tắt: mở sự kiện, vào Photo, rồi Tools, và chọn Photos to Data Export. Đánh dấu các trường trong Fields to include, chọn Export, rồi tải tệp JSON xuống khi hiện Ready. Mỗi ảnh đã xử lý có một mục, kể cả ảnh không có số BIB.
Tệp xuất cho bạn những gì
Photos to Data Export trả lời một câu hỏi cho mỗi ảnh trong sự kiện: ảnh này có những thông tin gì? Tệp có một mục cho mỗi ảnh đã xử lý, dùng ID ảnh làm khóa, kèm các trường bạn đã chọn.
Đây là cách xuất phù hợp khi bạn bắt đầu từ ảnh:
- Đối chiếu thẻ với ảnh gốc. Tên tệp và đường dẫn cho biết mỗi mục ứng với tệp nào trong thư mục của nhiếp ảnh gia.
- Tìm những ảnh không ai tìm thấy. Ảnh không có số BIB vẫn nằm trong tệp với danh sách rỗng, sẵn sàng để xem lại.
- Lưu hồ sơ của riêng bạn. Bản sao thẻ của sự kiện tại một ngày cụ thể, để lưu trữ hoặc dùng cho hệ thống khác.
Nếu bạn bắt đầu từ vận động viên và cần từng số BIB kèm ảnh, hãy dùng Bib to Data Export.
Bước 1: Mở công cụ
Trong bảng điều khiển, mở sự kiện, vào Photo và chọn tab Tools. Chọn Photos to Data Export. Công cụ này trước đây tên là Photos to Bib Export, và các đường liên kết cũ vẫn mở được.
Trang có hai cột. Bên trái là các trường và nút Export. Bên phải là Latest export và bản xem trước tệp. Trước lần xuất đầu tiên, bên phải hiển thị Example file để bạn thấy cấu trúc tệp.
Bước 2: Chọn trường dữ liệu
Bibs và Manual tags được đánh dấu sẵn. Thêm các trường khác nếu cần. Bạn phải chọn ít nhất một trường.
| Trường | Nội dung |
|---|---|
| Bibs | Các số BIB giúp người tham gia tìm thấy ảnh: số BIB được nhận diện cộng thẻ thủ công của bạn, trừ những số bạn đã xóa. |
| Manual tags | Số BIB bạn đã thêm thủ công trong Manual Tagging. |
| Original file name | Tên của ảnh khi được nhập vào. |
| File path | Vị trí của ảnh trong nguồn, gồm cả tên ảnh. Với ảnh tải lên 9Pic, đó là thư mục bên trong lượt tải lên. Với Google Drive, Dropbox, OneDrive, Box hoặc SharePoint, đó là đường dẫn bên trong thư mục được chia sẻ. Để trống với ảnh từ đường liên kết tùy chỉnh. |
| Detected bibs | Số BIB tìm thấy trên ảnh, trước khi bạn xóa bất kỳ số nào. |
| Removed bibs | Số BIB được nhận diện mà bạn đã xóa trong Manual Tagging. |
| Detected text | Toàn bộ chữ đọc được trên ảnh, như tên nhà tài trợ và biển hiệu. |
Mỗi trường thêm vào làm tệp lớn hơn. Detected text làm tệp tăng nhiều nhất, vì vậy hãy bỏ chọn nếu bạn không dùng đến.
Các ô đánh dấu mặc định theo các trường của lần xuất gần nhất. Nếu bạn thay đổi, một ghi chú sẽ nhắc bạn xuất lại để tệp khớp với lựa chọn.
Bước 3: Xuất và tải xuống
Chọn Export. Quá trình xuất chạy ở chế độ nền và hiển thị số ảnh đã đọc. Bạn có thể rời trang rồi quay lại. Một sự kiện lớn mất khoảng một phút.
Khi hiện Ready, ô Latest export cho biết thời điểm xuất, dung lượng tệp và ba con số: Photos, Bibs và Photos without bibs. Ô này cũng liệt kê các trường trong tệp. Chọn Download JSON để lưu tệp.
Mỗi sự kiện giữ lần xuất gần nhất của từng loại, vì vậy lần xuất mới sẽ thay thế lần xuất đang hiển thị trên trang.
Bước 4: Đọc tệp
Mọi tệp đều bắt đầu bằng cùng các thông tin: event_id, export_type, generated_at, options (các trường được đưa vào) và counts. Ảnh nằm trong data. Dưới đây là một tệp có tên tệp, đường dẫn tệp, số BIB và thẻ thủ công:
{
"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": []
}
}
}
Một vài điểm cần biết khi đọc tệp:
- Khóa của mỗi mục là ID ảnh trong 9Pic AI, không phải tên tệp. Đánh dấu Original file name khi bạn cần tên tệp.
- Ảnh không có số BIB vẫn được liệt kê, với danh sách rỗng. Đó là cách
photos_without_bibsđược đếm. - Ảnh từ đường liên kết tùy chỉnh có đường dẫn tệp là
nullvì ảnh không nằm trong thư mục nào.
Kiểm tra trước khi tải xuống
Bên dưới lần xuất gần nhất, File preview hiển thị phần đầu của tệp theo cùng bố cục. Chọn một khóa hoặc mũi tên của khóa để mở hoặc thu gọn, hoặc dùng Expand all và Collapse all. Raw hiển thị văn bản thuần với số dòng, còn Copy sao chép bản xem trước.
Bản xem trước chứa 20 ảnh đầu tiên, và danh sách dài được rút gọn bằng một dòng như "… 5 more items in the download". Các mục đã thu gọn cho biết số khóa hoặc phần tử chúng chứa trong tệp đầy đủ, nên các con số vẫn chính xác dù bản xem trước ngắn.
Ba cách dùng thực tế
Đối chiếu thẻ với ảnh gốc của nhiếp ảnh gia
Đánh dấu Original file name và File path. Mỗi mục giờ cho biết ảnh đến từ tệp nào trong thư mục nào, để nhiếp ảnh gia hoặc biên tập viên tìm ảnh gốc của một số BIB mà không cần tìm trong thư viện ảnh.
Tìm ảnh không có số BIB
Tìm các mục có danh sách bibs rỗng. Nhiều ảnh trong số đó là ảnh khán giả, phong cảnh hoặc vạch xuất phát. Số khác có thể là vận động viên bị che mất số BIB. Những ảnh này đáng được xem lại trong Manual Tagging; xem cách gắn thẻ số BIB thủ công sau AI.
Kiểm tra những gì đã được sửa
Đánh dấu Detected bibs và Removed bibs để xem tính năng đọc số BIB đã tìm thấy gì và đội của bạn đã bỏ đi gì. Đây là cách nhanh để rà soát một lượt gắn thẻ, hoặc giải thích vì sao một vận động viên không còn tìm thấy một ảnh.
Thế nào được tính là số BIB
Chỉ ảnh đã xử lý mới có trong tệp. Trường Bibs tuân theo cùng quy tắc với tính năng tìm ảnh của người tham gia:
- Số BIB tìm thấy theo cài đặt nhận diện số BIB của sự kiện. Khi sự kiện dùng danh sách số BIB, chỉ những số có trong danh sách mới được tính.
- Trừ các số BIB được nhận diện mà bạn đã xóa.
- Cộng thẻ thủ công của bạn, kể cả trước khi chúng được công bố cho tính năng tìm ảnh của người tham gia.
Vì vậy tệp khớp với những gì người tham gia tìm thấy, và thẻ thủ công mới nhất của bạn được đưa vào sớm.
FAQ
Tệp có tự cập nhật khi tôi thay đổi thẻ không?
Không. Tệp thể hiện các thẻ tại thời điểm xuất. Sau khi gắn thẻ, chọn Export again.
Gói nào có tính năng này?
Mọi gói. Tính năng này vẫn hoạt động sau khi gói kết thúc, nên bạn vẫn mang dữ liệu của mình theo được.
Xuất tệp thất bại. Tôi nên làm gì?
Chọn Export again. Nếu tải xuống thất bại, hãy thử lại một lần nữa: mỗi lần nhấn sẽ tạo một đường liên kết tải xuống mới.
Tôi có thể mở tệp trong bảng tính không?
JSON được tạo ra cho phần mềm, nên cách đơn giản nhất là chuyển tệp cho người phụ trách hệ thống kết quả hoặc đăng ký của bạn. Hầu hết công cụ dữ liệu và tiện ích bổ sung cho bảng tính cũng nhập được JSON.
Bước tiếp theo
Chạy lần xuất đầu tiên với các trường mặc định và mở File preview để xem cấu trúc dữ liệu của sự kiện. Sau đó thêm tên tệp và đường dẫn nếu bạn cần đối chiếu với ảnh gốc. Để có danh sách từng số BIB kèm ảnh, hãy đọc cách xuất ảnh giải chạy theo số BIB. Việc đọc số BIB được giới thiệu trên trang BibTrack.