🌎 Supported Formats and Export Guide

Google Maps Timeline guide

This app is centered on Google Maps Timeline. This page explains how to export your data and which location formats can be imported. The most reliable path is to export a ZIP from Google Takeout and load it here.

Back to near-miss analysis Prepare history first

Supported formats

  • Google Takeout JSON: Timeline data such as timelineObjects and Records.json can be loaded directly.
  • Google Takeout ZIP: JSON and GPX files inside the ZIP are detected automatically.
  • GPX: Reads <trkpt> and <wpt> points.
  • CSV: May work, but is not officially supported. It accepts column names around timestamp, lat, lon, and accuracy.
  • Apple export data: May work, but is not officially supported. Apple-derived JSON and CSV are converted into common location points.

Google Takeout JSON / Google Takeout ZIP / GPX are the safest choices. CSV and Apple export data may work, but are not officially supported.

Export from a browser

  1. Open Google Takeout in your browser.
  2. Select Location History or Google Maps Timeline data.
  3. Download the ZIP.
  4. Use the JSON or GPX inside the ZIP directly if needed.
  5. Load it into this app.

The most reliable method is to use the Google Takeout ZIP as-is.

Check from the Google Maps app

  1. Open the Google Maps app on Android or iPhone.
  2. Open Your Timeline from the profile icon in the top right.
  3. Check saving status and backup settings.
  4. Switch the date range if needed and confirm the target history exists.
  5. When exporting, open Google Takeout in a browser.

If it does not work

  • Check whether you are signed in with a different Google account.
  • If Google Maps Timeline looks empty, review backup settings and the target period.
  • A Google Takeout ZIP is usually the easiest file to use with this app.
  • If the ZIP contains JSON or GPX, it can be loaded directly.
  • CSV and Apple export data may work, but are not officially supported.