geocoder 1.1.4

Geocoder is a geocoding library, written in python, simple and consistent.

Geocoder
========

|badge| |travis|

Geocoder is a geocoding library, written in python, simple and
consistent.

.. figure:: http://i.imgur.com/vUJKCGl.png
:alt: providers

providers
Many online providers such as Google & Bing have geocoding services,
these providers do not include Python libraries and have different JSON
responses between each other.

Consistant JSON responses from various providers.

.. code:: python

>>> g = geocoder.google('New York City')
>>> g.latlng
[40.7127837, -74.0059413]
>>> g.state
'New York'
>>> g.json
...

Features
--------

- `GeoJSON
Support <http://geocoder.readthedocs.org/features/GeoJSON>`__
- `OpenStreetMap
Support <http://geocoder.readthedocs.org/features/OpenStreetMap>`__
- `Command Line
Interface <http://geocoder.readthedocs.org/features/Command-Line-Interface>`__
- `Confidence
Score <http://geocoder.readthedocs.org/features/Confidence-Score>`__
- `Well Known Text
Support <http://geocoder.readthedocs.org/features/Well-Known-Text-Support>`__

Installation
------------

To install Geocoder, simply:

.. code:: bash

$ pip install geocoder

Providers
---------

- `ArcGIS <http://geocoder.readthedocs.org/providers/ArcGIS>`__
- `Bing <http://geocoder.readthedocs.org/providers/Bing>`__
- `CanadaPost <http://geocoder.readthedocs.org/providers/CanadaPost>`__
- `FreeGeoIP <http://geocoder.readthedocs.org/providers/FreeGeoIP>`__
- `Geocoder-ca <http://geocoder.readthedocs.org/providers/Geocoder-ca>`__
- `Geonames <http://geocoder.readthedocs.org/providers/Geonames>`__
- `Google <http://geocoder.readthedocs.org/providers/Google>`__
- `HERE <http://geocoder.readthedocs.org/providers/HERE>`__
- `MapQuest <http://geocoder.readthedocs.org/providers/MapQuest>`__
- `MaxMind <http://geocoder.readthedocs.org/providers/MaxMind>`__
- `OpenCage <http://geocoder.readthedocs.org/providers/OpenCage>`__
- `OpenStreetMap <http://geocoder.readthedocs.org/providers/OpenStreetMap>`__
- `GeoOttawa <http://geocoder.readthedocs.org/providers/GeoOttawa>`__
- `TomTom <http://geocoder.readthedocs.org/providers/TomTom>`__
- `Yahoo <http://geocoder.readthedocs.org/providers/Yahoo>`__

Documentation
-------------

Documentation is available at http://Geocoder.ReadTheDocs.org

Twitter
-------

Speak up on Twitter
`DenisCarriere <https://twitter.com/DenisCarriere>`__ and tell me how
you use this Python Geocoder. New updates will be pushed to Twitter
Hashtags `python <https://twitter.com/search?q=%23python>`__.

Topic not available?
--------------------

If you cannot find a topic you are looking for, please feel free to ask
me `DenisCarriere <https://twitter.com/DenisCarriere>`__ or post them on
the `Github Issues
Page <https://github.com/DenisCarriere/geocoder/issues>`__.

Feedback
--------

Please feel free to give any feedback on this module. If you find any
bugs or any enhancements to recommend please send some of your
comments/suggestions to the `Github Issues
Page <https://github.com/DenisCarriere/geocoder/issues>`__.

Thanks to
---------

A big thanks to all the people that help contribute:

-
- `Mahdi Yusuf <https://twitter.com/myusuf3>`__: Promotesyd by
`Pycoders Weekly <https://twitter.com/pycoders>`__
-
-
-
-
- `flebel <https://github.com/flebel>`__
- `patrickyan <https://github.com/patrickyan>`__
- `esy <https://github.com/lambda-conspiracy>`__

.. |badge| image:: https://badge.fury.io/py/geocoder.png
:target: http://badge.fury.io/py/geocoder
.. |travis| image:: https://travis-ci.org/DenisCarriere/geocoder.png?branch=master
:target: https://travis-ci.org/DenisCarriere/geocoder