geo-locator

geo-locator is an application that maps an IP address to a Location (latitude, longitude, country).

New Features!

• API has just been added and updated to return json formatted results.

IP Geolocation Usage

IP geolocation is inherently imprecise. Locations are often near the center of the population. Any location provided by a GeoIP2 database or web service should not be used to identify a particular address or household.

Tech

geo-locator uses a number of open source projects to work properly:

• geoIP - Provides the database reader needed to read the .mmdb binaries
• MaxMind - Provides the .mmdb binaries
• flask - a microframework for Python
• python - Python 2.6 or newer is required. Not tested on Python 3.
• virtualenv - a highly reccomended python virtual environment builder read more

Installation

geo-locator requires flask, virtualenv, and geoIP to work properly (all requirements should install if you follow the instructions below). To begin installation you must have Python 2.7.

0.5. Install virtualenv:

$ pip install virtualenv

1. Create and initialize flask virtualenv for the project:

$ cd geo-locater
$ virtualenv project
New python executable in project/bin/python
Installing setuptools............................done.
Installing pip...................done.

note: you can create the virtualenv with whatever name you would like, but in doing so you must also change the shebang in the app.py file from #!../project/bin/python -> #!..//bin/python

2. Install dependencies inside the virtualenv:

$ project/bin/pip install -r requirements.txt

3. Run the server!

$ cd geo-locater
$ ./app.py

4. Test results

Navigate to your front facing IP http://<your-ip>:8080

Todos

• Implement the free MaxMind ISP
• moar things

License

This product includes GeoLite2 data created by MaxMind, available from MaxMind.