UNIMIBInside / COVID-19-Timeline-Download-Tool

Use Google Maps Timeline data to compare with COVID-19 patient history location.

COVID-19 Timeline Download Tool

Download Google Maps Timeline data and donate it to help reasearch on COVID19.

This webpage will guide you through the process of downloading your Google Maps Timeline and send them to our research group. Anonymization will be applied on the stored timeline and you will be enable to widraw your consent and request the ask for your data to be deleted at any time.

NodeJs for Spacetime hash

To protect patient's privacy, we employ a simple hash algorithm called ST hash (SpaceTime hash) to hash (time point, lat, lng) into a 64-bit value. Then, when user wants to compare their historical track, they follow the same hash algorithm. If a conflict happens, it means the user and the patient have had met at a particular spacetime point.

The following commands are used to generate the hashed JSON file.

  # Node.js v12.x:
  curl -sL https://deb.nodesource.com/setup_12.x | sudo -E bash -
  sudo apt-get install -y nodejs
  npm install js-sha256 fs yargs fast-xml-parser csv-parse

  node nodejs/sthash.js
  node nodejs/sthash.js -d "your description" --remove_top 3
                        -i INPUT_FILE.{kml|json} -o OUTPUT_FILE-hashed.json

Once the hashed JSON is generated, host it in somewhere (remember to enable Allow- headers so that it follows the CORS policy), and use hashes= parameter in the URL to load it:

  https://pandemic.events/?hashes=YOUR_HASHED_FILE_URL

Contribution

Testing

This project comes with unittest code. Please open the browser debug console and type:

  test();

Then you should be able to see the following message which indicates all test cases have passed.

  test.js:56 [PASS]

If you see any error, please fix them before you upload.

Push to development page:

  $ git push origin master:master  # replace the first 'master' with your local branch name

New change may take few minutes to be propagated on the server side.

Note that the preview is only for developer and could be broken anytime.

Push to production

Ensure your local repo is clean to create a branch.

  $ export ORG_BRANCH=$(git branch | grep \* | cut -d ' ' -f2)       # Save original branch name.
  $ git checkout -b prod origin/master                               # Checkout new branch. Change
                                                                     # 'origin/master' in case you
                                                                     # prefer something else.
  $ git push origin prod:gh-pages                                    # Push to production.
  $ git checkout ${ORG_BRANCH}                                       # Move back to original branch.
  $ git branch -D prod