Metadata-Version: 2.0
Name: mozilla-location-python
Version: 0.5.0
Summary: Using Mozilla Location services, log location vs. time using WiFi or convert to KML.
Home-page: https://github.com/scivision/mozilla-location-python
Author: Michael Hirsch, Ph.D.
Author-email: UNKNOWN
License: UNKNOWN
Platform: UNKNOWN
Requires-Python: >=3.6
Requires-Dist: pandas
Requires-Dist: requests
Provides-Extra: kml
Requires-Dist: simplekml; extra == 'kml'
Provides-Extra: tests
Requires-Dist: coveralls; extra == 'tests'
Requires-Dist: nose; extra == 'tests'

# mozilla-location-python
Uses nmcli on Linux in a short, simple Mozilla Location Services with Wifi from Python.
Goal was to be as simple as possible.
Works with Python &ge; 3.6.

## Install
```sh
python -m pip install -e .
```

### prereqs
Linux system with NetworkManager (e.g. Ubuntu, Raspberry Pi, etc.).



## Usage

    ./MozLoc.py

Returns `dict` containing `lat` `lng` `accuracy` `N BSSIDs heard`.
In urban areas, accuracy ~ 5 - 100 meters.


### convert to KML
You can display your logged data in Google Earth or other KML value after converting by

    ./csv2kml.py in.log out.kml

with

    pip install simplekml

Note that your time MUST be in ISO 8601 format or some KML reading programs such as Google Earth will just show a blank file.
E.g.

2016-07-24T12:34:56


## Contributing
Pull request if you have another favorite approach.
Would like to add Bluetooth, should be simple.


## Notes

* [Inspired by](https://github.com/flyinva/mozlosh)
* [Alternative using Skyhook and geoclue](https://github.com/scivision/python-geoclue)
* [Raspberry Pi NetworkManager](https://raspberrypi.stackexchange.com/a/73816)

### Raspberry Pi 3
Debian comes without NetworkManager by default.
Be careful as you lose Wifi password etc. by this procedure

1. Install network manager and remove the old
   ```sh
   sudo apt install network-manager
   sudo apt purge dhcpcd5
   ```
   reboot
2. upon reboot, try
   ```sh
   nmcli dev wifi list
   ```
   you should see several wifi access points and signal.
3. try the MLS geolocation program above.


