yjlou/2019-ncov

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

2019-nCov

Use Google Maps Timeline data to check whether you had contacted the patient or not.

Check it now! https://yjlou.github.io/2019-nCov/

The Web Interface

Patient Data from Trustable Sources

We integrate trustable data sources into our tool. With the patient historical track data, user can drag/drop in their tracks to compare. Please read 'countries' folder for more details.

Note that all comparisons are happening on the local device. Nothing is uploaded to server. This can ensure the user's privacy is protected.

Use Your Own Patient Data

This is useful when you want to use your own patient data, but without sharing it with rest of the world. By assigning a 'patient=URL' parameter in URL, you can load your own patient data. The file can be either JSON or KML format.

A use case is that a trustable third party (e.g. a government CDC) reads out the history location data from patient's phone, but they don't want to publish patient's data to make public panic. Instead, they can host the patient data in URL and use 'patient=URL' to load it into this tool. Then, they can compare people's history location data (the people can voluntarily provide their own data to the trustable third party) in the step 3 of this tool (by dragging and dropping tons of data files).

Same here.All comparisons are happening on local device. Nothing is uploaded to server.

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

See preview here. 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. If you are not developer, please use the production page instead.

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

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

Local test

To start local server:

npm install  # or just npm install http-server
node_modules/http-server/bin/http-server .

2019-ncov's Issues

Flutter App TODO List

• Check against patient data
  • Define server side API (could be static file(s))
  • Fetch patient data from server
  • Parse patient data
  • Compare patient data with local data
• Export collected locations
  • Export decrypted database
  • Export encrypted database (do we need this? are there any use cases?)
• Polish UI
  • Ask again before deleting database

Selecting period is not working on mobile

Reproduce:

• On chrome browser (PC), open dev console, and enable "device toolbar" to simulate a phone device.
• Go to step 2, try to select a different period (e.g. "Today"), and it won't work.

Broken readme link (504 Gateway Time-out)

The readme link (https://ppt.cc/fgrRBx) is broken. I'm not sure where the link is supposed to point. Anyone?

KML file downloaded contains only a fragment of locations in history

Hello, when downloading the kml file i noticed that it's a lot smaller, so i parsed it and it got 340 locations for me, when here i get thousands.

Added to Open Source COVID-19

Thanks for your work to help the people in need! Your site has been added to the Open-Source-COVID-19 page, which collects open source projects related to COVID-19, including maps, data, news, api, analysis, medical and supply information, etc. Please share to anyone who might need the information in the list, or will possibly contribute to some of those projects. You are also welcome to recommend more projects.

http://open-source-covid-19.weileizeng.com/

Cheers!

Process terminates with error: Parser is undefined

Steps to reproduce

1. visit https://yjlou.github.io/2019-nCov/?hl=zh-TW#
2. go to step 3 and choose any XML from google
3. open Devtool console
4. click next to go to step 4

Expected

Processed result

Actual

Process silently stopped and error is emitted in Devtool console.

Broken repo link

I just found that the link of this repo (https://pandemic.events) is broken. According to this commit, maybe it should also be changed from https://pandemic.events to https://yjlou.github.io/2019-nCov/?

Historical location data download issue

Description

When you choose the history range in step 2, it will not actually download the historical data of that period, but only the data of that day.

Expected behavior

I chose the last three days as the period, I should get below files:

• history-2020-02-28.kml
• history-2020-02-29.kml
• history-2020-03-01.kml

Actual behavior

I chose the last three days as the period, but I only get one files:

• history-2020-02-28.kml

Point in polygon

We should consider this: https://github.com/substack/point-in-polygon to handle footprints in a large area.

Support multi-language data

Try to support multi-language name / description, e.g.

{
  "name": {
    "zh-TW": "雲林東勢開安宮",
    "en-US": "Kai’an Temple"
  },
  "
}

When "name" is just a string, then we would just use it.
When current locale is not in "name", we can fallback to "en-US".

Android Sometimes Cannot Save Files

Platform: Android (either Chrome browser or the browser in Facebook App). Didn't test on iOS (iPhone/iPad) yet.

Way to reproduce: clicking 'Download' button in step 2

Expect behavior: downloading KML files.

Actual behavior: launching Google Maps Timeline instead. Sometimes a few files can be downloaded, but not all files.

Frequency: can be reproduced easily.

Analysis: I guess there exists race condition that while the Javascript is opening KML links to download, the Android App Link mechanism is also triggered in parallel. That's why some files got chances to download sometimes.

automation-of-contagion-vigilance

It is possible to both track infectious agents and measure the effect on behavior with a Privacy by Design app.
The false positive problem is reduced because the proximity data is generated by the phones communicating directly with each other.
I published a paper showing how to deal with inapparent infection over twenty years ago:

Stodolsky, D. S. (1997). Automation of Contagion Vigilance. Methods of Information in Medicine, 36(3), 220-232.

https://sites.google.com/a/secureid.net/dss/automation-of-contagion-vigilance

A small study showed acceptability of the approach:

Stodolsky, D. S. & Zaharia, C. N. (2009). Acceptance of Virus Radar. The European Journal of ePractice, 8, 77-93. URL

https://drive.google.com/open?id=0B_zxYlTkSnKQZXFsXzNwSDd3ZGs

After a half a dozen attempts to get funding, I gave up on the idea of a contagion management test. After the #MeToo media explosion, I decided that I might pursue a test by focussing on the frontend of the design. A successful workshop led nowhere. I continue to seek an alternative strategy for funding this research.