Paspor memberi parser sebuah hadiah: zona baca mesin (MRZ). Sebuah blok huruf kapital, angka, dan karakter pengisi < di bagian bawah halaman data, dengan digit pemeriksa yang dihitung dari kolom-kolomnya. Baca zonanya, hitung ulang digitnya, dan Anda tahu apakah hasil bacaan itu konsisten sebelum memercayai satu kolom pun.
Surat izin mengemudi (SIM) biasanya tidak memberi Anda semua itu. Sebagian besar penerbit sama sekali tidak mencetak zona baca mesin pada SIM, jadi tidak ada yang bisa dihitung ulang. Developer yang membangun pipeline pertamanya untuk paspor sering mengetahuinya dengan cara yang menyakitkan: jalur kode yang "memvalidasi MRZ" bertemu kartu tanpa zona dan mulai menganggap SIM yang sepenuhnya sah sebagai error.
Tulisan ini membahas kasus tersebut. Apa yang dibawa SIM sebagai ganti zona, apa yang bisa dan tidak bisa diberitahukan API pengenalan tentangnya, dan cara memeriksa kolom-kolomnya sendiri ketika tidak ada digit pemeriksa yang bisa diandalkan. Kutipan dari AAMVA dan Uni Eropa aslinya berbahasa Inggris; terjemahannya dari kami.
Ini blog doc.cheap, sebuah API OCR paspor dan kartu identitas. Baca bagian tentang produk dengan mengingat hal itu.
Apa yang dibawa SIM sebagai gantinya
Tidak ada satu format SIM. Setiap penerbit merancang kartunya sendiri, dan standar yang ada menetapkan apa yang sebaiknya dimuat kartu dan bagaimana tata letaknya, bukan satu string tetap untuk di-parse.
Amerika Utara: barcode di bagian belakang. American Association of Motor Vehicle Administrators menerbitkan AAMVA DL/ID Card Design Standard untuk kartu yang diterbitkan anggotanya. Edisi 2026-nya memuat lampiran berjudul "Barcode PDF417 Wajib", yang menyatakan: "Simbologi barcode dua dimensi PDF417 adalah teknologi baca mesin wajib minimum yang harus ada pada dokumen DL/ID yang sesuai standar." Lampiran yang sama menambahkan: "Semua data wajib dan opsional harus tidak terenkripsi." Jadi kartu yang sesuai standar membawa data pemegangnya dua kali – tercetak di bagian depan, dan dikodekan dalam barcode dua dimensi yang bisa dibaca siapa pun yang punya decoder.
Uni Eropa: model kartu standar, dibaca dari permukaannya. Halaman Your Europe tentang penukaran dan pengakuan SIM menggambarkan SIM saat ini sebagai "format standar UE yang baru (kartu foto plastik seukuran kartu kredit)". Tata letaknya sama, tetapi yang Anda baca darinya adalah teks tercetak. SIM kertas yang lebih lama juga masih beredar: halaman yang sama menyebut "Jika Anda memiliki SIM UE model lama, Anda tetap dapat menggunakannya di semua negara UE", dan bahwa SIM seperti itu harus ditukar "paling lambat pada 2033".
Lapisan internasional. Halaman AAMVA sendiri mencatat bahwa pekerjaan menuju standar SIM internasional berlangsung di ISO, dan bahwa "Standar internasional (18013) menetapkan pedoman format dan isi surat izin mengemudi kendaraan bermotor (DL)". Halaman itu mendaftar teknologi yang dicakup standar tersebut, di antaranya "Barcode, satu dan dua dimensi" dan "Pengenalan karakter optik". Dengan kata lain, standar itu membiarkan penerbit memilih; ia tidak memberi Anda zona dengan digit pemeriksa.
Hasil praktisnya bagi parser:
| Paspor | SIM | |
|---|---|---|
| Zona baca mesin | Selalu ada, di halaman data | Biasanya tidak ada |
| Digit pemeriksa yang bisa dihitung ulang | Ya, dari zona | Tidak ada, bila tidak ada zona |
| Salinan kedua dari data | Zona | Barcode, bila penerbit mencetaknya (biasanya di belakang) |
| Tanggal berlaku | Tercetak di halaman data | Tercetak bila SIM memilikinya; sebagian berlaku seumur hidup |
| Yang memberi tahu bacaan konsisten | Zona dibandingkan halaman cetak | Pemeriksaan Anda sendiri atas kolom tercetak |
Mengapa "tanpa zona" tidak boleh berarti "tidak sah"
Jika pipeline Anda dimulai dari paspor, kemungkinan besar ia bercabang berdasarkan zona: lolos, lanjut; gagal, minta foto baru. SIM menambahkan jawaban ketiga, dan justru itulah yang paling umum.
doc.cheap melaporkan zona sebagai satu putusan, mrz.status, dengan tiga nilai. passed berarti zona ada dan setiap digit pemeriksa tervalidasi. failed berarti zona terbaca dan ada sesuatu di dalamnya yang tidak cocok. absent berarti dokumen tidak memilikinya – dan dalam hal itu reason, lines, dan text semuanya null. Panduan SIM menyatakannya dengan jelas: "Anggap absent sebagai hasil biasa, bukan error."
Bagian lain dokumen tidak terpengaruh. SIM dikenali dari permukaan cetaknya seperti dokumen lain, dan meta.status kembali sebagai recognized. Jadi percabangan yang Anda perlukan bukan "zona lolos atau tolak", melainkan:
failed– ada yang tidak cocok di dalam zona; minta foto yang lebih baik.passed– zona lolos pemeriksaan; lanjutkan.absent– tidak ada yang bisa diperiksa; lanjutkan ke pemeriksaan kolom Anda sendiri di bawah.
Membaca SIM dengan satu panggilan API
SIM dikirim ke endpoint yang sama dengan paspor, dengan body yang sama: satu POST /v1/scans dengan foto yang di-encode base64 di dalam JSON. Kunci sandbox publik sk_sandbox_public berfungsi tanpa akun. Gunakan gambar uji dengannya, jangan pernah SIM asli: setiap pemindaian dengan kunci publik disimpan selama satu tahun untuk log layanan itu sendiri.
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')\"}"
Bagian jawaban yang penting untuk SIM terlihat seperti ini. Semua nilainya rekaan, dan negara penerbitnya UTO, negara fiktif yang dipakai dokumen contoh:
{
"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": [] }
}
Yang perlu dibaca darinya:
fieldsadalah tempat data khusus SIM berada. Katalog kolom mendaftar apa yang biasanya dimuat SIM:surname,given_names,birth_date,document_number,dl_classataupermit_class,issue_date,expiry_date,address, danauthority. Bagian alamat (address_street,address_city,address_state,address_postal_code) diterbitkan terpisah sekaligus utuh. Himpunannya terbuka, jadi kolom yang tidak disebut kosakata tetap diterbitkan, dengan kategoriother.- Gunakan
idsebagai kunci, bukanname. SIM yang dicetak dalam dua aksara mengembalikan satu entri per bahasa di bawahnameyang sama; hanyaidyang unik. document.expiry_date,is_expired, dandays_remainingdihitung dari tanggal berlaku yang tercetak, terhitung sejak hari pemindaian.
Apa yang ditambahkan barcode, dan apa yang dilakukan API dengannya
Barcode yang terdekode tidak mendapat grup sendiri di respons. Nilai-nilainya masuk ke fields bersama semua yang lain, dan images.barcode membawa potongan gambarnya bila berhasil dipotong.
Ada satu jebakan praktis. Endpoint membaca satu gambar per panggilan, dan penerbit yang mencetak barcode biasanya menaruhnya di bagian belakang kartu. Bila Anda memerlukan isi barcode, kirim sisi belakang sebagai pemindaian tersendiri dan gabungkan kedua hasilnya sendiri. Penggabungan itu juga pengganti terbaik Anda untuk digit pemeriksa: dua bacaan independen atas kartu yang sama, yang seharusnya cocok.
Memvalidasi SIM tanpa digit pemeriksa
Tanpa zona, konsistensi menjadi tugas Anda. Tidak satu pun pemeriksaan ini membuktikan SIM itu asli; semuanya menangkap salah baca dan input yang jelas keliru sebelum masuk ke database Anda.
- Tanggal berurutan.
birth_datesebelumissue_date,issue_datepada atau sebelum hari pemindaian,expiry_datesetelahissue_date. Bacaan yang melanggar urutan ini adalah salah baca atau foto yang buruk. - Tanggal berlaku dari dokumen, bukan dari aturan. Masa berlaku berbeda menurut penerbit – contoh dari halaman UE itu sendiri adalah SIM dari Siprus yang "berlaku 15 tahun, bukan 10 tahun seperti di Italia". Baca tanggalnya dari kartu; jangan menghitungnya.
- Siapkan rencana untuk SIM tanpa tanggal berlaku. Halaman UE yang sama menyebut "SIM UE yang berlaku seumur hidup". Bila tidak ada tanggal berlaku yang terbaca,
expiry_date,is_expired, dandays_remainingbersama-sama bernilainull, dan kolom turunandays_to_expirejuganull. Tentukan apa yang dilakukan alur Anda saat itu; jangan sampainulldiperlakukan sebagai kedaluwarsa atau sah secara tidak sengaja. - Golongan, bukan sekadar keberadaan. Jika Anda memerlukan orang yang berhak mengemudikan mobil, cari golongan itu di
dl_classataupermit_class, bukan sekadar memeriksa bahwa SIM ada. Nilainya berupa teks tercetak sepertiB, BE, jadi pecah dulu sebelum dicocokkan, dan cocokkan dengan golongan yang ditetapkan yurisdiksi Anda sendiri. - Depan dibandingkan belakang. Bila kartu memiliki barcode, pindai kedua sisi dan bandingkan nama, tanggal lahir, dan nomor dokumen. Bila ada yang tidak cocok, sebaiknya minta foto kedua.
- Dibandingkan isian pengguna. Bandingkan
holder.surnamedanholder.birth_datedengan formulir yang diisi pengguna Anda, dinormalisasi dengan cara yang sama. - Tingkat keyakinan sebagai sinyal. Setiap bacaan membawa tingkat –
high,medium, ataulow. Tingkatlowpada kolom yang Anda andalkan adalah alasan kuat untuk meminta foto baru.
Berapa biaya pemindaian bila tidak ada zona
Dengan kunci live, satu pemindaian memakai satu kredit bila jenis dokumen berhasil ditentukan dan salah satu dari tiga hal ini terpenuhi: zona terbaca dan digit pemeriksanya lolos, lima kolom atau lebih dari zona visual terbaca, atau barcode berhasil didekode. Karena itu SIM ditagih karena syarat kedua atau ketiga. Foto yang terlalu buruk untuk menghasilkan lima kolom dan tanpa barcode tidak dikenai biaya. Aturan penagihan memuat definisi lengkapnya.
Yang tidak diberitahukan OCR kepada Anda
Membaca SIM dan memverifikasinya adalah dua pekerjaan berbeda. doc.cheap membaca apa yang tercetak di kartu, dan di bagian belakang, barcodenya. Dalam skenario khusus pengenalan, authenticity.overall bernilai not_checked, jadi ia tidak memberi tahu apakah kartu itu asli, apakah sedang dibekukan, atau apakah orang yang memegangnya adalah pemiliknya. Jika alur Anda memerlukan salah satunya, itu adalah langkah terpisah dengan alat dan catatan yang dibuat khusus untuk itu.
Coba sendiri
Kunci sandbox publik tidak memerlukan akun. Dengan mendaftar, Anda mendapat 100 pengenalan gratis setiap bulan di kunci Anda sendiri, cukup untuk membangun seluruh alur – depan, belakang, dan pemeriksaan Anda sendiri. Jika Anda sedang memilih penyedia, perbandingan API OCR paspor menyandingkan harga yang dipublikasikan, dan panduan SIM memuat panggilannya dalam curl, JavaScript, dan Python beserta tips memotret kartu yang mengilap.
Satu pertanyaan untuk Anda: bila SIM tidak punya zona, pemeriksaan mana yang paling banyak menangkap bacaan buruk di alur Anda – tanggal, barcode di belakang, atau hal lain? Ceritakan di kolom komentar di bawah.