Timeline replay map
Your Google Maps Timeline, drawn as a city-level world map SVG for a profile README — a still map, a glowing route, or a spinning globe.
- Private by design
- City-level output
- Works offline
1 Pick your export
Timeline.json (Android), location-history.json
(iPhone), a Takeout .json, or the .zip the
Maps app saves. A places.json this tool produced works
too, so you can re-render without the original export. You can also
drop the file here.
Where is the export?
Android
- Open the phone's Settings app.
- Location → Location services → Timeline.
- Under “Timeline”, tap Export timeline data.
iPhone & iPad
- Open Google Maps → profile picture → Settings → Location & Privacy.
- Tap Export Timeline data.
- On the share sheet, Save to Files →
location-history.json.
Older Takeout archive
If your history predates the on-device move, Takeout may still
have Records.json, Location History.json
or Semantic Location History/.
Google publishes no link that opens the Timeline export screen directly — Android's system settings can't be opened from a web page and iOS has no settings URL — so these buttons open the right app or service and the steps above pick it up from there.
2 Preview and pick a look
Anonymizing keeps route order but replaces real years with fake days.
Used by the animated SVG, the GIF and the video.
3 Export an animation
Exports the flat map over the loop length set above.
Animated GIF
Long loops are large: a GIF repaints nearly every pixel per frame, so size grows with the loop length and fps. GIF cannot exceed 50 fps; for true 60 fps use the video export.
60 fps video
Records the selected map for the loop length above. WebM plays in browsers and chat apps; GitHub READMEs cannot embed it.
4 Download
Commit the SVGs to your profile repo. places.json is the
city-level data they were drawn from — useful to diff when your travel
changes, but not required by the SVGs.
Put it on your README
Paste this where the map should appear:
Downloads land in your phone's Files app. Use GitHub's upload page to add them to the repo, then edit README.md with the snippet above.
Open GitHub upload pageWhat is in the files
Every sample in the export is snapped to the nearest populated place in a bundled gazetteer. The output contains the gazetteer's city name, region, country, city-centre coordinates, visit counts and first/last year. Raw positions, addresses and place names/IDs never reach the files.
Using the app offline
Install it from your browser's menu (Add to Home Screen on a phone, Install app on desktop) and it opens like a native app, with no network needed after the first visit. When you publish new files, open the app and reload — the next load fetches the new version, and a banner offers a one-tap reload if an update lands while you are using it.