Skip to main content

A complete Python Geocoding module made easy.

Project description

# [Geocoder](https://github.com/DenisCarriere/geocoder) [![version](https://badge.fury.io/py/geocoder.png)](http://badge.fury.io/py/geocoder) [![build](https://travis-ci.org/DenisCarriere/geocoder.png?branch=master)](https://travis-ci.org/DenisCarriere/geocoder)

### A complete Python Geocoding module made easy.

Every task is made easy with tons of help & debug commands!

`python >>> import geocoder # pip install geocoder >>> g = geocoder.google('<address>') >>> g.lat, g.lng 45.413140 -75.656703 ... `

![Providers](https://pbs.twimg.com/media/Bqi8kThCUAAboo0.png)

## QuickStart

A place to get you started on how to use this module and set up your work station.

Install from PyPi `bash $ pip install geocoder `

## Command Line Interface

Still in early development, this is an easy application to speed up your geocoding needs.

Single Input to JSON

`bash $ geocode 'Ottawa, Ontario' {'status': 'OK', 'locality': 'Ottawa', 'country': 'Canada', 'provider': 'bing', 'state': 'ON', 'location': u'Ottawa, Ontario', 'address': 'Ottawa, ON', 'lat': 45.389198303222656, 'lng': -75.68800354003906, 'quality': 'PopulatedPlace', 'accuracy': 'Rooftop'} `

CSV file input > output

The first row of the CSV will be geocoded, all other attributes will be kept.

`bash $ geocode --input 'items.csv' --output 'results.csv' `

For more development requests for the CLI, please provide your input in the [Github Issues Page](https://github.com/DenisCarriere/geocoder/issues).

### Visit the [Wiki](https://github.com/DenisCarriere/geocoder/wiki/)

Please look at the following pages on the wiki for more information about a certain topic.

### Providers Here is a list of providers that are available for use with FREE or limited restrictions.

  • [OSM](https://github.com/DenisCarriere/geocoder/wiki/OSM)
  • [Bing](https://github.com/DenisCarriere/geocoder/wiki/Bing)
  • [Nokia](https://github.com/DenisCarriere/geocoder/wiki/Nokia)
  • [Yahoo](https://github.com/DenisCarriere/geocoder/wiki/Yahoo)
  • [Google](https://github.com/DenisCarriere/geocoder/wiki/Google)
  • [ArcGIS](https://github.com/DenisCarriere/geocoder/wiki/ArcGIS)
  • [TomTom](https://github.com/DenisCarriere/geocoder/wiki/TomTom)
  • [Geonames](https://github.com/DenisCarriere/geocoder/wiki/Geonames)
  • [MapQuest](https://github.com/DenisCarriere/geocoder/wiki/MapQuest)
  • [Geocoder.ca](https://github.com/DenisCarriere/geocoder/wiki/Geocoder.ca)

### Extras

The fun extra stuff I added to enjoy some cool features the web has to offer.

  • [Reverse Geocoding](https://github.com/DenisCarriere/geocoder/wiki/Reverse)
  • [IP Address](https://github.com/DenisCarriere/geocoder/wiki/IP Address)
  • [Elevation (Meters)](https://github.com/DenisCarriere/geocoder/wiki/Elevation)
  • [Time Zone](https://github.com/DenisCarriere/geocoder/wiki/TimeZone)
  • [CanadaPost](https://github.com/DenisCarriere/geocoder/wiki/CanadaPost)

### Topic not available?

If you cannot find a topic you are looking for, please feel free to ask me [@DenisCarriere](https://github.com/DenisCarriere) or post them on the [Github Issues Page](https://github.com/DenisCarriere/geocoder/issues).

## Support

This project is free & open source, it would help greatly for you guys reading this to contribute, here are some of the ways that you can help make this Python Geocoder better.

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

### Twitter

Speak up on Twitter [@Addxy](https://twitter.com/search?q=%40Addxy) and tell us how you use this Python Geocoder. New updates will be pushed to Twitter Hashtags [#geocoder](https://twitter.com/search?q=%23geocoder).

### Thanks to

A big thanks to all the people that help contribute: [@flebel](https://github.com/flebel) [@patrickyan](https://github.com/patrickyan)

Project details


Release history Release notifications

This version
History Node

0.8.2

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-0.8.2-py2.py3-none-any.whl (35.7 kB) Copy SHA256 hash SHA256 Wheel 2.7
geocoder-0.8.2.zip (36.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