Skip to main content

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

Project description

# Geocoder

[![PyPi Badge][badge]][badge_url] [![Travis CI][travis]][travis_url] [![Coverage Status][coverage]][coverage_url]

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

![][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.

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

## Installation

To install Geocoder, simply:

```bash
$ pip install geocoder
```

## Providers

| Global | Country | Specialized |
|:----------------|:----------------|:--------------|
| [Google] | [Yandex] | [GeoOttawa] |
| [Bing] | [Geocoder.ca] | [FreeGeoIP] |
| [OpenStreetMap] | [Baidu] | [MaxMind] |
| [HERE] | | [What3Words] |
| [TomTom] | | [CanadaPost] |
| [MapQuest] | | [GeoNames] |
| [OpenCage] | | |
| [Yahoo] | | |
| [ArcGIS] | | |


## Features

- [Distance Tool]
- Formats (JSON, GeoJSON, OSM, WKT)
- Command Line Interface
- Confidence Score

## Documentation

https://geocoder.readthedocs.org/

## Twitter

Speak up on Twitter [DenisCarriere] and tell me how you use this Python Geocoder. New updates will be pushed to Twitter Hashtags [python].

## Topic not available?

If you cannot find a topic you are looking for, please feel free to ask me [DenisCarriere] or post them on the [Github Issues Page].

## 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].

## Thanks to

A big thanks to all the people that help contribute:

- [Thomas Gratier] - Wrote an article about [Geocoder vs. Geopy]
- [Max Arnold] - Submitted Github Issue
- [Thanh Ha] - Cleaned up code & Unit Testing
- [Mahdi Yusuf] - Promoted by [Pycoders Weekly], [Issue #155]
- [Alex Pilon] - Cleaned up code
- [Philip Hubertus] - Provided HERE improvements & documentation
- [Antonio Lima] - Improved code quality and introduced Rate Limits
- [Alexander Lukanin] - Improved Python 3 compatibilty
- [flebel] - Submitted Github Issues
- [patrickyan] - Submitted Github Issues
- [esy] - Submitted Github Issues

[Thomas Gratier]: https://twitter.com/ThomasG77
[Max Arnold]: https://github.com/max-arnold
[Thanh Ha]: https://twitter.com/zxiiro
[Alex Pilon]: http://alexpilon.ca
[Mahdi Yusuf]: https://twitter.com/myusuf3
[Pycoders Weekly]: https://twitter.com/pycoders
[Philip Hubertus]: https://twitter.com/philiphubs
[Antonio Lima]: https://twitter.com/themiurgo
[Alexander Lukanin]: https://github.com/alexanderlukanin13
[flebel]: https://github.com/flebel
[patrickyan]: https://github.com/patrickyan
[esy]: https://github.com/lambda-conspiracy

[Issue #155]: http://t.co/zfBWVit5b2
[Geocoder vs. Geopy]: http://webgeodatavore.com/python-geocoders-clients-comparison.html
[providers]: http://i.imgur.com/vUJKCGl.png
[coverage]: https://coveralls.io/repos/DenisCarriere/geocoder/badge.svg
[coverage_url]: https://coveralls.io/r/DenisCarriere/geocoder
[badge]: https://badge.fury.io/py/geocoder.png
[badge_url]: http://badge.fury.io/py/geocoder
[travis]: https://travis-ci.org/DenisCarriere/geocoder.png?branch=master
[travis_url]: https://travis-ci.org/DenisCarriere/geocoder
[DenisCarriere]: https://twitter.com/DenisCarriere
[python]: https://twitter.com/search?q=%23python
[Github Issues Page]: https://github.com/DenisCarriere/geocoder/issues

[Distance Tool]: http://geocoder.readthedocs.org/en/latest/features/Distance/
[Google]: http://geocoder.readthedocs.org/en/latest/providers/Google/
[Bing]: http://geocoder.readthedocs.org/en/latest/providers/Bing/
[OpenStreetMap]: http://geocoder.readthedocs.org/en/latest/providers/OpenStreetMap/
[HERE]: http://geocoder.readthedocs.org/en/latest/providers/HERE/
[TomTom]: http://geocoder.readthedocs.org/en/latest/providers/TomTom/
[MapQuest]: http://geocoder.readthedocs.org/en/latest/providers/MapQuest/
[OpenCage]: http://geocoder.readthedocs.org/en/latest/providers/OpenCage/
[Yahoo]: http://geocoder.readthedocs.org/en/latest/providers/Yahoo/
[ArcGIS]: http://geocoder.readthedocs.org/en/latest/providers/ArcGIS/
[Yandex]: http://geocoder.readthedocs.org/en/latest/providers/Yandex/
[Geocoder.ca]: http://geocoder.readthedocs.org/en/latest/providers/Geocoder-ca/
[Baidu]: http://geocoder.readthedocs.org/en/latest/providers/Baidu/
[GeoOttawa]: http://geocoder.readthedocs.org/en/latest/providers/GeoOttawa/
[FreeGeoIP]: http://geocoder.readthedocs.org/en/latest/providers/FreeGeoIP/
[MaxMind]: http://geocoder.readthedocs.org/en/latest/providers/MaxMind/
[What3Words]: http://geocoder.readthedocs.org/en/latest/providers/What3Words/
[CanadaPost]: http://geocoder.readthedocs.org/en/latest/providers/CanadaPost/
[GeoNames]: http://geocoder.readthedocs.org/en/latest/providers/GeoNames/

Project details


Release history Release notifications

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
geocoder-1.4.0-py2.py3-none-any.whl (53.9 kB) Copy SHA256 hash SHA256 Wheel 2.7
geocoder-1.4.0.zip (55.5 kB) Copy SHA256 hash SHA256 Source None

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