Skip to content
Python package for shapefile-based geocoding
Latest commit 5288e6e Mar 16, 2012 @gka readme
Failed to load latest commit information.
.gitignore .gitignore Feb 20, 2012 readme Mar 16, 2012 fixed desc in Feb 22, 2012 changed max_dist unit to km, added documentation Feb 20, 2012

pyshpgeocode – merging data and geography

This Python package is for reverse geocoding of data points to shapefile regions. It is developed primarily for assigning administrative region codes to a set of geo coordinates (in standard latitude/longitude). All you need is a shapefile of the regions you want to geocode to.

Usage example:

>>> import shapegeocode
>>> gc = shapegeocode.geocoder('NUTS_RG_03M_2006.shp')
>>> gc.geocode(52.1, 11.7)
    'NUTS_ID': 'DEE0',
    'OBJECTID': 271,
    'STAT_LEVL_': 2

Bag of tricks

You can speed up the reverse geocoding by limiting the number of polygons that need to be tested. This can be achieved by injecting a filter function either to the geocoder constructor or per each geocode call .

# consider only polygons that have STAT_LEVL_ == 2
gc = shapegeocode.geocoder('NUTS_RG_03M_2006.shp', filter=lambda r: r['STAT_LEVL_'] == 2)

# skip every polygon whose NUTS_ID does not begin with "DE"
gc.geocode(53.425, 14.55, filter=lambda r: r['NUTS_ID'][:2] == 'DE')

In some situations the lat,lon positions you're dealing with may not be as accurate as your boundary data. For instance, the geo coordinates of coastal cities are often located outside the boundary polygon they belong to. Therefor, you can set the maximum distance (in km) that is still accepted using the max_dist argument.

>>> gc = shapegeocode.geocoder('NUTS_RG_03M_2006.shp', filter=lambda r: r['NUTS_ID'][:2] == 'DE')
>>> gc.geocode(53.425, 14.55)
>>> gc.geocode(53.425, 14.55, max_dist=5)
>>> gc.geocode(53.425, 14.55, max_dist=15)
    'NUTS_ID': 'DE80',
    'OBJECTID': 185, 
    'STAT_LEVL_': 2
Something went wrong with that request. Please try again.