Click here to Skip to main content
Click here to Skip to main content

Tagged as

Offline Reverse Geocode

, 26 Jun 2014 LGPL3
Rate this:
Please Sign up or sign in to vote.
Offline Reverse Geocode

I often use Google's geocoding API to find details about a location like this:

>>> from webscraping import download
>>> D = download.Download()
>>> D.geocode('-37.81,144.96')
{'address': "127-141 A'Beckett Street",
 'country': 'Australia',
 'country_code': 'AU',
 'full_address': "127-141 A'Beckett Street, Melbourne VIC 3000, Australia",
 'lat': -37.810035,
 'lng': 144.959875,
 'number': '127-141',
 'postcode': '3000',
 'state': 'Victoria',
 'state_code': 'VIC',
 'street': "A'Beckett Street",
 'suburb': 'Melbourne'}

The drawback of this approach is the Google API limits each user to 2500 requests per 24 hours. So if I want to geocode 1 million locations, then I would need to rent a lot of proxies or else the API calls will take over a year to complete (1,000,000 / 2,500 = 400 days). To meet this use case, I built a module to reverse geocode a latitude / longitude coordinate using a list of known locations from geonames.

Here is some example usage:

>>> import reverse_geocode
>>> coordinates = (-37.81, 144.96), (31.76, 35.21)
[{'city': 'Melbourne', 'country_code': 'AU', 'country': 'Australia'},
 {'city': 'Jerusalem', 'country_code': 'IL', 'country': 'Israel'}]

Internally, the module uses a k-d tree to efficiently find the nearest neighbour of each given coordinate. On my netbook, I find building the tree takes ~2.5 seconds and then each location query just ~1.5 ms.

The module is licensed under the LGPL on bitbucket:


This article, along with any associated source code and files, is licensed under The GNU Lesser General Public License (LGPLv3)


About the Author

Richard Penman

Australia Australia
No Biography provided

Comments and Discussions

GeneralMy vote of 5 PinmemberPaul Tait27-Jun-14 21:19 
GeneralMy vote of 5 PinprofessionalSpencer Kittleson27-Jun-14 12:04 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Terms of Use | Mobile
Web01 | 2.8.150331.1 | Last Updated 26 Jun 2014
Article Copyright 2014 by Richard Penman
Everything else Copyright © CodeProject, 1999-2015
Layout: fixed | fluid