apn-formats
Getting Started
This package is meant to validate or lookup Assessor’s Parcel Number (APN) formats for any given state/county in the United States. This package is based off this python package
Getting Started
npm install apn-formats
Usage
var apn-formats = require('apn-formats');
/*
lookup() returns a list of all valid APN formats for a given county.
If only a state is given, an object of all counties and their APNs are returned.
If no arguments are provided, an object of all APN formats is returned.
Case and spaces are ignored in state and county names.
State names can be full names or abbreviations ('Washington' or 'WA').
District of Columbia is represented with 'DC'.
X: Integer [0-9]
A: Capital letter [A-Z]
S: Space
All other characters are literal
*/
var formats = apn-formats.lookup('Washington', 'King');
console.log(formats);
// output
[
'XXXXXX-XXXX',
'XXXXXXXX',
'XXXXXX-XXXXSXX'
]
var formats = apn-formats.lookup('hi');
console.log(formats);
// output
{
maui: [ 'X-X-X-XXX-XXX', 'X-X-X-XXX-XXX-XXXX' ],
kalawao: [],
hawaii: [ 'X-X-X-XXX-XXX', 'X-X-X-XXX-XXX-XXXX' ],
kauai: [ 'X-X-X-XXX-XXX', 'X-X-X-XXX-XXX-XXXX' ],
honolulu:
[ 'X-X-X-XXX-XXX',
'X-X-X-XXX-XXX-XXXX',
'X-X-X-XXX-XXXSXX',
'X-X-X-XXX-XXXSAA' ]
}
validate()
/*
lookup() returns a list of all valid APN formats for a given county.
If only a state is given, an object of all counties and their APNs are returned.
If no arguments are provided, an object of all APN formats is returned.
Case and spaces are ignored in state and county names.
State names can be full names or abbreviations ('Washington' or 'WA').
District of Columbia is represented with 'DC'.
X: Integer [0-9]
A: Capital letter [A-Z]
S: Space
All other characters are literal
*/
var formats = apn-formats.lookup('Washington', 'King');
console.log(formats);
// output
[
'XXXXXX-XXXX',
'XXXXXXXX',
'XXXXXX-XXXXSXX'
]
var formats = apn-formats.lookup('hi');
console.log(formats);
// output
{
maui: [ 'X-X-X-XXX-XXX', 'X-X-X-XXX-XXX-XXXX' ],
kalawao: [],
hawaii: [ 'X-X-X-XXX-XXX', 'X-X-X-XXX-XXX-XXXX' ],
kauai: [ 'X-X-X-XXX-XXX', 'X-X-X-XXX-XXX-XXXX' ],
honolulu:
[ 'X-X-X-XXX-XXX',
'X-X-X-XXX-XXX-XXXX',
'X-X-X-XXX-XXXSXX',
'X-X-X-XXX-XXXSAA' ]
}
validate()
/*
validate() checks whether a given APN is valid for a given county.
Returns either true or false.
All letter characters MUST be capitalized.
*/
var validation = apn-formats.validate('123456-7890', 'wa', 'king');
console.log(validation);
//output
true
var validation = apn-formats.validate('1234-5678, 'wa', 'king');
console.log(validation);
//output
false
License
lookup()
/*
lookup() returns a list of all valid APN formats for a given county.
If only a state is given, an object of all counties and their APNs are returned.
If no arguments are provided, an object of all APN formats is returned.
Case and spaces are ignored in state and county names.
State names can be full names or abbreviations ('Washington' or 'WA').
District of Columbia is represented with 'DC'.
X: Integer [0-9]
A: Capital letter [A-Z]
S: Space
All other characters are literal
*/
var formats = apn-formats.lookup('Washington', 'King');
console.log(formats);
// output
[
'XXXXXX-XXXX',
'XXXXXXXX',
'XXXXXX-XXXXSXX'
]
var formats = apn-formats.lookup('hi');
console.log(formats);
// output
{
maui: [ 'X-X-X-XXX-XXX', 'X-X-X-XXX-XXX-XXXX' ],
kalawao: [],
hawaii: [ 'X-X-X-XXX-XXX', 'X-X-X-XXX-XXX-XXXX' ],
kauai: [ 'X-X-X-XXX-XXX', 'X-X-X-XXX-XXX-XXXX' ],
honolulu:
[ 'X-X-X-XXX-XXX',
'X-X-X-XXX-XXX-XXXX',
'X-X-X-XXX-XXXSXX',
'X-X-X-XXX-XXXSAA' ]
}
/*
lookup() returns a list of all valid APN formats for a given county.
If only a state is given, an object of all counties and their APNs are returned.
If no arguments are provided, an object of all APN formats is returned.
Case and spaces are ignored in state and county names.
State names can be full names or abbreviations ('Washington' or 'WA').
District of Columbia is represented with 'DC'.
X: Integer [0-9]
A: Capital letter [A-Z]
S: Space
All other characters are literal
*/
var formats = apn-formats.lookup('Washington', 'King');
console.log(formats);
// output
[
'XXXXXX-XXXX',
'XXXXXXXX',
'XXXXXX-XXXXSXX'
]
var formats = apn-formats.lookup('hi');
console.log(formats);
// output
{
maui: [ 'X-X-X-XXX-XXX', 'X-X-X-XXX-XXX-XXXX' ],
kalawao: [],
hawaii: [ 'X-X-X-XXX-XXX', 'X-X-X-XXX-XXX-XXXX' ],
kauai: [ 'X-X-X-XXX-XXX', 'X-X-X-XXX-XXX-XXXX' ],
honolulu:
[ 'X-X-X-XXX-XXX',
'X-X-X-XXX-XXX-XXXX',
'X-X-X-XXX-XXXSXX',
'X-X-X-XXX-XXXSAA' ]
}
/*
validate() checks whether a given APN is valid for a given county.
Returns either true or false.
All letter characters MUST be capitalized.
*/
var validation = apn-formats.validate('123456-7890', 'wa', 'king');
console.log(validation);
//output
true
var validation = apn-formats.validate('1234-5678, 'wa', 'king');
console.log(validation);
//output
false
Licensed under The MIT License (MIT)
For the full copyright and license information, please view the LICENSE.txt file.