パスポートは、パーサーに1つの贈り物をくれます。機械読取領域(MRZ)です。身分事項ページの下部に並ぶ大文字、数字、< の埋め文字のブロックで、その項目からチェックディジットが計算されています。領域を読み、ディジットを再計算すれば、どの項目も信用する前に、読み取り結果のつじつまが合っているかがわかります。
運転免許証は、たいていそのどれもくれません。ほとんどの発行機関は免許証に機械読取領域をまったく印字しないので、再計算するものがありません。最初のパイプラインをパスポートで作った開発者は、これを痛い目にあって知ることがよくあります。「MRZを検証する」コードが領域のないカードに出会い、まったく問題のない免許証をエラーとして扱い始めるのです。
この記事はそのケースについてです。免許証が領域の代わりに何を載せているか、認識APIがそれについて何を教えてくれて何を教えてくれないか、そして頼れるチェックディジットがないときに項目を自分で確認する方法を扱います。引用の原文は英語で、日本語訳は私たちによるものです。
これはパスポート・身分証OCR API、doc.cheapのブログです。製品に触れる部分は、その前提で読んでください。
免許証が代わりに載せているもの
免許証の形式は1つではありません。発行機関ごとに独自のカードをデザインしており、存在する標準は、カードに何を載せ、どう配置すべきかを定めるもので、解析すべき1つの固定文字列を定めるものではありません。
北米:裏面のバーコード。 米国自動車管理者協会(AAMVA)は、加盟機関が発行するカード向けにAAMVA DL/ID Card Design Standardを公表しています。その2026年版には「必須のPDF417バーコード」と題された附属書があり、こう述べています。「PDF417二次元バーコードのシンボル体系は、準拠したDL/ID書類に必ず存在しなければならない最低限の必須機械読取技術である。」同じ附属書はさらに「必須データおよび任意データはすべて暗号化されていてはならない」と付け加えています。つまり準拠したカードは、所持者のデータを2回載せています。表面に印字され、そしてデコーダーさえあれば誰でも読める二次元バーコードにエンコードされて。
EU:標準のカードモデルを、表面から読む。 EUの免許証の交換と承認に関するYour Europeのページは、現行の免許証を「新しいEU標準形式(プラスチック製、クレジットカードサイズの写真付きカード)」と説明しています。レイアウトは共通ですが、そこから読むのは印字されたテキストです。古い紙の免許証もまだ流通しています。同じページには「旧式のEU免許証をお持ちの場合も、すべてのEU加盟国で引き続き使用できる」とあり、そうした免許証は「遅くとも2033年までに」交換しなければならないとされています。
国際的な層。 AAMVA自身のページは、国際的な免許証標準の作業はISOで行われていると記し、「国際標準(18013)は、自動車運転免許証(DL)の形式と内容に関する指針を定める」と述べています。この標準が扱う技術として、「一次元および二次元のバーコード」や「光学文字認識」が挙げられています。言い換えれば、この標準は発行機関に選択を任せており、チェックディジット付きの領域を手渡してくれるわけではありません。
パーサーにとっての実際の結果は次のとおりです。
| パスポート | 運転免許証 | |
|---|---|---|
| 機械読取領域 | 常に、身分事項ページに | たいていなし |
| 再計算できるチェックディジット | あり、領域に対して | 領域がなければなし |
| データの2つ目のコピー | 領域 | 発行機関が印字していればバーコード(たいてい裏面) |
| 有効期限 | 身分事項ページに印字 | 有効期限があれば印字。生涯有効のものもある |
| 読み取りの整合性を示すもの | 領域と印字ページの照合 | 印字された項目に対する自分自身のチェック |
「領域なし」を「無効」と見なしてはいけない理由
パイプラインをパスポートから始めたなら、おそらく領域で分岐しています。合格なら次へ、不合格なら写真の撮り直しを依頼する。免許証は3つ目の答えを加えます。そしてそれが一般的な答えです。
doc.cheapは領域を1つの判定 mrz.status として報告し、値は3つです。passed は、領域があり、すべてのチェックディジットが検証されたことを意味します。failed は、領域が読み取られたものの、その中の何かが合わなかったことを意味します。absent は書類に領域がないことを意味し、そのとき reason、lines、text はすべて null になります。運転免許証のガイドははっきりと書いています。「absent はエラーではなく、通常の結果として扱ってください。」
書類のそれ以外の部分は影響を受けません。免許証は他の書類と同じく印字された表面から認識され、meta.status は recognized で返ります。ですから必要な分岐は「領域が合格か、さもなくば拒否」ではなく、次のようになります。
failed– 領域の中の何かがつじつまが合わない。より良い写真を依頼する。passed– 領域の確認が通った。先へ進む。absent– 確認するものがなかった。下で説明する自分自身の項目チェックへ進む。
1回のAPI呼び出しで読み取る
免許証はパスポートと同じエンドポイントに、同じボディで送ります。写真をbase64でエンコードしてJSONに入れ、POST /v1/scans を1回送るだけです。公開サンドボックスキー sk_sandbox_public はアカウントなしで使えます。このキーにはテスト画像を使い、本物の免許証は決して使わないでください。公開キーで行ったスキャンはすべて、サービス自身の記録のために1年間保存されます。
curl -X POST https://api.doc.cheap/v1/scans \
-H "Authorization: Bearer sk_sandbox_public" \
-H "Content-Type: application/json" \
-d "{\"image\": \"$(base64 < licence-front.jpg | tr -d '\n')\"}"
免許証で重要になる応答の部分は次のようになります。値はすべて架空のもので、発行国は見本書類が使う架空の国 UTO です。
{
"meta": { "status": "recognized", "billed": true, "confidence": "high" },
"document": {
"country": "UTO",
"number": "DL0000000",
"issue_date": "2024-05-02",
"expiry_date": "2034-05-01",
"is_expired": false,
"days_remaining": 2725
},
"holder": {
"surname": "SPECIMEN",
"given_names": "ALEX JORDAN",
"birth_date": "1990-01-01"
},
"fields": [
{ "id": "dl_class@0", "name": "dl_class", "label": "Driving-licence class",
"category": "document", "value": "B, BE", "language": "English", "confidence": "high" },
{ "id": "authority@0", "name": "authority", "label": "Issuing authority",
"category": "document", "value": "UTOPIA LICENSING OFFICE", "language": "English", "confidence": "medium" }
],
"mrz": { "status": "absent", "reason": null, "lines": null, "text": null },
"authenticity": { "overall": "not_checked", "checks": [] }
}
ここから読み取るべきこと:
fieldsに、免許証に固有のデータが入っています。項目カタログは、免許証がふつう載せている項目を挙げています。surname、given_names、birth_date、document_number、dl_classまたはpermit_class、issue_date、expiry_date、address、authorityです。住所の各部分(address_street、address_city、address_state、address_postal_code)は、住所全体とは別にも出力されます。このセットは開かれているので、語彙に名前のない項目もカテゴリotherとして出力されます。- キーには
nameではなくidを使う。 2種類の文字で印字された免許証は、同じnameのもとに言語ごとに1つずつエントリを返します。一意なのはidだけです。 document.expiry_date、is_expired、days_remainingは、印字された有効期限から、スキャンした日を基準に計算されます。
バーコードが加えるもの、そしてAPIがそれをどう扱うか
デコードされたバーコードには、応答の中に専用のグループがありません。その値は他のすべてと並んで fields に入り、バーコードが切り出された場合は images.barcode にその切り抜き画像が入ります。
実務上の注意点が1つあります。エンドポイントは1回の呼び出しで1枚の画像を読み、バーコードを印字する発行機関は、たいていそれをカードの裏面に置きます。バーコードの内容が必要なら、裏面を別のスキャンとして送り、2つの結果を自分で統合してください。この統合は、チェックディジットの代わりとしても最善の手段です。同じカードを独立に2回読んだ結果なので、一致するはずです。
チェックディジットなしで免許証を検証する
領域がなければ、整合性の確認はあなたの仕事です。以下のチェックはどれも免許証が本物であることを証明はしません。誤読や明らかに誤った入力を、データベースに届く前に捕まえるためのものです。
- 日付の順序。
birth_dateはissue_dateより前、issue_dateはスキャンした日以前、expiry_dateはissue_dateより後。順序が崩れた読み取りは、誤読か質の悪い写真です。 - 有効期限は規則ではなく書類から。 有効期間は発行機関によって異なります。EUのページ自身の例は、キプロスの免許証が「イタリアのように10年ではなく、15年有効」というものです。日付はカードから読み、計算しないでください。
- 有効期限がない場合に備える。 同じEUのページは「生涯有効なEUの運転免許証」に触れています。有効期限が読み取れなかったとき、
expiry_date、is_expired、days_remainingはそろってnullになり、派生項目のdays_to_expireもnullになります。そのときフローがどうするかを決めておき、nullをうっかり期限切れとも有効とも扱わないでください。 - 存在だけでなく区分を見る。 乗用車の運転資格が必要なら、免許証があるかどうかを確かめるのではなく、
dl_classまたはpermit_classにその区分があるかを見てください。値はB, BEのような印字テキストなので、照合する前に分割し、自分の法域が定める区分で照合してください。 - 表面と裏面の照合。 カードにバーコードがある場合は両面をスキャンし、氏名、生年月日、書類番号を比べてください。不一致なら、写真をもう一度撮ってもらう価値があります。
- ユーザーが入力した内容との照合。
holder.surnameとholder.birth_dateを、ユーザーが記入したフォームの内容と、同じ方法で正規化したうえで比べてください。 - 信頼度をシグナルとして使う。 すべての読み取り値には
high、medium、lowのいずれかの帯が付きます。頼りにしている項目がlowなら、写真の撮り直しを依頼するのに十分な理由です。
領域がないときのスキャンの課金
本番キーでは、書類の種類が判定され、かつ次の3つのいずれかが成り立つとき、スキャンは1クレジットを消費します。領域が読み取られてチェックディジットが合格した、目視領域の項目が5つ以上読み取られた、またはバーコードがデコードされた。したがって免許証は2つ目か3つ目の条件で課金されます。項目が5つも取れず、バーコードもない質の悪い写真は無料です。定義の全体は課金ルールにあります。
OCRからはわからないこと
免許証を読み取ることと検証することは別の仕事です。doc.cheapはカードに印字された内容と、裏面ではバーコードを読み取ります。認識のみのシナリオでは authenticity.overall は not_checked なので、カードが本物かどうか、停止されていないかどうか、持っている人が本人かどうかはわかりません。フローにそのいずれかが必要なら、それらはそのために作られたツールと記録による別の段階です。
試してみる
公開サンドボックスキーにはアカウントが不要です。登録すると、自分のキーで毎月100回の無料認識が使え、表面、裏面、自分自身のチェックまで、フロー全体を作るには十分です。提供元を選んでいるなら、パスポートOCR APIの比較で公開されている料金を並べて確認できます。運転免許証のガイドには、curl、JavaScript、Pythonでの呼び出し方と、光沢のあるカードを撮影するコツが載っています。
**最後に質問です。**免許証に領域がないとき、あなたのフローで最も多くの誤った読み取りを捕まえるのはどのチェックですか – 日付、裏面のバーコード、それとも別の何かでしょうか。下のコメント欄で教えてください。