Awesome

Python Wi-Fi Positioning System

This script use the Google Geolocation API.
It was tested on GNU/Linux (require iw), OpenBSD (use ifconfig) and Mac OS X (require airport).
Special thanks go to contributors!

API key required:

A Google API key is required, get it yours here:
https://developers.google.com/maps/documentation/geolocation/intro
Screenshot from a previous version (without argparse):
Installation on GNU/Linux and OpenBSD ($: user, #: root):

On GNU/Linux, the script use the iw command to gain access to the Wi-Fi peripheral.
On OpenBSD, it use the ifconfig command to gain access to the Wi-Fi peripheral.
On Ubuntu distribution, it require the installation of the following dependencies:
```
# apt-get install iw
```
On Gentoo distribution, it require the installation of the following dependencies:
```
# emerge -av net-wireless/iw
```
The full git repository is at: https://github.com/initbrain/Python-Wi-Fi-Positioning-System
Get it using the following command:
```
$ git clone https://github.com/initbrain/Python-Wi-Fi-Positioning-System
```
And proceed to final steps.
On GNU/Linux, to use the tool, launch it with root privileges:
```
$ cd Python-Wi-Fi-Positioning-System/
$ python wifi_positioning_system.py -h
# python wifi_positioning_system.py --api-key <GOOGLE_API_KEY> -i <WIFI_INTERFACE> --verbose --json-prettify --with-overview --map-type <ROADMAP|SATELLITE|HYBRID|TERRAIN>
```

Installation on Mac OS X:

On Mac OS X, it use airport to gain access to the Wi-Fi peripheral.
Get it using...

% TODO

And proceed to final steps.

% python wifi_positioning_system.py --api-key <GOOGLE_API_KEY> --verbose --json-prettify --with-overview --map-type <ROADMAP|SATELLITE|HYBRID|TERRAIN>

Usage:

On GNU/Linux and OpenBSD, a Wi-Fi interface name is required to scan with iw and ifconfig commands:

usage: wifi_positioning_system.py [-h] [-V] [-L] [-v] [-k API_KEY] [-p] [-o]
                                  [-m {ROADMAP,SATELLITE,HYBRID,TERRAIN}]
                                  (-i WIFI_INTERFACE | --demo)

optional arguments:
  -h, --help            show this help message and exit
  -V, --version         show program's version number and exit
  -L, --license         show program's license details and exit
  -v, --verbose         enable verbose messages
  -k API_KEY, --api-key API_KEY
                        Google Geolocation API key (could be hardcoded)
  -p, --json-prettify   prettify JSON output
  -o, --with-overview   accuracy overview file generation
  -m {ROADMAP,SATELLITE,HYBRID,TERRAIN}, --map-type {ROADMAP,SATELLITE,HYBRID,TERRAIN}
                        accuracy overview map type

required arguments:
  -i WIFI_INTERFACE     specify Wi-Fi scan interface
  --demo                demo mode - West Norwood (London)

additional informations:
  ROADMAP   displays the default road map view
  SATELLITE displays Google Earth satellite images
  HYBRID    displays a mixture of normal and satellite views
            (this is the default map type)
  TERRAIN   displays a physical map based on terrain information

On Mac OS X, there is no need of a Wi-Fi interface name to launch a scan with airport:

usage: wifi_positioning_system.py [-h] [-V] [-L] [-v] [-k API_KEY] [-p] [-o]
                                  [-m {ROADMAP,SATELLITE,HYBRID,TERRAIN}]
                                  [--demo]

optional arguments:
  -h, --help            show this help message and exit
  -V, --version         show program's version number and exit
  -L, --license         show program's license details and exit
  -v, --verbose         enable verbose messages
  -k API_KEY, --api-key API_KEY
                        Google Geolocation API key (could be hardcoded)
  -p, --json-prettify   prettify JSON output
  -o, --with-overview   accuracy overview file generation
  -m {ROADMAP,SATELLITE,HYBRID,TERRAIN}, --map-type {ROADMAP,SATELLITE,HYBRID,TERRAIN}
                        accuracy overview map type
  --demo                demo mode - West Norwood (London)

additional informations:
  ROADMAP   displays the default road map view
  SATELLITE displays Google Earth satellite images
  HYBRID    displays a mixture of normal and satellite views
            (this is the default map type)
  TERRAIN   displays a physical map based on terrain information

Contributors (ext-repo):

Initial publication on Twitter
2012-06-25: modified to run on OS X - James Armitage (@armitagej)
2012-06-26: modified to process in python - Dan Gleebits (@DGleebits)
2012-10-01: modified to parse the xml output of airport - Vincent Ohprecio (@BigsnarfDude)
2017-01-03: modified to work with the new Google Geolocation API - Giovanni Angoli (@juzam)
2017-01-06: merging all modifications - Julien Deudon (@initbrain)
2017-01-07: modified to support new permissions assignement methods - Julien Deudon (@initbrain)
2017-01-08: source code reorganization - Julien Deudon (@initbrain)
2017-01-15: OpenBSD port - Geoffrey Robert (@mks10110)