drivers_license_parser

Description:

drivers license parser

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"
copied to clipboard
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
copied to clipboard
Installation #
install through pub
pub add drivers_license_parser
copied to clipboard
Contributing #
Guidelines

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


Fork the repository
Submit a pull request
Become a contributor once the pull request is accepted!

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