mahlernim / google-timeline-visualizer

Timeline Visualizer

Turn your Timeline file into an animated travel video on your Android phone. Choose exact dates, preview the Journey, and create an MP4 ready to watch or share. 将您的时间轴（Timeline）文件转换为 Android 手机上的动画旅行视频。您可以选择确切日期、预览行程，并创建可供观看或分享的 MP4 文件。

Use on iPhone

在 iPhone 上使用

Open the iPhone web app in Safari. There is no app to install and no Timeline file is uploaded. In Google Maps, open profile picture → Settings → Personal content → Export Timeline data and save Timeline.json in Files. Return to the web app and select Choose Timeline.json. Choose a month range or exact dates, select the camera movement, and confirm the map privacy notice. Preview the journey, then select Create MP4. Play, share, or download the finished video. 在 Safari 中打开 iPhone 网络应用。无需安装任何应用程序，也不会上传您的时间轴文件。在 Google 地图中，打开个人资料头像 → 设置 → 个人内容 → 导出时间轴数据，并将 Timeline.json 保存到“文件”中。返回网络应用并选择“选择 Timeline.json”。选择月份范围或确切日期，选择摄像机移动方式，并确认地图隐私声明。预览行程，然后选择“创建 MP4”。播放、分享或下载生成的视频。

MP4 creation requires Safari 16.4 or newer with H.264 encoding support. Keep the tab open while the video is being created. To keep the web app on the Home Screen, use Safari’s Share menu and choose Add to Home Screen. 创建 MP4 需要 Safari 16.4 或更高版本，并支持 H.264 编码。视频创建过程中请保持标签页打开。若要将网络应用保留在主屏幕上，请使用 Safari 的“共享”菜单并选择“添加到主屏幕”。

Install on Android

在 Android 上安装

The app is not yet on Google Play. Install it from this repository’s latest release: Under Assets, download the latest TimelineVisualizer-.apk file on your phone. Do not download the .sha256 checksum file. Open the downloaded file. If Android blocks the installation, select Settings, allow your browser or file manager to Install unknown apps, then return and try again. After installation, you can turn that permission off again. Only download the APK from this repository. 该应用尚未上架 Google Play。请从本仓库的最新发布版本安装：在 Assets 下，将最新的 TimelineVisualizer-.apk 文件下载到手机上。请勿下载 .sha256 校验文件。打开下载的文件。如果 Android 阻止安装，请选择“设置”，允许您的浏览器或文件管理器“安装未知应用”，然后返回并重试。安装完成后，您可以再次关闭该权限。请仅从本仓库下载 APK。

Android may display a warning because the app is installed outside Google Play. That warning is expected for a directly distributed APK. Future releases can be installed over this release. Requires Android 8.0 or newer. 由于该应用是在 Google Play 之外安装的，Android 可能会显示警告。对于直接分发的 APK，出现此警告是正常的。未来的版本可以直接覆盖安装。需要 Android 8.0 或更高版本。

Get your Timeline file

获取您的时间轴文件

On Android, the export is in the phone’s Settings app, not in Google Maps: Open Phone Settings. Select Location → Location services → Timeline. Select Export Timeline data, then Continue. Save Timeline.json somewhere easy to find, such as Downloads. See Google’s Timeline Help if the Timeline menu is missing or the labels differ on your phone. Names and menu locations can vary by phone. 在 Android 上，导出功能位于手机的“设置”应用中，而不是 Google 地图中：打开手机设置。选择“位置”→“位置服务”→“时间轴”。选择“导出时间轴数据”，然后点击“继续”。将 Timeline.json 保存到容易找到的地方，例如“下载”文件夹。如果您的手机上缺少“时间轴”菜单或标签不同，请参阅 Google 的时间轴帮助文档。不同手机的名称和菜单位置可能有所不同。

In Timeline Visualizer, Get Timeline file shows these instructions and can open Location settings for you. Android does not provide apps with a standard link directly to the Timeline page. On iPhone, the exported JSON can be used directly in the iPhone web app. It can also be moved to an Android phone and opened in the Android app. 在 Timeline Visualizer 中，“获取时间轴文件”会显示这些说明，并可为您打开位置设置。Android 不提供直接跳转到时间轴页面的标准链接。在 iPhone 上，导出的 JSON 文件可直接用于 iPhone 网络应用。它也可以移动到 Android 手机并在 Android 应用中打开。

Restore a missing Google Maps Timeline

恢复丢失的 Google 地图时间轴

If older trips disappeared after changing phones, reinstalling Google Maps, or resetting a device, an encrypted Timeline backup may be available in Google Maps. Use the app’s Restore Google Maps Timeline link or follow the restoration guide. Restore the history in Google Maps first, then export a new JSON file. Timeline Visualizer cannot access your Google account or encrypted backup and does not restore it directly. 如果您在更换手机、重新安装 Google 地图或重置设备后发现旧行程消失，Google 地图中可能存有加密的时间轴备份。请使用应用内的“恢复 Google 地图时间轴”链接或按照恢复指南操作。请先在 Google 地图中恢复历史记录，然后再导出新的 JSON 文件。Timeline Visualizer 无法访问您的 Google 账户或加密备份，也无法直接进行恢复。

创建并分享视频

