Pythonでバーコード・QRコードを瞬時に読み取る！ZBar入門

この記事では、PythonライブラリのZBarを使って、画像ファイルからバーコードやQRコードを検出・読み取る方法を解説します。在庫管理、チケット認証、情報連携など、様々なシーンで活躍するバーコード・QRコードの読み取り機能をPythonで手軽に実装できます。

バーコード・QRコードとは？

バーコードは、白と黒の線の幅や間隔によって情報を表現する二次元コードの一種です。主に商品の識別や在庫管理に使われます。一方、QRコード（Quick Response Code）は、四角い格子状のパターンで情報を表現する二次元コードで、より多くの情報を格納でき、URLや連絡先などの情報を手軽に共有するのに広く利用されています。

なぜバーコード・QRコードを読み取るのか？

• データ入力の効率化: 手動入力の手間を省き、入力ミスを減らします。

• 情報連携の自動化: 商品情報、ウェブサイトへの誘導、イベント参加登録などをスムーズに行えます。

• 在庫管理の効率化: 商品の入出荷や棚卸しを迅速かつ正確に行えます。

ZBarとは？

ZBarは、様々なバーコード・QRコードフォーマットを読み取ることができるオープンソースのライブラリです。Pythonから利用するには、pyzbarというPythonバインディングを使用します。ZBarは、画像から複数のバーコードを同時に検出・デコードできる強力な機能を持っています。

pyzbarのインストール方法

pyzbarを利用するには、まずZBar本体をシステムにインストールする必要があります（OSによって手順が異なります）。その後、pipを使ってpyzbarをインストールします。

pip install pyzbar Pillow

※Pillowは画像処理に必要なライブラリです。

pyzbarを使ったバーコード・QRコード読み取りの基本

pyzbarを使って画像ファイルからバーコードやQRコードを読み取る基本的な手順を説明します。

画像ファイルからコードを読み取る

pyzbar.decode()関数にPIL (Pillow) で開いた画像オブジェクトを渡すだけで、画像内のコードを検出・デコードできます。

from PIL import Image
from pyzbar.pyzbar import decode

# 読み込みたい画像ファイルのパス
image_path = "qrcode_example.png" # または "barcode_example.png"

# 画像を開く
img = Image.open(image_path)

# バーコード・QRコードをデコード
decoded_objects = decode(img)

# 検出されたコードの情報を表示
if decoded_objects:
    for obj in decoded_objects:
        print(f"データ: {obj.data.decode('utf-8')}")
        print(f"タイプ: {obj.type}")
        print(f"領域: {obj.rect}")
        print("-" * 20)
else:
    print("コードは検出されませんでした。")

上記のコードは、qrcode_example.png（またはbarcode_example.png）という画像ファイルからバーコードやQRコードを読み取り、そのデータ、タイプ、検出された領域を出力する例です。obj.dataはバイト列で返されるため、.decode('utf-8')で文字列に変換しています。

読み取り結果の活用

decode()関数は、検出された各コードについてDecodedオブジェクトのリストを返します。このオブジェクトには、コードのデータだけでなく、タイプ（例: ‘QRCODE’, ‘CODE128’など）や画像内での位置情報が含まれています。

特定のタイプのコードをフィルタリングする

複数のコードが画像内に存在する場合や、特定のタイプのコードのみを扱いたい場合に便利です。

from PIL import Image
from pyzbar.pyzbar import decode, ZBarSymbol

image_path = "multiple_codes.png" 
img = Image.open(image_path)
decoded_objects = decode(img, symbols=[ZBarSymbol.QRCODE]) # QRコードのみを対象

if decoded_objects:
    for obj in decoded_objects:
        print(f"QRコードデータ: {obj.data.decode('utf-8')}")
        print("-" * 20)
else:
    print("QRコードは検出されませんでした。")

symbols引数にZBarSymbolから指定することで、読み取るコードのタイプを限定できます。

まとめ

ZBarとpyzbarを組み合わせることで、Pythonで画像ファイルからバーコードやQRコードを簡単に検出・読み取ることができます。これにより、データ入力の自動化や情報連携の効率化など、様々なアプリケーションの可能性が広がります。ぜひこの強力なライブラリを活用して、新しいシステム開発に挑戦してみてください！