Metadata-Version: 2.0
Name: django-postalcodes
Version: 0.4.0
Summary: Postal code management.
Home-page: https://github.com/bennylope/django-postalcodes/
Author: Ben Lopatin
Author-email: ben.lopatin@wellfireinteractive.com
License: BSD License
Platform: OS Independent
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Framework :: Django
Requires-Dist: Django (>=1.3)

Django Postal Codes
===================

A simple data model for storing postal codes with placenames and location.

Installing
----------

You can clone the repository and install from source::

    python setup.py install

or use `pip` to install from PyPI::

    pip install django-postalcodes

.. note::
    Version 0.2+ requires a GIS backend (e.g. PostGIS). Migrating from 0.1 will
    not be straightforward if you have existing data decimal data or do not
    have a GIS backend.

If you are using South you must use South >= 1.0 to ensure compatability with
the new `south_migrations` migrations module name.

Getting data
------------

Postal code data is available from a number of sources, typically on a country
by country basis. The United States Census Bureau maintains the `Gazetteer
database <http://www.census.gov/geo/www/gazetteer/gazette.html>`_, including
detailed zip code data. The `GeoNames geographical database
<http://www.geonames.org/export/>`_ also provides postal code data for
international postal codes (and other places).

The following data file can be used to prepopulate a PostGIS database with US
postalcodes complete with location.

* `US zip codes using state abbreviations <https://dl.dropbox.com/u/6515401/postalcodes/postalcodes_gis_us.sql.zip>`_ (879 KB)

These files pertain to the 0.1 release but may still be useful. They are based
on location via decimal fields, rather than a GIS point field.

* `International postal codes <http://dl.dropbox.com/u/6515401/postalcodes/postalcodes_international.sql.zip>`_ (9 MB)
* `US zip codes using state abbreviations <http://dl.dropbox.com/u/6515401/postalcodes/postalcodes_us.sql.zip>`_ (623 KB)

The data is licensed under the `Database Contents License <http://opendatacommons.org/licenses/dbcl/1.0/>`_.


