geopy

geopy uses third-party geocoders to convert data like addresses, cities, towns, countries, etc. into geographical coordinates that can easily be plotted on a World map representation.

The conversion goes both ways, from address to coordinates and vice versa.

Besides this, geopy can also be used to measure distances between two points as well.

Supported geocoding services:
- Yahoo! BOSS
- geocoder.us
- Bing Maps API
- Google Geocoding API
- OpenStreetMap Nominatim
- ESRI ArcGIS

geopy works with both major versions of the Python programming language, 2.x and 3.x.

What is new in this release:

• CHANGED:
• MapQuest geocoder removed as the API it uses is now only available to enterprise accounts. OpenMapQuest is a replacement for Nominatim-sourced data.
• Nominatim now uses HTTPS by default and accepts a scheme argument.
• ADDED:
• Nominatim now accepts a domain argument, which allows using a different server than nominatim.openstreetmap.org.
• FIXED:
• Bing was not accessible from get_geocoder_for_service.

What is new in version 1.8.0:

• ADDED:
• NaviData geocoder added. Contributed by NaviData.
• CHANGED:
• LiveAddress now requires HTTPS connections. If you set scheme to be HTTP, rather than the default HTTPS, you will now receive a ConfigurationError.

What is new in version 1.7.0:

• ADDED:
• IGNFrance geocoder.
• FIXED:
• Bing checks the response body for error codes.

What is new in version 1.6.0:

• ADDED:
• Python 3.2 and PyPy3 compatibility.

What is new in version 1.4.0:

• ADDED:
• Mapquest.reverse() method added. Contributed by Dody Suria Wijaya.
• Bing's geocoder now accepts the optional arguments "culture", "includeNeighborhood", and "include". Contributed by oskholl.

What is new in version 1.1.6:

• ADDED:
• GeoNames.reverse() added.
• GoogleV3.timezone() added. This returns a pytz object giving the timezone in effect for a given location at a time (defaulting to now).

What is new in version 1.1.1:

• FIXED:
• Python 3 compatibility.

What is new in version 0.98.1:

• FIXED:
• Mapquest geocoder did not use format_string in the creation of its queries.
• Geocoders incorrectly raised a GeocoderTimedOut exception for all SSLError exceptions.

What is new in version 0.94.2:

• ADDED:
• MANIFEST.in so that LICENSE file gets included in dist packages
• UPDATED:
• Yahoo geocoder uses new PlaceFinder API instead of outdated MapsService V1 API.

What is new in version 0.94.1:

• ADDED:
• Test suite includes geocoding tests for the Google, Bing, Yahoo, GeocoderDotUS, and GeoNames geocoders.
• Geocoder backend for MapQuest's OpenMapQuest API.
• CHANGED:
• `output_format` is deprecated in backends that used it.
• Yahoo geocoder now uses the "old" tuple return format (address, (lat, lon)) rather than the undocumented Location() object, for API consistency. (Object return values with rich data will be implemented in a future release.)
• Added __repr__ and __str__ to Distance.
• FIXED:
• Bing geocoder now works properly. Updated to use the JSON return method rather than XML. `output_format` has always been ignored and is now deprecated.
• GeocoderDotUS now works properly. Updated to use more compact CSV return method rather than XMLRPC.
• Fixed "print" statement in Bing backend. No more print statements remain.
• In addition to checking for system `json` and `simplejson`, geopy now looks for a system-installed `django` (which bundles a copy of simplejson).
• Implement __cmp__ on Distance so that distance objects may be compared against one another.

What is new in version 0.94:

• ADDED: Partial test suite can now be run via "setup.py test"
• FIXED: Issue 5. Converted "print" statements to logger calls to allow compatibility with WSGI.
• FIXED: Issue 16. Google geocoder backend now throws more descriptive exceptions on certain failure statuses.
• FIXED: Issue 18. Add simplejson to install_requires for setup. Use native (Python 2.6+/3.0+) json module if available.
• FIXED: Issue 21 and Issue 25. Distance calculations for values beyond 180/-180 and 90/-90 now wrap instead of raising an error.
• FIXED: Issue 22. Fixed string representation of Point objects so that they don't throw an exception.
• FIXED: Issue 23. Fixed GreatCircleDistance ValueErrors due to floating point precision on extremely close points.