mahlernim/google-timeline-visualizer

Visualize your year in travel using your Google Location History (Timeline) data

這是什麼

Timeline Visualizer 是一個把 Google Location History / Timeline JSON 轉成旅行動畫影片的工具，主軸不是再做一套定位紀錄，而是讓使用者把已匯出的 Timeline.json 在手機端讀入，選定月份、年份或精確日期後，預覽路線並輸出 MP4 旅行影片。Android 版以 Kotlin 開發，支援 Android 8.0 以上；iPhone 使用者則可透過 Safari 開啟網頁版，不需要安裝 App。README 特別強調資料處理邏輯：應用程式只讀取使用者選擇的 JSON 與影片檔，不要求 Google 登入、定位權限、帳號權限、分析追蹤或廣泛儲存權限；影片渲染也留在裝置上完成。換句話說，它把一份通常很難閱讀的時間軸資料，轉換成可分享、可收藏的視覺敘事。

為什麼上榜

這個專案今日拿到 1053 顆星、累積 2209 顆星，爆紅點很明確：它踩中了「Google Timeline 匯出後能做什麼」這個痛點。Google Maps 的時間軸資料對一般人來說有紀念價值，卻不容易直接觀看；Timeline Visualizer 把它包裝成手機上可操作的流程，包含日期範圍、鏡頭運動、影片長度、輸出比例、預覽與分享。它的差異也在於 README 對隱私邊界講得很清楚：Timeline JSON 不上傳，只有底圖會向 CARTO 請求地圖磚，並在第一次載入前提示。對同類「位置資料視覺化」工具而言，這種在地端渲染、少權限、可直接產生影片的產品感，是它容易被轉發的原因。

適合誰，可以拿來做什麼

它適合想回顧年度旅行、長途移動、搬家路線或特定假期的人，也適合想把位置紀錄整理成短片分享給家人朋友的使用者。上手門檻主要在於能否從 Google 匯出 Timeline.json：Android 的匯出入口在手機系統設定的 Location / Timeline 相關頁面，而不是 Google Maps；iPhone 則可從 Google Maps 的個人內容設定匯出後，在 Safari 網頁版選檔。README 也提到舊版 semanticSegments、直接陣列匯出、raw location fallback、活動與造訪點、跨國際換日線路線等格式支援，因此不只適合新資料，也可能用於較舊的時間軸備份。若你重視自主管理個人資料，它的 本機讀檔與本機輸出 設計會比把軌跡交給第三方服務更安心。

上手

Android 版尚未上架 Google Play，README 建議從 GitHub Releases 安裝 APK；iPhone 則直接使用 Safari 網頁版。核心流程如下：

# 桌面版仍可用原始 Python 產生器
python -m pip install -r requirements.txt
python visualizer.py --input Timeline.json --year 2025 --camera-movement steady \
  --long-trip-compression balanced --output my_trip_2025.mp4

手機使用時，先匯出 Timeline.json，再於 App 或網頁版選擇檔案、日期範圍、鏡頭移動與影片設定，預覽後按下 Create video。Android 10 以上會自動存到 Movies/Timeline Visualizer；Android 8/9 會使用系統另存流程。Safari 端建立 MP4 需要 Safari 16.4 以上 並支援 H.264 編碼，產生影片時也必須保持分頁開啟。

README 重點摘要

• 隱私設計清楚：不需要 Google 登入、定位權限或分析追蹤；Timeline JSON 不上傳，影片在裝置端渲染。
• 影片設定完整：支援穩定或動態鏡頭、長途壓縮、480p/720p/1080p、直式與橫式輸出，並可調整 10 到 300 秒的旅程長度。
• 資料格式相容性高：支援新舊 Timeline 匯出、paths、activities、visits、多種座標格式與跨國際換日線路線。
• 影片管理不只是輸出：完成的影片會進入 My videos，保留縮圖、標題、期間、長度與建立日期，可播放、分享、另存或刪除。
• 仍保留桌面 Python 版：需要 Python 3.9+、FFmpeg 與 requirements，可用命令列從 Timeline.json 直接產生 MP4。