drivers_license_parser 1.1.0

This package provides a simple and effective utility for parsing barcodes displayed on the back of drivers license cards issued in the United States and Canada.

LicenseParser

Note: This is a Dart port of https://github.com/ksoftllc/license-parser

Easily parse the information within PDF-417 barcodes found on the back of US and Canadian driver's licenses adhering to the AAMVA Version 8. This library also supports all older standards as well. standard.

Usage

// First get the PDF-417 barcode data by scanning the barcode on the license
// this step can be done any way you like and is not provided by this library
final pdf417Data = myLicenseScannerUtility.scan();

// Parse the data with the LicenseParser
final parsedLicense = LicenseParser.parse(pdf417Data);

// use the parsedLicense as you wish
print(parsedLicense.firstName);
// => "John"
print(parsedLicense.middleName);
// => "Quincy"
print(parsedLicense.lastName);
// => "Public"

AAMVA Standard

Supported Fields

Name	Description	Type	ParsedLicense Attribute
First Name	Customer First Name	String	firstName
Last Name	Customer Last Name	String	lastName
Middle Name	Customer Middle Name	String	middleName
Expiration Date	Document Expiration Date	NSDate	expirationDate
Issue Date	Document Issue Date	NSDate	issueDate
Date of Birth	Customer Date of Birth	NSDate	dateOfBirth
Gender	Customer Gender	Enum	gender
Eye Color	Customer Eye Color	Enum	eyeColor
Hair Color	Customer Hair Color	Enum	hairColor
Height	Customer Height (in inches)	Double	height
Street Address	Customer Street Address	String	streetAddress
Second Street Address	Customer Street Address Line 2	String	streetAddressSupplement
City	Customer City	String	city
State	Customer State	String	state
Postal Code	Customer Postal Code	String	postalCode
Customer ID	Unique Customer ID Number	String	customerId
Document ID	Unique Document ID Number	String	documentId
Issuing Country	Issuing Country	Enum	issuingCountry
Middle Name Truncation	Was Middle Name truncated?	Enum	middleNameTruncation
First Name Truncation	Was First Name truncated?	Enum	firstNameTruncation
Last Name Truncation	Was Last Name truncated?	Enum	lastNameTruncation
Place of Birth	Country and municipality and/or state/province	String	placeOfBirth
Audit Information	A string of letters and/or numbers that identifies when, where, and by whom a driver license/ID card was made.	String	auditInformation
Inventory Control	A string of letters and/or numbers that is affixed to the raw materials (card stock, laminate, etc.) used in producing driver licenses and ID cards.	String	inventoryControlNumber
Last Name Alias	Other Last Name by which cardholder is known.	String	lastNameAlias
First Name Alias	Other First Name by which the cardholder is known.	String	firstNameAlias
Suffix Alias	Other suffix by which cardholder is known	String	suffixAlias
Name Suffix	Name Suffix	Enum	suffix

AAMVA Element IDs

Below is a table of AAMVA Element Ids and the fields to which they map by AAMVA Version.

bold = Mandatory Field

-- = not included in this version of the standard

Field	Version 1	Version 2	Version 3	Version 4	Version 5	Version 6	Version 7	Version 8	Version 9	Version 10	Supported
First Name	DAC	DCT	DCT	DAC	DAC	DAC	DAC	DAC		DAC	Y
Last Name	DAB	DCS	DCS	DCS	DCS	DCS	DCS	DCS		DCS	Y
Middle Name	DAD	DAD	DAD	DAD	DAD	DAD	DAD	DAD		DAD	Y
Expiration Date	DBA	DBA	DBA	DBA	DBA	DBA	DBA	DBA		DBA	Y
Issue Date	DBD	DBD	DBD	DBD	DBD	DBD	DBD	DBD		DBD	Y
Date of Birth	DBB	DBB	DBB	DBB	DBB	DBB	DBB	DBB		DBB	Y
Gender	DBC	DBC	DBC	DBC	DBC	DBC	DBC	DBC		DBC	Y
Eye Color	DAY	DAY	DAY	DAY	DAY	DAY	DAY	DAY		DAY	Y
Height (inches)	DAU	DAU	DAU	DAU	DAU	DAU	DAU	DAU		DAU	Y
Street Address	DAG	DAG	DAG	DAG	DAG	DAG	DAG	DAG		DAG	Y
City	DAI	DAI	DAI	DAI	DAI	DAI	DAI	DAI		DAI	Y
State	DAJ	DAJ	DAJ	DAJ	DAJ	DAJ	DAJ	DAJ		DAJ	Y
Postal Code	DAK	DAK	DAK	DAK	DAK	DAK	DAK	DAK		DAK	Y
Customer ID	DBJ	DAQ	DAQ	DAQ	DAQ	DAQ	DAQ	DAQ		DAQ	Y
Document ID	--	DCF	DCF	DCF	DCF	DCF	DCF	DCF		DCF	Y
Issuing Country	--	DCG	DCG	DCG	DCG	DCG	DCG	DCG		DCG	Y
Middle Name Truncation	--	DDG	--	DDG	DDG	DDG	DDG	DDG		DDG	Y
First Name Truncation	--	DDF	--	DDF	DDF	DDF	DDF	DDF		DDF	Y
Last Name Truncation	--	DDE	--	DDE	DDE	DDE	DDE	DDE		DDE	Y
Second Street Address	DAH	DAH	DAH	DAH	DAH	DAH	DAH	DAH		DAH	Y
Hair Color	DAZ	DAZ	DAZ	DAZ	DAZ	DAZ	DAZ	DAZ		DAZ	Y
Place of Birth	--	--	DCI	DCI	DCI	DCI	DCI	DCI		DCI	Y
Audit Information	--	--	DCJ	DCJ	DCJ	DCJ	DCJ	DCJ		DCJ	Y
Inventory Control	--	--	DCK	DCK	DCK	DCK	DCK	DCK		DCK	Y
Last Name Alias	DBO	DBN	DBN	DBN	DBN	DBN	DBN	DBN		DBN	Y
First Name Alias	DBP	DBG	DBG	DBG	DBG	DBG	DBG	DBG		DBG	Y
Suffix Alias	DBR	--	DBS	DBS	DBS	DBS	DBS	DBS		DBS	Y
Name Suffix	DBN	DCU	DCU	DCU	DCU	DCU	DCU	DCU		DCU	Y

Example of a raw driver's license payload

Version 8 Example License Data

@

ANSI 636026080102DL00410288ZA03290015DLDAQD12345678
DCSPUBLIC
DDEN
DACJOHN
DDFN
DADQUINCY
DDGN
DCAD
DCBNONE
DCDNONE
DBD08242015
DBB01311970
DBA01312035
DBC1
DAU069 in
DAYGRN
DAG789 E OAK ST
DAIANYTOWN
DAJCA
DAK902230000  
DCF83D9BN217QO983B1
DCGUSA
DAW180
DAZBRO
DCK12345678900000000000
DDB02142014
DDK1
ZAZAAN
ZAB
ZAC

Installation

install through pub

pub add drivers_license_parser

Contributing

Guidelines

• Write tests
• Leave the code better than when you found it
• Add or improve documentation
• Small and frequent commits

1. Fork the repository
2. Submit a pull request
3. Become a contributor once the pull request is accepted!

License

DriversLicenseParser is available under the MIT license. See the LICENSE file for more info.