Skip to main content

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

Project description

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

Project details


Release history Release notifications

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page