https://github.com/simonw/geocoders

Ultra simple API for geocoding a single string against various web services.
https://github.com/simonw/geocoders

Last synced: 8 days ago
JSON representation

Ultra simple API for geocoding a single string against various web services.

• Host: GitHub
• URL: https://github.com/simonw/geocoders
• Owner: simonw
• License: bsd-2-clause
• Created: 2009-05-26T20:11:19.000Z (over 15 years ago)
• Default Branch: master
• Last Pushed: 2013-10-28T21:43:24.000Z (about 11 years ago)
• Last Synced: 2024-10-18T07:54:22.602Z (22 days ago)
• Language: Python
• Homepage:
• Size: 114 KB
• Stars: 183
• Watchers: 11
• Forks: 22
• Open Issues: 3
• Metadata Files:
  • Readme: README.txt
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
Geocoders

=========

Code for accessing various geocoding web services with an ultra simple API:

    name, (lat, lon) = geocode('london')

The geocode functions return (unicode_place_name, (float_lat, float_lon)) if

the string can be geocoded, and (None, (None, None)) if it cannot.

Currently supported: Google Geocoder, Yahoo! Geocoder, Yahoo! Placemaker,

GeoNames, Multimap, and Nominatim.

Google:

>>> from geocoders.google import geocoder

>>> geocode = geocoder('GOOGLE-API-KEY')

>>> geocode('new york')

(u'New York, NY, USA', (40.756053999999999, -73.986951000000005))

>>> geocode('oneuth')

(u'South, Bloomfield, NY 14469, USA', (-77.5385449999999, 42.865267000000003))

Yahoo!:

>>> from geocoders.yahoo import geocoder

>>> geocode = geocoder('YAHOO-API-KEY')

>>> geocode('new york')

(u'New York, NY, US', (40.714550000000003, -74.007124000000005))

>>> geocode('oneuth')

(u'Aneth, UT 84510, US', (37.217799999999997, -109.189911))

Yahoo! Placemaker:

>>> from geocoders.placemaker import geocoder

>>> geocode = geocoder('YAHOO-API-KEY')

>>> geocode('new york')

(u'New York, NY, US', (40.714500000000001, -74.007099999999994))

>>> geocode('oneuth')

(None, (None, None))

While Yahoo! Placemaker isn't strictly designed as a geocoder, in practice it

can be useful for things like "did you mean location X" in a regular search

engine.

GeoNames:

>>> from geocoders.geonames import geocode # No need for a geocoder factory

>>> geocode('new york')

(u'New York', (40.714269100000003, -74.005972900000003))

>>> geocode('oneuth')

(None, (None, None))

Multimap:

>>> from geocoders.multimap import geocoder

>>> geocode = geocoder('MULTIMAP-API-KEY')

>>> geocode('new york')

('New York, State of New York, United States', ('43.00035', '-75.49990'))

>>> geocode('oneuth')

('Omeath, Louth', ('54.08790', '-6.26070'))

Nominatim:

>>> from geocoders.nominatim import geocoder

>>> geocode = geocoder('EMAIL-ADDRESS')

>>> geocode('new york')

('New York, United States of America, North America', ('40.7305991', '-73.9865812'))

>>> geocode('oneuth')

(None, (None, None))

Reversing the order

-------------------

Some libraries use (longitude, latitude) co-ordinate pairs instead of the 

(latitude, longitude) returned by the geocode functions. The geocoder factory 

functions all take an optional lonlat=True argument if you need this 

behaviour. Some examples:

Google:

>>> from geocoders.google import geocoder

>>> geocode = geocoder('GOOGLE-API-KEY', lonlat = True)

>>> geocode('new york')

(u'New York, NY, USA', (-74.005972900000003, 40.714269100000003))

GeoNames:

>>> from geocoders.geonames import geocoder # Using geocoder factory

>>> geocode = geocoder(lonlat = True)

>>> geocode('new york')

(u'New York', (-74.005972900000003, 40.714269100000003))