There are more and more COVID-19 cases in several countries. CDC of each country might release the trace of a confirmed case if CDC couldn’t identify the contact history. This project provides an online tool for users to compare their own trace with the traces of confirmed cases.

Nowadays, people can easily travel internationally. All countries have to work together to prevent the outbreak of diseases. We hope this project can become a system that helps everyone and every country in the world.

詳細作法 Detail Design

Google Maps 使用者如果開啟 Location History 功能，就可以在 Google Maps Timeline 頁面看到自己的歷史軌跡。使用者可以將自己的歷史軌跡和衛生單位公布的案例歷史軌跡互相比對，判斷自己和該案例接觸的可能性有多高。但這個過程十分的麻煩，如果案例數增加，使用者可能會放棄比對，或是用非常寬鬆的方式估計自己的風險，得到錯誤的結果（偽陽性或偽陰性都有可能）。

使用者可以從 Google Maps Timeline 下載自己某日的歷史軌跡（KML格式），可以使用程式幫忙比對使用者軌跡和案例軌跡是否有重疊。用程式來判斷的好處是，我們可以控制比較基準，判斷的結果會更一致。

專案以網站作為使用者介面，

使用者造訪網站時，網站會下載案例的軌跡到本地端。
網站會引導使用者到 Google Timeline 下載自己的歷史軌跡（儲存於本地端）。
使用者藉由 file selector 選擇想要比對的軌跡，瀏覽器會讀取這些軌跡，並和案例軌跡比對。此過程完全在本地端完成，使用者的軌跡不會被上傳到任何地方。
網站顯示比對結果，列出可能的接觸地點和時間。

因為衛生機關公布的案例軌跡大多十分模糊（相較於 Google Timeline 上的歷史軌跡），網站會提醒使用者需要進一步和官方資料確認自己的風險。

Google 另外提供了一個 Takeout 服務打包自己的資料，其中一項也有歷史軌跡檔(中文叫「定位記錄」，是 JSON 格式)。

If Location History is enabled on Google Map, users can find their location history on Google Timeline. Users can compare their history with the trace released by authorities, and they can estimate their likelihood of contacting a confirmed case. However, this is a tedious process, if there are a lot of cases, span through multiple days and multiple locations, the users might give up and/or determine their likelihood with some (random) heuristics. The result would be flaky, the rate of false positive and false negative will be high.

Users can download their own history from Google Timeline (in KML format). Technically, we can parse their KML file and compare the trace with the traces of confirmed cases. The benefit of doing the comparison by a program is, the quality of results would be consistent. We can control / estimate the rate of false positives and false negatives.

The project will be presented by a website.

When a user visits the website, the website downloads traces of confirmed cases and save locally.
The webpage guides the user to Google Timeline to download their location history of given days. The downloaded file is saved locally and is only saved locally.
The user uses a file selector on the website to select a list of their traces to compare. The webpage loads and parses the traces, and compares them with the traces of confirmed cases. During the process, user data is not uploaded to any server.
Finally, the webpage shows potential matches on the page, each match contains a time period and location.

Until now, the traces of confirmed cases released by authorities are very vague, compared to what KML can represent. The webpage would remind the user to double check with the data from the authority, so they can determine if there is really a risk.

Google also provides the Takeout service. The service allows you to download your location history, in JSON format.

預定使用者 Target Users

想要比對自己移動軌跡和確診病例移動軌跡的人。

People who want to compare their traces and traces of confirmed cases.

現有類似專案 Prior Works

目前沒有，歡迎幫忙補充

Not as we know of.

授權方式 License

Code: GPL-3.0

資料來源 Data Source

韓國資料來源 Data Source of Korea: https://coronamap.site

This website claims to be based on data released by Korean government.

台灣資料來源 Data Sourec of Taiwan:

以中央流行疫情指揮中心公布的資料為基礎
Based on data released by CDC.
案例32(Case No.32): 官方條列式的列出時間地點，由我們自行製作 Google My Maps
We converted the CDC announcement into Google My Maps format.

以色列資料來源 Data Source of Israel

We download the data from this link shared by Israel government.

專案目前狀態 Current State

已上線（見成果展示）

Released, please check the Website section.

Data

資料部分有台灣和韓國部分案例資料，請見資料來源。

Please check the Data Source section.

i18n

目前有中文、英文、韓文版本。語言選擇只會影響頁面呈現的效果，所有資料在所有語言中都可以使用。

台灣

有中文介面: 自行翻譯

歐美

有英文介面: 自行翻譯

韓文

有韓文介面: 使用 Google Translate 翻譯

希伯來文

利益揭露 Disclosure of Interests

（牽涉到哪些組織團體、有哪些已知的或潛在的金錢或物質或無形利益報酬）

就我們所知沒有......

Not as we know of...

徵求協作者 Collaboration

NeedsWriter: 需要文案幫手（撰寫基本資訊、報導專案etc）

目前各國疫情陸續爆發，如果有各國朋友願意翻譯和整理不同國家的資料也十分有幫助。

NeedsDesigner: 需要介面設計

NeedsData: 需要資料（擷取、清理）

Guide: How to use Google My Maps

NeedsTalkingToRealPerson: 需要有人幫忙和其他機關聯絡

如果可以讓各國政府在公布案例軌跡時，就使用 KML 的方式（類似鑽石公主號的例子，但是希望提高時間和路徑的精確度）會十分有幫助。

NeedsUserManual: 需要有人幫忙製作使用手冊，Troubleshooting FAQ。
NeedsTech: 需要技術支援（程式、架站 etc)

NeedsProcess: 需要幫忙設計作業流程

聯絡方式 Contact Us

Send to covid-19@googlegroups.com
Open an issue / pull request on Github

You will need to login with a Github account.

Slack: g0v-slack 串歡迎在上面留言，需要 slack 帳號
FB 粉專（若有新的軌跡上線會在粉絲專頁發布）
Follow us on FB (To get latest updates, e.g. new traces or new features)

Todo List

UX improvement

如果大家對 UX 有想法歡迎和我們討論。

UI improvement

目前的兩位工程師都是 UI 苦手，有大大願意幫忙重寫 UI 的話非常歡迎和我們討論你的想法。

Docs in different languages to work with different countries.

文件翻譯

成果展示 Website

https://pandemic.events