https://github.com/bennylope/django-postalcodes

A simple data model for storing postal codes with placenames and location.
https://github.com/bennylope/django-postalcodes

django location python

Last synced: 3 months ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/bennylope/django-postalcodes
• Owner: bennylope
• License: mit
• Created: 2012-04-19T13:46:48.000Z (over 12 years ago)
• Default Branch: master
• Last Pushed: 2015-05-22T00:56:16.000Z (over 9 years ago)
• Last Synced: 2024-10-07T15:46:52.138Z (3 months ago)
• Topics: django, location, python
• Language: Python
• Homepage:
• Size: 507 KB
• Stars: 12
• Watchers: 4
• Forks: 7
• Open Issues: 0
• Metadata Files:
  • Readme: README.rst
  • License: LICENSE

Awesome Lists containing this project

README

        
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.

* `US zip codes using state abbreviations `_ (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 `_ (9 MB)

* `US zip codes using state abbreviations `_ (623 KB)

The data is licensed under the `Database Contents License `_.