Skip to main content

Find Taiwan ZIP code by address quickly.

Project description

.. image:: https://pypip.in/v/zipcodetw/badge.png
:target: https://pypi.python.org/pypi/zipcodetw

.. image:: https://pypip.in/d/zipcodetw/badge.png
:target: https://pypi.python.org/pypi/zipcodetw

The ZIP Code Finder for Taiwan
==============================

This package lets you find ZIP code by address in Taiwan.

The main features:

1. Fast. It builds ZIP code index by tokenization.
2. Gradual. It returns partial ZIP code rather than noting when address is not
detailed enoguh.
3. Lightweight. It depends on nothing.

Usage
-----

.. code-block:: python

>>> import zipcodetw
>>> zipcodetw.find('臺北市')
'1'
>>> zipcodetw.find('臺北市信義區')
'110'
>>> zipcodetw.find('臺北市信義區市府路')
'110'
>>> zipcodetw.find('臺北市信義區市府路1號')
'11008'

Installation
------------

It is available on PyPI:

.. code-block:: bash

$ sudo pip install zipcodetw

Just install it and have fun. :)

Data
----

The ZIP code directory we use is provided by Chunghwa Post, and is available
from: http://www.post.gov.tw/post/internet/down/index.html#1808

Changelog
---------

v0.2
~~~~

1. ``zipcodetw.find`` is 8x faster now!
2. Better tokenizing logic
3. Better matching logic for sub-number
4. ``zipcodetw.find_zipcodes`` was removed.
5. Internal API was changed a lot.
5. More tests

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

zipcodetw-0.2.tar.gz (428.0 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page