8888888b.  888                                     888      888          888b     d888                            
888   Y88b 888                                     888      888          8888b   d8888                            
888    888 888                                     888      888          88888b.d88888                            
888   d88P 888 888  888  .d88b.   .d88b.   8888b.  88888b.  888  .d88b.  888Y88888P888  8888b.  88888b.  .d8888b  
8888888P"  888 888  888 d88P"88b d88P"88b     "88b 888 "88b 888 d8P  Y8b 888 Y888P 888     "88b 888 "88b 88K      
888        888 888  888 888  888 888  888 .d888888 888  888 888 88888888 888  Y8P  888 .d888888 888  888 "Y8888b. 
888        888 Y88b 888 Y88b 888 Y88b 888 888  888 888 d88P 888 Y8b.     888   "   888 888  888 888 d88P      X88 
888        888  "Y88888  "Y88888  "Y88888 "Y888888 88888P"  888  "Y8888  888       888 "Y888888 88888P"   88888P' 
                             888      888                                                       888               
                        Y8b d88P Y8b d88P                                                       888               
                         "Y88P"   "Y88P"                                                        888               

A pluggable GeoDjango app with the boundaries of all states in the United States of America. Geography, loosely coupled.

Beware. This software is in beta testing and hasn’t been used much. But don’t let that stop you! Please try it and tell me what sucks.

Features

• A ready-to-serve model with all the states in the United States of America
• Geometry fields for three of the most common SRIDs.
• Simplified geometry fields that thin down the data and make it easier to display many polygons on a single map.
• A read-only admin for reviewing the data
• The 2010 Census population total for each state.

Requirements

Before you begin, you will need to have a Django project with GeoDjango’s ‘django.contrib.gis’ app installed and configured. The official installation guide is here. The official tutorial is here. Both are excellent.

Installation

01. Install the source code

You can download it from PyPi.

pip install latimes-pluggablemaps-usstates

Or, pull the trunk from github

git clone git://github.com/datadesk/latimes-pluggablemaps-usstates.git

02. Install the app in your Django project

In settings.py’s INSTALLED_APPS tuple, add the following.

'us_states',

03. Create the database tables

From the shell, enter:

python manage.py syncdb

04. Load the data

From the same shell, enter the following. Then go get a cup of coffee.

python manage.py loadusstates