geocoder

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

These details have not been verified by PyPI

Project links

GitHub Statistics

View statistics for this project via Libraries.io, or by using our public dataset on Google BigQuery

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

These details have not been verified by PyPI

Project links

GitHub Statistics

View statistics for this project via Libraries.io, or by using our public dataset on Google BigQuery

Release history Release notifications | RSS feed

1.38.1

Apr 4, 2018

1.38.0

Mar 9, 2018

1.37.0

Feb 17, 2018

1.36.0

Feb 9, 2018

1.35.0

Jan 25, 2018

1.34.0

Jan 19, 2018

1.33.0

Nov 24, 2017

1.32.1

Sep 16, 2017

1.32.0

Sep 11, 2017

1.31.0

Sep 7, 2017

1.30.1

Aug 29, 2017

1.29.3

Aug 29, 2017

1.29.2

Aug 29, 2017

1.29.1

Aug 22, 2017

1.29.0

Aug 22, 2017

1.28.0

Aug 19, 2017

1.27.0

Aug 14, 2017

1.26.0

Aug 11, 2017

1.25.0

Aug 4, 2017

1.24.1

Aug 2, 2017

1.24.0

Aug 2, 2017

1.23.2

Jul 13, 2017

1.23.1

Jun 19, 2017

1.23.0

Jun 19, 2017

1.22.6

May 25, 2017

1.22.5

May 12, 2017

1.22.4

Apr 17, 2017

1.22.3

Apr 4, 2017

1.21.2

Mar 24, 2017

1.21.1

Mar 24, 2017

1.21.0

Mar 20, 2017

1.20.1

Feb 11, 2017

1.20.0

Jan 21, 2017

1.19.0

Dec 2, 2016

1.18.1

Dec 1, 2016

1.18.0

Dec 1, 2016

1.17.5

Nov 6, 2016

1.17.4

Sep 13, 2016

1.17.3

Aug 31, 2016

1.17.2

Aug 30, 2016

1.17.1

Aug 30, 2016

1.17.0

Aug 30, 2016

1.16.3

Aug 18, 2016

1.16.2

Aug 18, 2016

1.16.1

Aug 11, 2016

1.16.0

Aug 11, 2016

1.15.1

Jun 17, 2016

1.15.0

May 22, 2016

1.14.0

May 22, 2016

1.13.0

May 1, 2016

1.12.0

Apr 13, 2016

1.11.2

Apr 7, 2016

1.11.1

Apr 3, 2016

1.10.1

Mar 28, 2016

1.10.0

Mar 26, 2016

1.9.0

Mar 13, 2016

1.8.2

Feb 21, 2016

1.8.1

Feb 18, 2016

1.8.0

Jan 23, 2016

1.7.2

Jan 13, 2016

1.7.1

Jan 5, 2016

1.6.4

Sep 17, 2015

1.6.3

Sep 15, 2015

1.6.2

Sep 15, 2015

1.6.0

Aug 30, 2015

1.5.3

Aug 23, 2015

1.5.1

Aug 9, 2015

1.5.0

Jul 30, 2015

This version

1.4.1

Jul 29, 2015

1.4.0

May 18, 2015

1.3.1

Apr 13, 2015

1.3.0

Mar 19, 2015

1.2.4

Mar 8, 2015

1.2.3

Mar 8, 2015

1.2.2

Mar 2, 2015

1.2.1

Mar 2, 2015

1.2.0

Mar 1, 2015

1.1.5

Feb 28, 2015

1.1.4

Feb 28, 2015

1.1.3

Feb 5, 2015

1.1.2

Feb 3, 2015

1.1.1

Feb 2, 2015

1.1.0

Jan 29, 2015

1.0.9

Jan 29, 2015

1.0.8

Jan 29, 2015

1.0.7

Jan 28, 2015

1.0.6

Jan 21, 2015

1.0.4

Jan 1, 2015

1.0.3

Dec 16, 2014

1.0.2

Dec 16, 2014

1.0.1

Dec 5, 2014

1.0.0

Nov 21, 2014

0.9.1

Nov 7, 2014

0.9.0

Nov 1, 2014

0.8.4

Oct 20, 2014

0.8.3

Oct 10, 2014

0.8.2

Oct 6, 2014

0.8.1

Sep 28, 2014

0.8.0

Aug 11, 2014

0.7.3

Jul 27, 2014

0.7.2

Jul 14, 2014

0.7.1

Jul 10, 2014

0.7.0

Jul 7, 2014

0.6.2

Jul 3, 2014

0.6.1

Jul 3, 2014

0.6.0

Jun 20, 2014

0.5.9

Jun 5, 2014

0.5.8

Jun 5, 2014

0.5.7

May 19, 2014

Download files

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

Source Distribution

geocoder-1.4.1.zip (55.1 kB view hashes)

Uploaded Jul 29, 2015 Source

Built Distribution

geocoder-1.4.1-py2.py3-none-any.whl (50.2 kB view hashes)

Uploaded Jul 29, 2015 Python 2 Python 3

Hashes for geocoder-1.4.1.zip

Hashes for geocoder-1.4.1.zip
Algorithm	Hash digest
SHA256	`3ea95a2429d1c6bbfb00b7901a17a0b07988e95fb4a82bf1b1f9ae28fbf061d8`
MD5	`048c7637df67105207d5f859d73d7f1e`
BLAKE2b-256	`612c458958ec45e736473b743a090ab3dab3bfb1caf506ade402df79a5963f03`

Hashes for geocoder-1.4.1-py2.py3-none-any.whl

Hashes for geocoder-1.4.1-py2.py3-none-any.whl
Algorithm	Hash digest
SHA256	`626acef7c7c411ee6b4d6ef58c0a3443d49a116807b8719dfb65c4a1cdb2faa9`
MD5	`4070eb56c68ed07da6fccea715bc6b48`
BLAKE2b-256	`82088084f6b7d4c8442840f72f782a18a2810365995e7ef11d9798dfdb9a00ed`