アメリカ合衆国のパスポートに対応したOCR API

アメリカ合衆国のパスポートを認識する

アメリカ合衆国のパスポートはICAO 9303規格に準拠しています。データページの下部、人が読む視覚検査ゾーンの下に、44文字×2行の機械読み取りゾーン（フォーマットTD3）が印字されています。最初の5文字はP<USAで、書類コードに続いて、発行国がISO 3166-1 alpha-3コードUSAで示されます。APIは両方のゾーンを読み取り、MRZのチェックディジットを照合し、すべてのキーを含む1つの形式のレスポンスを返します。

アメリカ合衆国は、alpha-2のリストではUS、ゾーンではUSAです。この場合、長いコードは短いコードの後ろにAを付けたものです。ただしこれはこの組み合わせに限った話で、規則ではありません。一方からもう一方を導き出すと、当てはまらない最初の国でバグになります。

アメリカ合衆国が発行する機械読み取りゾーン

9303はゾーンのレイアウトを3種類定めており、APIはそのすべてを読み取れます。以下では、架空の所持人（実在しない人物で、paradeigmaはギリシャ語で例という意味です）を各レイアウトで示し、発行国はUSAとしています。チェックディジットはすべて、手で入力したものではなく隣の文字から計算したものなので、このページのゾーンはどれも検証を通ります。

P<USAPARADEIGMA<<ELENI<SOFIA<<<<<<<<<<<<<<<<
AM73045184USA9403084F3203101PN48291630<<<<72

I<USAPARADEIGMA<<ELENI<SOFIA<<<<<<<<
TR61850420GRC9403084F2911043<<<<<<<2

IDUSAAK472913<4PN48291630<<<<<
9403084F3405204GRC<<<<<<<<<<<9
PARADEIGMA<<ELENI<SOFIA<<<<<<<

発行国を保護するチェックディジットはありません。3つのレイアウトのいずれでも、計算の対象は書類番号、日付、任意データで、誰が書類を発行したかを示す3文字は対象外です。すべての桁が正しいゾーンであっても、アメリカ合衆国が発行したことの証明にはなりません。それを証明するのは、視覚ゾーンと書類自体のセキュリティ機能です。

MRZパーサーにMRZを貼り付けてチェックディジットを検証するか、MRZジェネレーターでMRZを作成できます。

返ってくるフィールド

認識されたアメリカ合衆国のパスポートは、どれも同じ構造化フィールドを返します。読み取れなかった値はnullになり、キーが省略されることはありません。

• 姓と名
• 生年月日と性別
• 書類番号と個人番号
• 国籍と発行国（USA）
• 発行日と有効期限、残り日数
• MRZの判定と、読み取り元の行

すべてのフィールドは書類フィールド一覧（英語）で確認できます。

呼び出してみる

公開サンドボックスに対して実行してください。登録不要で、本物の認識が、限られた件数の書類まで無料で、IPごとに1時間あたり10リクエストまで利用できます。アメリカ合衆国のパスポートの認識を続けるには、サンドボックスキーをご自身の本番用キーに置き換えてください。

curl -X POST https://api.doc.cheap/v1/scans \
  -H "Authorization: Bearer sk_sandbox_public" \
  -H "Content-Type: application/json" \
  -d "{\"image\": \"$(base64 < document.jpg | tr -d '\n')\"}"

ドキュメントの参照先

このページではアメリカ合衆国に固有の内容を扱っています。それ以外のことはすべて、以下の4つのページ（英語）にまとめています。

• パスポートを認識する

  上の呼び出しを実際の書類で、curl、JavaScript、Pythonで実行する方法と、レスポンスの各キーの説明。

• MRZと視覚ゾーン

  書類が同じデータを2回印字する理由、両者が食い違うときにどちらを信じるか、チェックディジットで証明できることとできないこと。

• フィールドの言語と文字体系

  MRZはラテン文字への翻字であり、視覚ゾーンはそうではありません。どの読み取り結果が元の文字体系を保持するか、言語識別子がどの言語に対応するか。

• エラー

  APIが返しうるすべてのエラーコードを1つの表に。原因、再試行で解決しうるか、その呼び出しが課金されたかどうか。