/GPSFlow

GPS data parser and analyzer

Primary LanguageHTML

GPSFlow

This project allows you to download, process and visualize your GPS data from your Google Location History.

Authors : Mathilde Reynaud | Roland Lamidieu | Alexandre Popov | François Paugam | Skander Malouche

Tutor : Romain Vuillemot

Link to our last presentation (in French).

If you do not wish to download your data, or if you do not have any, you can still go to the visualization, there is some test data. You can see the treatment that has been done to the data by clicking on "raw data".

Visualization

Use your data

This visualization allows you to download your own data, but first you need to process it (see below). Once it is done, just click on "Use your own file".

If you are interested on the process of the data, you can see our work and algorithms explained in details in "R&D".

Navigate

The navigation bar allows you to navigate throw the years by clicking on the arrows. To display one day on the map, simply click on the heat map. The heat map represents the number of GPS data per day, so in general the most interested days are the ones in dark blue.

The day selected will be circled in red, and the date of the data displayed on the left (here it was the 26-06-2017)

Process your data

How to execute gpsflow

  1. Download the project and unzip it.

  2. Download your Google Takout Location History here

  • Deselect everything but 'Location History' and click download.
  • Google may ask for your password and you will download a .zip.
  • Unzipp it and find the .json file, which contains all the GPS data collected by Google Maps.

  1. Rename it to takout.json and place it into the pipeline/build-<YOUR_OS>/dist/ folder of the project

  2. Using your terminal, navigate to the pipeline/build-<YOUR_OS>/dist/ folder and run the following command :

./gpsflow takout.json

  1. Your GPS data will be parsed, filtered and analysed. It can take a while (up to 15min). Let it run until everything is done.

  2. Once the programm is finished, if everything went well, you should have a file called output.json inside the dist/ folder.

  3. Use the visualization tool to display the output in your navigator.

How to recompile gpsflow from source

  1. Install pyinstaller
pip install pyinstaller

  1. cd into the pipeline/build-<YOUR_OS>/ folder

  2. delete dist/, build/ and gpsflow.spec

  3. From inside build-<YOUR_OS>/, run the following command

pyinstaller --onefile --additional-hooks-dir=hooks ../src/gpsflow.py
  1. Once finished, the compiled executable is gpsflow inside the dist/ folder

How to run gpsflow using python

  1. Download the project and unzip it.

  2. Install all modules listed in pipeline/requirements.txt

  3. Download your Google Takout Location History here

  • Deselect everything but 'Location History' and click download.
  • Google may ask for your password and you will download a .zip.
  • Unzipp it and find the .json file, which contains all the GPS data collected by Google Maps.

  1. Rename it to takout.json and place it into the pipeline/src/ folder of the project

  2. Using your terminal, navigate to the pipeline/src/ folder and run the following command :

python main.py takout.json

  1. Your GPS data will be parsed, filtered and analysed. It can take a while (up to 15min). Let it run until everything is done.

  2. Once the programm is finished, if everything went well, you should have a file called output.json inside the src/ folder.

  3. Use the visualization tool to display the output in your navigator.