Skip to content

Location History Format

Collaborative format definition and documentation for Google Location History files.

Example of Location History data on a map.

Google (through its Takeout service) allows users to easily and conveniently download their Location History data. Unfortunately Google has not provided proper official documentation for these files, so it can sometimes be difficult to navigate the structure of the files and understand the meaning of its fields. This project attempts to fill that gap and do the job that Google should have done.


The goals of this project are two-fold:

  • Provide a standardized format definition describing the structure and contents of the files. These format definitions are given in the form of JSON schemas, which can be used, for example, for automatic validation of JSON files and to aid in the development of parsers. These files can be found in the schemas folder in the repository.

  • Provide accessible and user-friendly documentation for these formats. The documentation is presented in a public site ( which provides basic guides and reference pages detailing the structure and fields of the files. The reference pages are automatically built from the JSON schemas, presenting the information in a much more readable way.


This project is not affiliated, endorsed by, or in any way officially connected with Google. Official support for Google products can be found at

An effort is being made to keep the information provided by this project accurate and up-to-date, but due to its nature, the information provided might be inaccurate and/or out-of-date. Google has repeatedly made modifications to the format throughout the years.


Contributions are welcome! If you notice errors, out-of-date information, or missing information, you can help improve it. See Contributing.


This project is licensed under the terms of the MIT License.

Last update: 2024-03-24