Skip to content

Latest commit

 

History

History
46 lines (31 loc) · 1.75 KB

README.rst

File metadata and controls

46 lines (31 loc) · 1.75 KB

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, including detailed zip code data. The GeoNames geographical database 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.

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.

The data is licensed under the Database Contents License.