GGitHub 趋势观察站
每日 07:00 更新
← 返回今日榜单

mahlernim /

google-timeline-visualizer

使用 Google 位置历史数据可视化个人年度旅行轨迹。

访问 GitHub 仓库 ↗
最近上榜 · 2026-08-23#12

当日排名

+441当日新增 Star2,648总 Star

Timeline Visualizer:把 Google Maps 时间轴导出变成可分享的旅行轨迹视频

一分钟看懂

Timeline Visualizer 读取 Google Maps 导出的 Timeline.json,按指定日期把旅行路线绘制为动态地图,并生成 MP4。Android 有原生 APK,iPhone/iPad 可直接使用网页应用;核心位置历史在设备或浏览器内处理,不上传给开发者。

你可以用它做什么

  • 制作某次旅行、某个月或整年的移动轨迹回顾。
  • 精确选择起止日期、距离单位、镜头运动、标题和视频时长。
  • 在生成前交互预览路线,再输出 10–300 秒的 MP4。
  • 在 Android 旅行日志中保留本地摘要,导入新版 Timeline 时补充细节。
  • 使用 Python 版本进行桌面端可视化或开发测试。

主要能力

Android 应用支持 Android 8.0+,从本地选择 Timeline 文件、发现已保存行程、生成月度/年度 recap 并分享视频。iPhone 网页版在 Safari 中完成解析和 H.264 编码,无需安装应用。地图瓦片来自基于 OpenStreetMap 数据的 CARTO;项目提供 Android、Web 和 Python 实现。相机、标题模板、时间范围与时长均可配置,生成前会准备地图瓦片。

适合哪些人

适合长期启用 Google Maps Timeline、想回顾旅行并注重位置文件不上传的人。没有 Timeline 记录或使用 Apple Maps 等其他格式的用户暂时无法直接使用。

怎么开始使用

先在手机系统或 Google Maps 设置中导出 Timeline.json。Android 用户从 GitHub 最新 Release 下载唯一的 APK 文件并手动安装;iPhone/iPad 用户在 Safari 打开官方网页应用,选择导出文件。选一个短日期范围测试预览和 MP4,再扩大到整月或全年。Safari 需 16.4+ 且支持 H.264,生成时保持标签页打开。

使用前需要知道

项目不能从 Google 账户或加密备份恢复缺失历史,只能可视化导出文件中已有数据。目前不支持 Apple Maps 等格式。完整 Timeline JSON 极其敏感,反馈问题时绝不能公开上传;分享成片前也要检查住宅、工作地点等隐私。位置文件虽不上传,但 CARTO 地图瓦片请求会暴露所查看的大致区域,托管网页还使用不含路线内容的聚合分析。Android APK 不在公开可搜索的 Google Play 中,应只从官方仓库下载。

官方资料