Licensed

A drivers license parser for Swift

• Installation
• Usage
• AAMVA Standard Supported Fields
• AAMVA Element IDs
• Example Payload
• Attribution
• License

Installation

Licensed can be installed using the Swift Package Manager. Add the following to your Package.swift file:

dependencies: [
    .Package(url: "https://github.com/infinitetoken/Licensed.git", from: "2.0.0")
]

Usage

let barcodeString: String = "..."

let license = License.parse(string: barcodeString)

print(license.firstName)
// => Optional("John")
print(license.middleName)
// => Optional("Quincy")
print(license.lastName)
// => Optional("Public")

AAMVA Standard Supported Fields

Name	Description	Type	License 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	street1
Second Street Address	Customer Street Address Line 2	String	street2
City	Customer City	String	city
State	Customer State	String	state
Postal Code	Customer Zip 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	Supported
First Name	DAC	DCT	DCT	DAC	DAC	DAC	DAC	DAC	Y
Last Name	DAB	DCS	DCS	DCS	DCS	DCS	DCS	DCS	Y
Middle Name	DAD	DAD	DAD	DAD	DAD	DAD	DAD	DAD	Y
Expiration Date	DBA	DBA	DBA	DBA	DBA	DBA	DBA	DBA	Y
Issue Date	DBD	DBD	DBD	DBD	DBD	DBD	DBD	DBD	Y
Date of Birth	DBB	DBB	DBB	DBB	DBB	DBB	DBB	DBB	Y
Gender	DBC	DBC	DBC	DBC	DBC	DBC	DBC	DBC	Y
Eye Color	DAY	DAY	DAY	DAY	DAY	DAY	DAY	DAY	Y
Height (inches)	DAU	DAU	DAU	DAU	DAU	DAU	DAU	DAU	Y
Street Address	DAG	DAG	DAG	DAG	DAG	DAG	DAG	DAG	Y
City	DAI	DAI	DAI	DAI	DAI	DAI	DAI	DAI	Y
State	DAJ	DAJ	DAJ	DAJ	DAJ	DAJ	DAJ	DAJ	Y
Postal Code	DAK	DAK	DAK	DAK	DAK	DAK	DAK	DAK	Y
Customer ID	DBJ	DAQ	DAQ	DAQ	DAQ	DAQ	DAQ	DAQ	Y
Document ID	--	DCF	DCF	DCF	DCF	DCF	DCF	DCF	Y
Issuing Country	--	DCG	DCG	DCG	DCG	DCG	DCG	DCG	Y
Middle Name Truncation	--	DDG	--	DDG	DDG	DDG	DDG	DDG	Y
First Name Truncation	--	DDF	--	DDF	DDF	DDF	DDF	DDF	Y
Last Name Truncation	--	DDE	--	DDE	DDE	DDE	DDE	DDE	Y
Second Street Address	DAH	DAH	DAH	DAH	DAH	DAH	DAH	DAH	Y
Hair Color	DAZ	DAZ	DAZ	DAZ	DAZ	DAZ	DAZ	DAZ	Y
Place of Birth	--	--	DCI	DCI	DCI	DCI	DCI	DCI	Y
Audit Information	--	--	DCJ	DCJ	DCJ	DCJ	DCJ	DCJ	Y
Inventory Control	--	--	DCK	DCK	DCK	DCK	DCK	DCK	Y
Last Name Alias	DBO	DBN	DBN	DBN	DBN	DBN	DBN	DBN	Y
First Name Alias	DBP	DBG	DBG	DBG	DBG	DBG	DBG	DBG	Y
Suffix Alias	DBR	--	DBS	DBS	DBS	DBS	DBS	DBS	Y
Name Suffix	DBN	DCU	DCU	DCU	DCU	DCU	DCU	DCU	Y

Example Payload

Version 8 Example License Data

@

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

Attribution

This library was heavily influenced by the work from https://github.com/ksoftllc/license-parser.

License

Licensed is released under the MIT license. See LICENSE for details.