Skip to content

A JS library to convert between Chinese address and postcode.

License

Notifications You must be signed in to change notification settings

xtu/chinese-postcode

Repository files navigation

Chinese Postcode Library

CI Build

In Chinese postal system, a postcode is identified by three levels: province, city and county. This package allows you to search search the postcode by the given address identified by those three parameters. It also provides the functionality to search address from a given postcode.

Install

To get started, simply install it with npm:

npm install chinese-postcode

Usage

var pc = require('chinese-postcode');

// search addresses by postcode
var addresses = pc.getAddress('100093');

// search postcode by address
var postcode = pc.getPostcode({
    province: '湖南',
    city: '怀化市',
    county: '靖州苗族侗族自治县'
});

Contribution

Clone the repo:

git clone https://github.com/xtu/chinese-postcode.git

Run tests:

npm test

Create branch. Make changes. Push branch and create a pull request.

License

ISC

About

A JS library to convert between Chinese address and postcode.

Resources

License

Stars

Watchers

Forks

Packages

No packages published