Open Create video, select Choose file, and choose your Timeline file. Choose a month range or use Exact dates for a trip lasting only a few days. The latest full year is selected by default, and ranges may cross year boundaries. Confirm the name and title template, then choose a preset or a custom journey duration from 10 through 300 seconds. The template is saved for next time and supports {year} and {name}. Durations over 60 seconds show a rendering-time and storage reminder. 打开“创建视频”，选择“选择文件”，然后选择您的时间轴文件。选择月份范围，或者对于仅持续几天的行程使用“确切日期”。默认选择最近的完整年份，范围可以跨越年份。确认名称和标题模板，然后选择预设或 10 到 300 秒之间的自定义行程时长。模板会保存以供下次使用，并支持 {year} 和 {name} 变量。超过 60 秒的时长会显示渲染时间和存储空间提醒。

Select Preview to check the animated map. This is an interactive preview. The saved video uses the same design with map tiles prepared before rendering. Select Create video. On Android 10 and later, the app saves it automatically under Movies/Timeline Visualizer. Android 8 and 9 use the system Save As picker. The app shows each stage, an estimated time when enough progress has been measured, and a cancel button. You can switch apps or turn off the screen while it continues. 选择“预览”以查看动画地图。这是一个交互式预览。保存的视频使用与渲染前准备的地图瓦片相同的设计。选择“创建视频”。在 Android 10 及更高版本上，应用会自动将其保存在 Movies/Timeline Visualizer 目录下。Android 8 和 9 使用系统自带的“另存为”选择器。应用会显示每个阶段、测量到足够进度后的预计时间以及取消按钮。在视频生成过程中，您可以切换应用或关闭屏幕。

When the video is saved, watch or share it, use Save as to copy it elsewhere, optionally save or share the 1080 × 1080 Journey overview, or create another video. After a Timeline is loaded successfully, the app remembers its document reference and reopens it when New video opens and the storage provider retains access. It does not copy the Timeline data. If the file was moved or permission was lost, the app returns to the normal loading flow. 视频保存后，您可以观看或分享它，使用“另存为”将其复制到其他位置，或者选择保存/分享 1080 × 1080 的行程概览，也可以创建另一个视频。时间轴成功加载后，应用会记住其文档引用，并在打开“新建视频”时重新加载（前提是存储提供商保留了访问权限）。它不会复制时间轴数据。如果文件被移动或权限丢失，应用将返回正常的加载流程。

Older travel fades behind the moving marker so long, detailed Timelines remain clear and efficient to render. After the selected journey duration, the video adds a 1.5-second ending that zooms out, reveals the complete route, and holds the final overview for half a second. If you cancel, the app removes the incomplete output file. After a preview reaches the end, selecting Preview again starts it from the beginning. On Android 13 or newer, allow notifications to follow progress outside the app and receive a ready alert. Video creation continues even if you decline notification access. 较早的行程会在移动标记后逐渐淡出，因此长且详细的时间轴依然清晰且渲染高效。在选定的行程时长结束后，视频会增加 1.5 秒的结尾，进行缩小、显示完整路线，并保持最终概览半秒钟。如果您取消，应用会删除未完成的输出文件。预览结束后，再次选择“预览”将从头开始。在 Android 13 或更高版本上，请允许通知以在应用外跟踪进度并接收完成提醒。即使您拒绝通知权限，视频创建也会继续进行。

Keep your videos

管理您的视频

Completed videos are added to My videos automatically. Each entry keeps its thumbnail, title, Timeline period, duration, and creation date, with quick actions to watch or share it. Videos open in a full-screen player inside the app, with seeking, sharing, and an external-player fallback. Automatically created MP4 files remain in Movies/Timeline Visualizer. The app stores only a small local index and a deterministic thumbnail made from the final journey overview. 完成的视频会自动添加到“我的视频”中。每个条目都保留其缩略图、标题、时间轴周期、时长和创建日期，并提供观看或分享的快捷操作。视频在应用内的全屏播放器中打开，支持进度跳转、分享以及调用外部播放器。自动创建的 MP4 文件保留在 Movies/Timeline Visualizer 文件夹中。应用仅存储一个小的本地索引和从最终行程概览生成的确定性缩略图。

Use Add videos to include MP4s made before this library was introduced. You can select several videos at once. If a file is moved or deleted outside the app, its entry is marked File unavailable so you can remove it from the list. Remove from list leaves the MP4 untouched. Delete video is a separate, confirmed action that permanently deletes the file when its storage provider allows it. Delete all removes every available video after confirmation. The bottom navigation keeps My videos, Create video, and Settings easy to reach. 使用“添加视频”功能可以导入在此库引入之前制作的 MP4 文件。您可以一次选择多个视频。如果文件在应用外被移动或删除，其条目会被标记为“文件不可用”，以便您将其从列表中移除。“从列表中移除”不会影响 MP4 文件本身。“删除视频”是一个单独的确认操作，在存储提供商允许的情况下会永久删除文件。“全部删除”将在确认后移除所有可用视频。底部导航栏让“我的视频”、“创建视频”和“设置”触手可及。

Video settings

视频设置

Settings controls defaults for every new video. Steady camera and Balanced long-trip compression are the defaults. 设置控制每个新视频的默认选项。“稳定摄像机”和“平衡长途压缩”是默认设置。