google-timeline-visualizer：把谷歌地图足迹变成动画旅行大片，开源神器 2 千星爆火

最近 GitHub 上一个 Kotlin 项目悄悄火了——google-timeline-visualizer，一天之内涨了上千颗星。它的功能很简单却很有意思：把你手机里谷歌地图的时间轴（Timeline）位置历史数据，一键渲染成一部专属的动画旅行视频。

这是个什么项目？

简单说，它是一款把「位置历史数据」转成「动态旅行视频」的工具。谷歌地图会默默记录你的移动轨迹，形成一份 Timeline 位置历史。这个项目读取你导出的 Timeline.json 文件，然后在手机或网页上生成一段带有动画地图、移动轨迹标记的 MP4 视频——就像给自己过去一年做了一部旅行纪录短片。

项目完全开源（MIT 协议），支持 Android 应用和 iPhone 网页版两种用法，代码仓库有 2 千多 Star、260 多个 Fork，作者在过去几个月持续高强度更新，最近一次提交就在这两天。

核心功能

• 时间范围自由选择：可以按月份选，也可以精确到某几天，一段短期出差也能单独做成视频。
• 多语言界面：支持英文、韩文、日文、简体/繁体中文、西班牙语、法语等 9 种语言。
• 多种相机运镜：固定视角（Fixed）、稳定跟随（Steady）、动态跟随（Dynamic）三种镜头运动方式。
• 长途压缩优化：长距离飞行等稀疏轨迹沿大圆路径平滑插值，镜头不会生硬跳转。
• 多分辨率输出：480p/720p/1080p 方形，以及竖屏 1080×1920、横屏 1920×1080 预设。
• GPS 异常过滤：默认开启保守的离群点过滤，剔除孤立不合理坐标，且不改动原始 JSON 文件。
• 完整本地视频库：生成后的视频自动归入「我的视频」，带缩略图、时长、创建日期等索引。

技术特色

技术上也有不少亮点。项目原本是一个桌面 Python 生成器，后来演化为原生 Android App（Kotlin）+ iPhone 网页版。Android 端完全本地渲染，不用谷歌账号登录，不申请定位、存储等敏感权限，视频渲染全程在设备本地完成——隐私友好是它的一大卖点。底图用 CARTO 提供的 OpenStreetMap 瓦片，能兼容多种位置数据格式（字符串、latLng、度、geo:、E7 坐标等），甚至支持跨越国际日期变更线的轨迹。

使用步骤

第一步：导出你的 Timeline 文件

安卓手机：打开「设置 → 位置信息 → 位置服务 → 时间轴」，选择「导出时间轴数据」，保存 Timeline.json 文件（注意不在谷歌地图 App 里，而是在手机系统设置里）。

iPhone：打开谷歌地图，点击「头像 → 设置 → 个人内容 → 导出时间轴数据」，把 Timeline.json 存到文件里。

第二步：选择平台

Android 用户：从项目 Release 页下载最新的 TimelineVisualizer-*.apk（别下 .sha256 校验文件），安装时若系统拦截，允许「安装未知应用」即可。

iPhone 用户：直接用 Safari 打开网页版，无需安装，也无需上传文件。

第三步：生成视频

1. 打开「Create video」，选择导出的 Timeline 文件。
2. 选取时间范围（月份或精确日期），自定义视频标题模板（支持 {year}、{name}）。
3. 选择相机运镜、时长（10–300 秒）和输出分辨率。
4. 点「Preview」预览动画，确认后点「Create video」开始渲染。
5. 渲染完成后即可播放、分享，或导出成 MP4。

适用场景

• 年度旅行回顾：把一整年的足迹做成短片，发朋友圈或留作纪念。
• 出差/旅行记录：一次短期出行单独渲染，直观呈现路线。
• 隐私友好的选择：担心数据上传的用户，它全程本地处理，是相当安心的方案。
• 找回丢失的时间轴：项目还提供了「恢复谷歌地图时间轴」的指南，帮用户找回换机后丢失的轨迹。

总结

google-timeline-visualizer 是一款定位清晰、做得用心的工具：把冷冰冰的位置数据，变成能打动人的旅行视频。如果你平时用谷歌地图、又喜欢记录生活，这个项目值得一试。

项目地址：https://github.com/mahlernim/google-timeline-visualizer