主要概念

Barcode Scannerのユースケースと実装について学ぶ前に、その基本的な概念を詳しく理解することが重要です。

バーコードへのデータエンコード

バーコードはデータとして文字列を保持し、バーコードとデータの両方がマッピングされることで、実世界のオブジェクトからコンピューティングデバイスへの高速な転送が可能になります。データとバーコードのマッピングはシンボロジーと呼ばれます。ユースケースに応じて、バーコードはデータを直接エンコードする場合もあれば、実際のデータを含むデータベースのエントリにリンクされたアイテム識別子をエンコードする場合もあります。

Zia Barcode Scannerがサポートするリニアおよび2Dの主要なバーコードにはそれぞれ異なる特徴があり、各バーコードタイプは異なる目的で使用されます。リニアおよび2Dバーコード形式の特性を以下に示します：

• リニアバーコード形式:
  
  リニアバーコード形式は、複数の平行線の幅と間隔を変化させてデータを表現する第一世代の一次元形式です。渡すことができる文字のタイプと数に制限があります。
  
  そのため、リニアバーコードはタイプに応じて限られた数の英数字をエンコードするために使用されます。UPC、EAN、Code-39、Code-128などのタイプは、小売、自動車、物流、輸送、ヘルスケアなどの業界で消費者製品や商品のラベル付けに広く使用されています。データ形式と使用法の仕様はタイプごとに異なります。

• 2Dバーコード形式:
  
  2Dバーコード形式は、長方形、六角形、ドット、その他の幾何学的パターンの形で視覚的に表現される高度なバーコード形式です。2Dバーコード形式は、1D形式と比較して単位面積あたりにはるかに多くのデータを保持できます。
  
  また、サポートされるデータタイプに対する制限が少なく、写真、指紋、署名、位置情報などの構造化データやバイナリデータを保持できます。2Dタイプには、スペース効率、耐障害性、エラー訂正、高密度などの利点もあります。2D形式でも、データ形式と使用法の仕様はタイプごとに異なります。

入力形式

Zia Barcode Scannerは画像ファイルからバーコードをスキャンします。Barcode Scannerは以下の入力ファイル形式をサポートしています：

• .jpg/.jpeg
• .png

エンドユーザーのデバイスのカメラを使用してバーコードが含まれる写真を撮影し、画像を入力ファイルとして処理するようにCatalystアプリケーションをコーディングできます。また、ユーザーがデバイスのメモリからCatalystアプリケーションに画像ファイルをアップロードするスペースを提供することもできます。

APIを使用して提供される入力には、バーコードのソース画像ファイルと、ユーザーが知っている場合はバーコードタイプが含まれます。ユーザーが指定しない場合、Ziaは自動的にバーコードタイプを検出します。

リクエスト形式はAPIドキュメントで確認できます。

より良い結果を得るために、入力を提供する際にユーザーは以下のガイドラインに従う必要があります：

• ぼやけた、破損した、または認識できないバーコード画像の提供は避けてください。
• バーコード画像が鮮明で、見やすく、はっきりしていることを確認してください。
• 画像に枠線がないことを確認してください。
• 部分的な画像はアップロードしないでください。バーコード全体が画像内に含まれている必要があります。
• 画像サイズが小さすぎないようにしてください。
• ファイルサイズは10 MBを超えないようにしてください。
• 画像の解像度（幅 × 高さのピクセル数）は36000000ピクセルを超えないようにしてください。
• 画像内のバーコードはどの向きでも構いません。

レスポンス形式

Zia Barcode Scannerは以下の方法でレスポンスを返します：

• コンソールの場合: コンソールでバーコードが含まれるサンプル画像をアップロードすると、デコードされたデータが2つのレスポンス形式で返されます：
  
  • 可読テキスト形式：コンテンツに基づいて視覚的に行ごとに分離されたデコード済みデータを表示します
  • JSON形式：JSON形式でデコード済みデータを表示します
• SDKを使用する場合: APIリクエストを使用して画像ファイルを送信すると、デコード済みデータを含むJSON responseを受け取ります。

JSON responseの形式はAPIドキュメントで確認できます。