+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Skip to content
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Contributing¶
+Open collaboration is fundamental for this project, a single person can't encounter and document all edge cases of the files. +Additionally, Google periodically updates the format and structure of the files without prior warning, +so updates to the format definitions will also be needed periodically but might be easy to miss.
+All source code, documentation files, and schemas can be found in the project's GitHub repository. +If you notice incorrect, out-of-date, or missing information, you can help by creating a new issue or creating a pull request.
+Note that Google's Location History data presents unique challenges that make spotting, formalizing, and accurately keeping track of the changes to the format significantly difficult. +In particular, there is no known versioning system for the file format (or other indirect versioning clues), +and changes to the format of the extracted files are usually not rolled out at the same time for all Google users.
+Improving the JSON Schemas¶
+All JSON schemas can be found in the schemas/ folder of the repository.
+Pull requests are welcome.
+Ideally contributors should be familiar with the structure of JSON Schema files.
All documented objects and properties should at least have the following fields:
+-
+
-
+
+title: +In most cases it is just a "humanized" version of the key.
+ -
+
+type: +One of"object","array","string","number","boolean","null".
+ -
+
+description: +Can make use of common basic Markdown syntax. +It can be an empty string if no information is known (in which case ahelpWantedfield should be present).
+
In addition to other basic JSON Schema fields, the following non-standard fields are also supported:
+-
+
-
+
+helpWanted: +Short description to inform that the information provided for this object/property is incomplete and help from the community is welcome. +Example:"The meaning of this field is uncertain. Are other values possible?"
+ -
+
+added: +Approximate date that this object/property was added to the format, if known. +Example:"around January 2022".
+ -
+
+removed: +Approximate date that this object/property was removed from the format, if known. +Example:"around January 2022".
+ -
+
+replacedBy: +For objects/properties that have been removed, the URI-reference of the new object/property that replaced it, if it applies. +Example:"#/$defs/locationRecord/properties/timestamp"
+
To convert the JSON Schema files to Markdown files (which are then used for the documentation site)
+a custom Python script is used (see tools/jsonschema_to_md/).
+
+Info
+Not all standard JSON Schema language features are supported when building the site +(and it is not in the scope of this project to build a complete JSON Schema to Markdown generator). +If you miss some JSON Schema feature in the Markdown generator create a new issue or a pull request.
+Improving the Guides¶
+To improve the documentation guides provided in this site modify the Markdown files found in the docs/guides/ folder and submit a pull request.
+Most common Markdown syntax is supported, plus additional syntax extensions provided by the Material for MkDocs theme.
Testing Locally¶
+In order to set-up a local environment to preview and test changes to the site first clone the GitHub repository, then:
+To install all requirements run:
+pip install -r requirements.txt
+To transform the JSON schemas in the schemas/ folder to Markdown files run:
make build
+
+
+Info
+The generated Markdown files are stored in the /docs/reference folder.
+Note that these dynamically generated Markdown files should not be included in the repository.
To start a local web server and view the site run:
+mkdocs serve
++
+
+
+ Last update:
+ 2024-03-24
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/css/extra.css b/css/extra.css
new file mode 100644
index 0000000..39b85d1
--- /dev/null
+++ b/css/extra.css
@@ -0,0 +1,314 @@
+.small {
+ font-size: .65rem;
+}
+
+.mt-0 {
+ margin-top: -14px;
+}
+
+.bold {
+ font-weight: 700!important;
+}
+
+.info-cell {
+ position: relative;
+ display: flex;
+ flex-direction: row;
+ align-items: center;
+ gap: 0;
+ padding: 0!important;
+}
+
+.info-block {
+ width: 100%;
+ display: flex;
+ flex-direction: column;
+ align-items: flex-start;
+ gap: 0.75em;
+ padding: 0.9375em 1.25em;
+}
+
+.info-icon {
+ color: #0008;
+ flex: 0 0 auto;
+ border: none;
+ box-shadow: none;
+ padding: 0.9375em 0 0.9375em 1.25em;
+}
+
+.info-color {
+ width: 0.25rem;
+ flex: 0 0 auto;
+ background-color: var(--md-accent-fg-color);
+}
+
+.mdx-added {
+ /* background-color: rgba(0,184,212,.1); */
+ color: #00b8d4;
+ font-size: .65rem;
+ font-weight: 400;
+}
+
+.mdx-removed {
+ /* background-color: rgba(0,184,212,.1); */
+ color: #ff5252;
+ font-size: .65rem;
+ font-weight: 400;
+}
+
+.mdx-help {
+ /* background-color: rgba(0,184,212,.1); */
+ color: #64dd17;
+ font-size: .65rem;
+ font-weight: 400;
+}
+
+.md-header--shadow, *[data-md-state=shadow] {
+ box-shadow: none!important;
+ /* box-shadow: 0 0 0.1rem rgb(0 0 0 / 10%), 0 0.1rem 0.1rem rgb(0 0 0 / 20%)!important; */
+ border-bottom: 0.05rem solid rgba(0,0,0,.07);
+}
+
+.md-grid {
+ max-width: 1200px;
+}
+
+.md-search__form {
+ height: 1.4rem;
+}
+
+.md-search__icon {
+ height: 1rem;
+ width: 1rem;
+}
+
+.md-footer__inner {
+ /* hide prev. next. section in footer */
+ display: none;
+}
+
+.md-content {
+ margin-bottom: 64px;
+}
+
+.md-typeset {
+ font-size: .7rem;
+}
+
+.md-typeset h1 {
+ color: var(--md-typeset-color);
+ font-size: 1.2rem;
+ font-weight: 400;
+}
+
+.md-typeset h2 {
+ font-size: 1rem;
+ font-weight: 400;
+}
+
+.md-typeset h3 {
+ font-size: 0.9rem;
+ font-weight: 400;
+}
+
+.md-typeset dd {
+ margin-top: 0.5em;
+}
+
+.md-typeset :is(.admonition-title,summary) {
+ font-size: .64rem!important;
+ padding-bottom: 0.2rem!important;
+ padding-top: 0.2rem!important;
+ padding-left: 1.6rem!important;
+}
+
+.md-typeset :is(.admonition-title,summary):before {
+ top: 0.425em!important;
+ height: .8rem!important;
+ left: 0.5rem!important;
+}
+
+.md-typeset :is(.admonition-title,summary):after {
+ top: 0.45em!important;
+ height: .8rem!important;
+ right: 0.2rem!important;
+}
+
+
+.md-header__title {
+ font-size: .8rem;
+}
+
+.md-header__source {
+ width: auto;
+}
+
+.md-source__icon svg {
+ margin-top: 0.7rem;
+}
+
+.md-source__repository {
+ width: 0;
+}
+
+.md-footer__title {
+ font-size: .7rem;
+}
+
+.md-footer__direction {
+ font-size: .7rem;
+}
+
+.md-nav__title {
+ font-size: .7rem;
+}
+
+.md-nav__item {
+ font-size: .65rem;
+}
+
+.md-copyright {
+ font-size: .65rem;
+}
+
+.md-search__input {
+ font-size: .65rem;
+}
+
+.md-typeset blockquote {
+ color: inherit;
+}
+
+.md-icon svg {
+ height: 1rem;
+ width: 1rem;
+}
+
+.md-search__icon[for=__search], .md-search__options {
+ top: 0.2rem;
+ opacity: 0.8;
+}
+
+table>thead>tr {
+ background-color: #e8eaed;
+}
+
+table>thead>tr>th {
+ padding: .5em 1.25em!important;
+}
+
+table td, table th {
+ min-width: 214px;
+ position: relative;
+}
+
+.definitions+* table>tbody>tr td:first-child {
+ font-weight: 700;
+ background-color: #f1f3f4;
+}
+
+.definitions+* table>tbody>tr td:first-child code {
+ background-color: unset;
+}
+
+.definitions+* table td:not(:first-child), table th:not(:first-child) {
+ width: 100%;
+}
+
+.definitions+* .md-typeset__table {
+ width: 100%;
+}
+
+table .bold code {
+ background-color: unset!important;
+ font-weight: 700!important;
+ font-size: 0.62rem!important;
+ padding: 0!important;
+ word-break: break-word!important;
+}
+
+table p {
+ padding: 0;
+}
+
+table tbody tr:hover {
+ background-color: inherit!important;
+}
+
+article img {
+ border: 1px solid #f0f0f0;
+ box-shadow: var(--md-shadow-z1);
+}
+
+
+/* sass
+@include break-to-device(mobile) {
+ article img:not(.info-icon) {
+ margin: 0 px2rem(-16px);
+ max-width: calc(100% + 32px)!important; / ** not needed if we could style parent p ** /
+ box-shadow: none;
+} */
+@media screen and (max-width: 719px) {
+ article img:not(.info-icon) {
+ margin: 0 -16px;
+ max-width: calc(100% + 32px)!important; /** not needed if we could style parent p **/
+ box-shadow: none;
+ }
+}
+
+
+[dir=ltr] .md-typeset blockquote {
+ border-left: 3px solid var(--md-default-fg-color--lighter);
+ /* background-color: #fafafa; */
+}
+
+ic-folder, ic-file {
+ background-color: var(--md-code-bg-color);
+ border-radius: 0.1rem;
+ font-size: .85em;
+ padding: 0 0.1em;
+ word-break: break-word;
+ font-feature-settings: "kern";
+ font-family: var(--md-code-font-family);
+}
+
+ic-folder {
+ font-weight: 700;
+}
+
+ic-folder::before, ic-file::before {
+ content: "";
+ display: inline-block;
+ width: 14px;
+ height: 14px;
+ background-repeat: no-repeat;
+ background-size: 100% 100%;
+ transform: translate(2px, 2px);
+ margin-right: 6px;
+ opacity: 0.7;
+}
+
+ic-folder::before {
+ background-image: url("../static/icons/folder.svg");
+}
+
+ic-file::before {
+ background-image: url("../static/icons/file.svg");
+}
+
+code ic-folder, code ic-file {
+ background-color: unset;
+ border-radius: unset;
+ padding: 0;
+ font-size: unset;
+}
+
+
+code ic-folder::before, code ic-file::before {
+ transform: translate(-2px, 2px);
+ margin-right: 4px;
+}
+
+:target{
+ background-color: #ff05!important;
+}
diff --git a/faq/index.html b/faq/index.html
new file mode 100644
index 0000000..ec9d111
--- /dev/null
+++ b/faq/index.html
@@ -0,0 +1,698 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Skip to content
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Frequently Asked Questions¶
+Does Google retain Location History data forever?¶
+You can configure a retention period in your Google account settings +by using the auto-delete setting. +With that said, even if you have disabled auto-deletion from the account settings it's been observed that after some undetermined amount of months Google might start dropping some attributes of your raw location history data. +Timestamps, latitudes and longitudes seem to always be conserved, but old values for other attributes such as altitude, speed, or heading, might be discarded without prior warning.
+You should therefore not rely on Google Location History data to be always available. +If you want to conserve all historic data consider periodically making extractions and backing them up or look for other alternative services.
+ + ++
+
+
+ Last update:
+ 2024-03-24
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/guides/downloading/index.html b/guides/downloading/index.html
new file mode 100644
index 0000000..460629e
--- /dev/null
+++ b/guides/downloading/index.html
@@ -0,0 +1,672 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Skip to content
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Downloading the Data¶
+To download your Location History data go to the Google Takeout page while logged in with your Google account.
+There, create a new export containing the Location History data +(note: make sure all other data sources are not selected).
+
In most cases a one-off download is enough, so, in the next screen choose Export Once, +and leave the other options at their default value +(the resulting file will almost certainly not exceed 2 GB).
+
After a few minutes your data should be ready to download. +You will also receive an email informing you about this and providing a link.
+
+
+
+
+ Last update:
+ 2024-03-24
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/guides/general-structure/index.html b/guides/general-structure/index.html
new file mode 100644
index 0000000..67e5c2d
--- /dev/null
+++ b/guides/general-structure/index.html
@@ -0,0 +1,701 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Skip to content
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ General Structure¶
+A typical Location History extraction from Google Takeout will look something like this:
+Takeout/
+├─ archive_browser.html
+└─ Location History/
+ ├─ Records.json
+ ├─ Settings.json
+ ├─ Timeline Edits.json
+ └─ Semantic Location History/
+ │ ...
+ ├─ 2020/
+ │ ├─ 2020_JANUARY.json
+ │ ├─ 2020_FEBRUARY.json
+ │ │ ...
+ │ └─ 2020_DECEMBER.json
+ └─ 2021/
+ ├─ 2021_JANUARY.json
+ ├─ 2021_FEBRUARY.json
+ │ ...
+ └─ 2021_DECEMBER.json
+
+
+Warning
+Folder names might be different for Google accounts in different languages.
+From here, the most relevant files and folders are:
+-
+
Records.json
+- This file contains all available raw Location History data. +See Raw Location History Data for more information. +
Settings.json
+- This file contains additional auxiliary metadata, like information about the devices used and account settings. +
-
+
Semantic Location History
+- This folder contains higher-level information about the user's inferred activity and movements. +There is one subfolder for each year of data, and inside each subfolder one file for each month. +See Semantic Location History Data for more information. +
+
+
+
+ Last update:
+ 2024-03-24
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/guides/raw-location/index.html b/guides/raw-location/index.html
new file mode 100644
index 0000000..601920d
--- /dev/null
+++ b/guides/raw-location/index.html
@@ -0,0 +1,692 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Skip to content
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Raw Location History Data¶
+Raw Location History data consists of a list of timestamped location records in chronological order for all the historical location data available and presumably at the most granular level possible.
+This raw Location History data is found in the Records.json file (see General Structure).
+Inside this file we can find a single flat locations array containing all of the location records:
Records.json
+{
+ "locations" : [...]
+}
+Each of the location records in this array has a very similar structure. +A location record might look like this:
+Example location record
+{
+ "timestamp": "2022-01-12T17:18:24.190Z",
+ "latitudeE7": 414216106,
+ "longitudeE7": 21684775,
+ "accuracy": 47,
+ "velocity": 0,
+ "heading": 188,
+ "altitude": 89,
+ "verticalAccuracy": 27,
+ "source": "WIFI",
+ "deviceTag": 1234567890,
+ "platformType": "ANDROID"
+}
+From this, the most essential fields are:
+-
+
timestamp: Timestamp of the record as a string in ISO 8601 format (YYYY-MM-DDTHH:mm:ss.sssZ). + The suffixedZindicates that the time is in the UTC time zone.
+latitudeE7andlongitudeE7: Coordinates (latitude and longitude) of the location reported as integers. + The values need to be divided by 107 to be in the expected range.
+
For more information on the other possible fields see the full format definition.
+ ++
+
+
+ Last update:
+ 2024-03-24
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/guides/semantic-location/index.html b/guides/semantic-location/index.html
new file mode 100644
index 0000000..f25da46
--- /dev/null
+++ b/guides/semantic-location/index.html
@@ -0,0 +1,728 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Skip to content
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Semantic Location History Data¶
+Semantic Location History data consists of more high-level and processed information compared to the raw Location History data. +This semantic information is the same information that can be seen in the Timeline pages on the Google Maps website and app. +Instead of individual raw location records, here the information is aggregated and summarized as a sequence of inferred (or manually set) +place visits and activity segments between place visits, all with a start time and an end time.
+
This semantic data can be found inside the Semantic Location History folder.
+The data is partitioned by year in different subfolders (named e.g. 2021, 2022...).
+And for each year, the data is partitioned again by month in different JSON files (named e.g. 2022_JANUARY.json, 2022_FEBRUARY.json etc.).
Inside each semantic JSON file we can find a single flat timelineObjects array:
+
Example semantic JSON file
+{
+ "timelineObjects" : [...]
+}
+Each of the timeline objects in this array is either an activitySegment or a placeVisit.
For more technical information see the full format definition.
+Activity Segments¶
+ + +Activity segments correspond to user activities involving changes in location, usually a journey from one place to another, +such as a walk, a car drive, a bus ride, or a flight.
+Activity segments contain, among other fields, a start location, an end location, a duration, a distance, and an inferred (or manually set) +activity type (walking, running, driving, ...). +A list of all known activity types can be found in the Activity Type section.
+Place Visits¶
+ + +Place visits correspond to a user visit or stay at a place in a fixed location for a duration of time, +such as a stay at home, at work, a visit to a shopping mall, or to a restaurant.
+Place visits contain, among other fields, a location and a duration.
+ ++
+
+
+ Last update:
+ 2024-03-24
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/index.html b/index.html
new file mode 100644
index 0000000..559c52c
--- /dev/null
+++ b/index.html
@@ -0,0 +1,740 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Skip to content
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Location History Format¶
+Collaborative format definition and documentation for Google Location History files.
+
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.
+Goals¶
+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 (locationhistoryformat.com) 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.
+
+
Disclaimer¶
+This project is not affiliated, endorsed by, or in any way officially connected with Google. +Official support for Google products can be found at https://support.google.com/.
+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.
+Contributing¶
+Contributions are welcome! +If you notice errors, out-of-date information, or missing information, you can help improve it. +See Contributing.
+License¶
+This project is licensed under the terms of the MIT License.
+ ++
+
+
+ Last update:
+ 2024-03-24
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/reference/index.html b/reference/index.html
new file mode 100644
index 0000000..45813e1
--- /dev/null
+++ b/reference/index.html
@@ -0,0 +1,659 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Skip to content
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Reference¶
+JSON Schema files can be found in the schemas folder in the repository.
+User-friendly documentation for these files is provided in the following pages:
+ + ++
+
+
+ Last update:
+ 2024-03-24
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/reference/records/index.html b/reference/records/index.html
new file mode 100644
index 0000000..ef560a4
--- /dev/null
+++ b/reference/records/index.html
@@ -0,0 +1,1237 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Skip to content
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Records.json Format Definition¶
+
+
+This page has been automatically generated from the schema Records.schema.json.
Records¶
+
+
+
+
+The Records.json file in a Google Takeout Location History extraction. Contains raw Location History information from the user's account.
| Property | +Description | +
|---|---|
locations[] |
+Locations array of: object (Location Record)List of all available location records, in chronological order. |
+
Location Record¶
+
+
+A specific location record. Contains the information obtained from a user's device at a specific moment in time and at a given location.
+
+
+
+
+
+Example
+{
+ "timestamp": "2022-01-12T17:18:24.190Z",
+ "latitudeE7": 414216106,
+ "longitudeE7": 21684775,
+ "accuracy": 20,
+ "velocity": 10,
+ "heading": 270,
+ "altitude": 150,
+ "verticalAccuracy": 10,
+ "source": "WIFI",
+ "deviceTag": 1234567890,
+ "platformType": "ANDROID"
+}
+| Property | +Description | +
|---|---|
accuracy |
+Accuracy integerExample: 20Approximate accuracy radius of the location measurement, in meters. A lower value means better precision. |
+
activeWifiScan |
+Active Wi-Fi Scan object (Wi-Fi Scan)Information about the access points found in a Wi-Fi scan done by the device and associated with this location record. |
+
activity[] |
+Activity array of: object (Activity Record)Detected activity information at this location, as a list of activity records at slightly different timestamps but all associated with this location record. |
+
altitude |
+Altitude integerExample: 150Altitude above the WGS84 reference ellipsoid, in meters. |
+
batteryCharging |
+Battery Charging booleanExample: trueWhether the device was charging its battery or not at the time of the record. |
+
deviceDesignation |
+Device Designation stringExample: "PRIMARY"Common values found are: PRIMARY, UNKNOWN. Help Wanted: The meaning of this field is uncertain. Are other values possible? Contributions to improve this are welcome. |
+
deviceTag |
+Device Tag integerExample: 1234567890Integer identifier (specific to Location History) associated with the device that uploaded the location. Refer to deviceSettings in Settings.json for information about the device with this deviceTag. |
+
deviceTimestamp |
+Device Timestamp string (date-time) Help Wanted: The meaning of this field is uncertain. Contributions to improve this are welcome. |
+
formFactor |
+Form Factor stringExample: "PHONE"Form factor (device type) from which the location record originated.Common values are: PHONE, TABLET. Help Wanted: What are other possible values? Contributions to improve this are welcome. |
+
heading |
+Heading integerExample: 270Heading in degrees east of true north, from 0 to 359. |
+
inferredLocation[] |
+Inferred Location array of: object (Location Record) Help Wanted: The meaning of this field is uncertain. Contributions to improve this are welcome. |
+
latitudeE7 |
+Latitude integerExample: 414216106WGS84 Latitude coordinate of the location. Degrees multiplied by 10^7 and rounded to the nearest integer, in the range -900000000 to +900000000 (divide value by 10^7 for the usual range -90° to +90°). |
+
locationMetadata[] |
+Location Metadata array of: object (Location Metadata)Additional location metadata. List of different Wi-Fi scans associated with this location record. |
+
longitudeE7 |
+Longitude integerExample: 21684775WGS84 Longitude coordinate of the location. Degrees multiplied by 10^7 and rounded to the nearest integer, in the range -1800000000 to +1800000000 (divide value by 10^7 for the usual range -180° to +180°). |
+
osLevel |
+OS Level integerExample: 28The version of the device's operating system that provided this record. In Android devices, this corresponds to the API Level (e.g. 28 is Android 9 Pie). |
+
placeId |
++ |
platformType |
+Platform Type stringExample: "ANDROID"Platform of the device that provided this record. Valid values are: ANDROID, IOS and UNKNOWN. |
+
serverTimestamp |
+Server Timestamp string (date-time) Help Wanted: The meaning of this field is uncertain. Contributions to improve this are welcome. |
+
source |
+Source stringExample: "WIFI"Source (technology) that provided the location information for this record.Common values are: WIFI, CELL, GPS, UNKNOWN (note: sometimes found in lowercase). |
+
timestamp |
+Timestamp string (date-time)Example: "2022-01-12T17:18:24.190Z" Added around January 2022. Timestamp (as an ISO 8601 string) of the record. |
+
timestampMs |
+Timestamp (Milliseconds) stringExample: "1636403752674" Removed around January 2022.Replaced by timestamp.Timestamp of the record as a Unix timestamp in milliseconds. |
+
velocity |
+Velocity integerExample: 10Measured velocity (ground speed) in meters per second. |
+
verticalAccuracy |
+Vertical Accuracy integerExample: 10Calculated accuracy of the location's altitude measurement, in meters. A lower value means better precision. |
+
Wi-Fi Scan¶
+
+
+Information about the access points found in a Wi-Fi scan done by the device.
+
+
+
+
+
+Example
+{
+ "accessPoints": [
+ {
+ "mac": "220676014124647",
+ "strength": -34,
+ "frequencyMhz": 2437
+ },
+ {
+ "mac": "220676014124646",
+ "strength": -47,
+ "frequencyMhz": 5180
+ },
+ {
+ "mac": "93672086150526",
+ "strength": -48,
+ "frequencyMhz": 2412
+ },
+ {
+ "mac": "251425092175323",
+ "strength": -81,
+ "frequencyMhz": 2412
+ }
+ ]
+}
+| Property | +Description | +
|---|---|
accessPoints[] |
++ |
Activity Record¶
+
+
+Activity information for a location at a given timestamp.
+
+
+
+
+
+Example
+{
+ "activity": [
+ {
+ "type": "ON_FOOT",
+ "confidence": 89
+ },
+ {
+ "type": "WALKING",
+ "confidence": 84
+ },
+ {
+ "type": "ON_BICYCLE",
+ "confidence": 5
+ },
+ {
+ "type": "IN_VEHICLE",
+ "confidence": 2
+ },
+ {
+ "type": "STILL",
+ "confidence": 1
+ },
+ {
+ "type": "UNKNOWN",
+ "confidence": 1
+ }
+ ],
+ "timestamp": "2022-02-12T15:10:56.751Z"
+}
+| Property | +Description | +
|---|---|
activity[] |
+Activity array of: object (Activity)List of candidate detected activities with their associated confidence. |
+
timestamp |
+Timestamp string (date-time)Example: "2022-01-12T17:18:24.190Z"Timestamp (as an ISO 8601 string) of the activity. |
+
Location Metadata¶
+
+
+
+
+Information about a Wi-Fi scan done by the device at a given timestamp.
+| Property | +Description | +
|---|---|
timestamp |
+Timestamp string (date-time)Example: "2022-01-12T17:18:24.190Z"Timestamp (as an ISO 8601 string) of the location metadata. |
+
wifiScan |
+Wi-Fi Scan object (Wi-Fi Scan)Information about the access points found in a Wi-Fi scan done by the device. |
+
Access Point¶
+
+
+Information about a specific wireless access point or router.
+
+
+
+
+
+Example
+{
+ "mac": "220676014124647",
+ "strength": -34,
+ "frequencyMhz": 2437
+}
+| Property | +Description | +
|---|---|
frequencyMhz |
+Frequency (MHz) integerExample: 2437Frequency of the signal (in MHz) that the access point is using. |
+
isConnected |
+Is Connected booleanExample: trueWhether the device that scanned the access point is connected to it. |
+
mac |
+MAC Address stringExample: "220676014124647"MAC address of the access point as an integer. MAC addresses typically consist of 48 bits (6 bytes), so it is likely the value found here needs to be interpreted as a 6 byte integer (which when converted to its hexadecimal representation results in a more typical representation for MAC addresses). |
+
strength |
+Strength integerExample: -34Strength of the signal in dBm (decibels per milliwatt) of the access point. |
+
Activity¶
+
+
+A detected activity with an associated confidence. Descriptions partially based on: https://developers.google.com/android/reference/com/google/android/gms/location/DetectedActivity
+
+
+
+
+
+Example
+{
+ "type": "ON_FOOT",
+ "confidence": 89
+}
+| Property | +Description | +
|---|---|
confidence |
+Confidence integerExample: 100Value from 0 to 100 indicating the likelihood that the user is performing this activity.The larger the value, the more consistent the data used to perform the classification is with the detected activity. Multiple activities may have high confidence values. For example, the ON_FOOT may have a confidence of 100 while the RUNNING activity may have a confidence of 95. The sum of the confidences of all detected activities for a classification does not have to be <= 100 since some activities are not mutually exclusive (for example, you can be walking while in a bus) and some activities are hierarchical (ON_FOOT is a generalization of WALKING and RUNNING). |
+
extra |
+Extra Activity Information object (Extra Activity Information)Generic object containing extra information about an activity, in the form of a property with a type, a name, and a value. So far only the property with name vehicle_personal_confidence has been encountered. |
+
type |
++ |
Extra Activity Information¶
+
+
+Generic object containing extra information about an activity, in the form of a property with a type, a name, and a value. So far only the property with name vehicle_personal_confidence has been encountered.
+
+
+
+
+Example
+{
+ "type": "VALUE",
+ "name": "vehicle_personal_confidence",
+ "intVal": 100
+}
+| Property | +Description | +
|---|---|
intVal |
+Integer Value integerExample: 100Integer value of the property. |
+
name |
+Name stringExample: "vehicle_personal_confidence"Name of the property. |
+
type |
+Type stringExample: "VALUE"Type of the property. |
+
Activity Type¶
+
+
+
+
+
+Type of activity detected, such as WALKING or ON_BICYCLE. Some activity types are hierarchical, for example, WALKING is a subtype of ON_FOOT, and in particular, the following activity type hierarchy is known:
- EXITING_VEHICLE
+- IN_VEHICLE
+- ├─ IN_RAIL_VEHICLE
+- └─ IN_ROAD_VEHICLE
+- ├─ IN_FOUR_WHEELER_VEHICLE
+- │ ├─ IN_BUS
+- │ └─ IN_CAR
+- └─ IN_TWO_WHEELER_VEHICLE
+- ON_BICYCLE
+- ON_FOOT
+- ├─ RUNNING
+- └─ WALKING
+- STILL
+- TILTING
+- UNKNOWN
+Descriptions partially based on: https://developers.google.com/android/reference/com/google/android/gms/location/DetectedActivity
+| Activity Type | +Description | +
|---|---|
EXITING_VEHICLE |
+Exiting Vehicle The device is exiting a vehicle. |
+
IN_BUS |
+In Bus The device is in a bus. |
+
IN_CAR |
+In Car The device is in a car. |
+
IN_FOUR_WHEELER_VEHICLE |
+In Four-Wheeler Vehicle The device is in a four-wheeler vehicle. |
+
IN_RAIL_VEHICLE |
+In Rail Vehicle The device is in a rail vehicle. |
+
IN_ROAD_VEHICLE |
+In Road Vehicle The device is in a road vehicle. |
+
IN_TWO_WHEELER_VEHICLE |
+In Two-Wheeler Vehicle The device is in a two-wheeler vehicle. |
+
IN_VEHICLE |
+In Vehicle The device is in a vehicle, such as a car. |
+
ON_BICYCLE |
+On Bicycle The device is on a bicycle. |
+
ON_FOOT |
+On Foot The device is on a user who is walking or running. |
+
RUNNING |
+Running The device is on a user who is running. |
+
STILL |
+Still The device is still (not moving). |
+
TILTING |
+Tilting The device angle relative to gravity changed significantly. This often occurs when a device is picked up from a desk or a user who is sitting stands up. |
+
UNKNOWN |
+Unknown Unable to detect the current activity. |
+
WALKING |
+Walking The device is on a user who is walking. |
+
+
+
+
+ Last update:
+ 2024-03-24
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/reference/semantic/index.html b/reference/semantic/index.html
new file mode 100644
index 0000000..4e0d43a
--- /dev/null
+++ b/reference/semantic/index.html
@@ -0,0 +1,2286 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Skip to content
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Semantic Location History Format Definition¶
+
+
+This page has been automatically generated from the schema Semantic.schema.json.
Semantic Location History¶
+
+
+
+
+A Semantic Location History JSON file in a Google Takeout Location History extraction. Contains Semantic Location History information from the user's account. Typically this will be a file containing data for a single month, with a name such as 2021_JANUARY.json.
| Property | +Description | +
|---|---|
timelineObjects[] |
+Timeline Objects array of: object (Timeline Object)List of all available semantic information, in chronological order. Each item in the list is either an Activity Segment or a Place Visit, encapsulated in a generic Timeline Object. |
+
Timeline Object¶
+
+
+
+
+Encapsulates either an Activity Segment or a Place Visit, depending on the single key found.
+| Single Property | +Description | +
|---|---|
activitySegment |
+Activity Segment object (Activity Segment)An activity involving changes in location, usually a journey from one place to another, such as a walk, a car drive, a bus ride, or a flight. |
+
placeVisit |
+Place Visit object (Place Visit)A visit or stay at a place in a fixed location for a duration of time, such as a stay at home, at work, a visit to a shopping mall, or to a restaurant. |
+
Activity Segment¶
+
+
+An activity involving changes in location, usually a journey from one place to another, such as a walk, a car drive, a bus ride, or a flight.
+
+
+
+
+
+Example
+{
+ "activitySegment": {
+ "startLocation": {
+ "latitudeE7": 414083590,
+ "longitudeE7": 21704229,
+ "sourceInfo": {
+ "deviceTag": 1114211210
+ }
+ },
+ "endLocation": {
+ "latitudeE7": 413961889,
+ "longitudeE7": 21536695,
+ "sourceInfo": {
+ "deviceTag": 1114211210
+ }
+ },
+ "duration": {
+ "startTimestamp": "2022-03-03T12:22:24Z",
+ "endTimestamp": "2022-03-03T12:43:34Z"
+ },
+ "distance": 2640,
+ "activityType": "IN_BUS",
+ "confidence": "HIGH",
+ "activities": [
+ {
+ "activityType": "IN_BUS",
+ "probability": 85.6847882270813
+ },
+ {
+ "activityType": "WALKING",
+ "probability": 8.418431878089905
+ },
+ {
+ "activityType": "IN_PASSENGER_VEHICLE",
+ "probability": 2.8303226456046104
+ },
+ {
+ "activityType": "STILL",
+ "probability": 1.7383299767971039
+ },
+ {
+ "activityType": "IN_SUBWAY",
+ "probability": 0.4673520103096962
+ },
+ {
+ "activityType": "IN_TRAIN",
+ "probability": 0.3031305968761444
+ },
+ {
+ "activityType": "IN_TRAM",
+ "probability": 0.269505986943841
+ },
+ {
+ "activityType": "CYCLING",
+ "probability": 0.1483310479670763
+ }
+ ],
+ "transitPath": {
+ "transitStops": [
+ {
+ "latitudeE7": 414083140,
+ "longitudeE7": 21704000,
+ "placeId": "ChIJWey1zMWipBIRiNQSzpI4EDQ",
+ "address": "08025 Barcelona\nEspa\u00f1a",
+ "name": "Sant Antoni Maria Claret-Lepant"
+ },
+ {
+ "latitudeE7": 414066427,
+ "longitudeE7": 21681608,
+ "placeId": "ChIJ3Wr_xsaipBIRctQDPNF0IHM",
+ "address": "08025 Barcelona\nEspa\u00f1a",
+ "name": "Sant Antoni Maria Claret - Sardenya"
+ },
+ {
+ "latitudeE7": 414049343,
+ "longitudeE7": 21659001,
+ "placeId": "ChIJh2lnv8CipBIRpH0ym2Bxo68",
+ "address": "08025 Barcelona\nEspa\u00f1a",
+ "name": "Sant Antoni Maria Claret - N\u00e0pols"
+ }
+ ],
+ "name": "H8",
+ "hexRgbColor": "009EE0",
+ "linePlaceId": "ChIJQVEUoLuipBIRJO37wI4yyBs",
+ "stopTimesInfo": [
+ {
+ "scheduledDepartureTimestamp": "2022-03-03T12:42:00Z",
+ "realtimeDepartureTimestamp": "2022-03-03T12:43:37Z"
+ },
+ {
+ "scheduleArrivalTimestamp": "2022-03-03T12:44:01Z",
+ "scheduledDepartureTimestamp": "2022-03-03T12:44:01Z",
+ "realtimeArrivalTimestamp": "2022-03-03T12:45:38Z",
+ "realtimeDepartureTimestamp": "2022-03-03T12:45:38Z"
+ },
+ {
+ "scheduleArrivalTimestamp": "2022-03-03T12:46:03Z",
+ "scheduledDepartureTimestamp": "2022-03-03T12:46:03Z",
+ "realtimeArrivalTimestamp": "2022-03-03T12:47:40Z",
+ "realtimeDepartureTimestamp": "2022-03-03T12:47:40Z"
+ },
+ {
+ "scheduleArrivalTimestamp": "2022-03-03T12:48:00Z",
+ "scheduledDepartureTimestamp": "2022-03-03T12:48:00Z",
+ "realtimeArrivalTimestamp": "2022-03-03T12:49:37Z",
+ "realtimeDepartureTimestamp": "2022-03-03T12:49:37Z"
+ }
+ ],
+ "source": "INFERRED",
+ "confidence": 0.9155850640140931,
+ "distanceMeters": 2341.0
+ },
+ "simplifiedRawPath": {
+ "points": [
+ {
+ "latE7": 414032766,
+ "lngE7": 21641819,
+ "accuracyMeters": 10,
+ "timestamp": "2022-03-03T12:27:48Z"
+ },
+ {
+ "latE7": 414016705,
+ "lngE7": 21661614,
+ "accuracyMeters": 13,
+ "timestamp": "2022-03-03T12:30:04Z"
+ },
+ {
+ "latE7": 413986545,
+ "lngE7": 21623960,
+ "accuracyMeters": 12,
+ "timestamp": "2022-03-03T12:33:51Z"
+ },
+ {
+ "latE7": 413976870,
+ "lngE7": 21610201,
+ "accuracyMeters": 11,
+ "timestamp": "2022-03-03T12:37:09Z"
+ },
+ {
+ "latE7": 413968976,
+ "lngE7": 21609892,
+ "accuracyMeters": 13,
+ "timestamp": "2022-03-03T12:38:50Z"
+ },
+ {
+ "latE7": 413955345,
+ "lngE7": 21551848,
+ "accuracyMeters": 11,
+ "timestamp": "2022-03-03T12:42:06Z"
+ }
+ ],
+ "source": "INFERRED",
+ "distanceMeters": 2413.400132766728
+ }
+ }
+}
+| Property | +Description | +
|---|---|
activities[] |
+Activities array of: object (Activity)List of all the considered candidate activity types and their probabilities. The sum of all the probabilities is always <= 100. |
+
activityType |
+Activity Type string (Activity Type)Example: "WALKING"Best match activity type. Corresponds to the activity type with the highest probability in activities. |
+
confidence |
+Confidence stringExample: "HIGH"Confidence that the chosen activity type (see activityType) is correct. One of: LOW, MEDIUM, HIGH or UNKNOWN_CONFIDENCE. Activities that have been manually confirmed always have a confidence of HIGH. |
+
distance |
+Distance integerExample: 292Distance traveled during the activity, in meters. |
+
duration |
++ |
editActionMetadata |
+Edit-Action Metadata object (Edit-Action Metadata) |
+
editConfirmationStatus |
+Edit-Confirmation Status stringExample: "CONFIRMED"Whether the user has manually edited the activity segment. Can be NOT_CONFIRMED or CONFIRMED. |
+
endLocation |
++ |
lastEditedTimestamp |
+Last-Edited Timestamp string (date-time)Example: "2022-03-06T14:13:11.092Z" |
+
parkingEvent |
+Parking Event object (Parking Event) |
+
simplifiedRawPath |
+Simplified Raw Path object (Simplified Raw Path) |
+
startLocation |
++ |
transitPath |
++ |
waypointPath |
+Waypoint Path object (Waypoint Path) |
+
Place Visit¶
+
+
+
+
+A visit or stay at a place in a fixed location for a duration of time, such as a stay at home, at work, a visit to a shopping mall, or to a restaurant.
+| Property | +Description | +
|---|---|
centerLatE7 |
+Center Latitude integerExample: 414216106Latitude coordinate of the location. Degrees multiplied by 10^7 and rounded to the nearest integer, in the range -900000000 to +900000000 (divide value by 10^7 for the usual range -90° to +90°). |
+
centerLngE7 |
+Center Longitude integerExample: 21684775Longitude coordinate of the location. Degrees multiplied by 10^7 and rounded to the nearest integer, in the range -1800000000 to +1800000000 (divide value by 10^7 for the usual range -180° to +180°). |
+
checkin |
+Checkin object (Checkin) Help Wanted: The meaning of this field is uncertain. Contributions to improve this are welcome. |
+
childVisits[] |
+Child Visits array of: object (Place Visit) |
+
duration |
++ |
editActionMetadata |
+Edit-Action Metadata object (Edit-Action Metadata) |
+
editConfirmationStatus |
+Edit-Confirmation Status stringExample: "CONFIRMED"Whether the user has manually edited the place visit. Can be NOT_CONFIRMED or CONFIRMED. |
+
lastEditedTimestamp |
+Last-Edited Timestamp string (date-time)Example: "2022-03-06T14:13:11.092Z" |
+
location |
++ |
locationAssertionType |
+Location Assertion Type stringExample: "AREA" |
+
locationConfidence |
+Visit Confidence integerExample: 71 |
+
otherCandidateLocations[] |
+Other Candidate Locations array of: object (Location) |
+
placeConfidence |
+Place Confidence stringExample: "HIGH"Categorized confidence for this place visit. One of: LOW_CONFIDENCE, MEDIUM_CONFIDENCE, HIGH_CONFIDENCE or USER_CONFIRMED. Help Wanted: Is this directly related to locationConfidence and/or visitConfidence Contributions to improve this are welcome. |
+
placeVisitImportance |
+Place Visit Importance stringExample: "MAIN"One of MAIN or TRANSITIONAL. |
+
placeVisitLevel |
+Place Visit Level integerExample: 1Level (depth) of this place visit. This value increases by 1 with each recursive access to a childVisits entry. |
+
placeVisitType |
+Place Visit Type stringExample: "SINGLE_PLACE"Can be SINGLE_PLACE. Help Wanted: Are there other valid values? Contributions to improve this are welcome. |
+
sectionId |
+Section ID string |
+
simplifiedRawPath |
+Simplified Raw Path object (Simplified Raw Path) |
+
visitConfidence |
+Visit Confidence integerExample: 95 Help Wanted: How is this different from locationConfidence Contributions to improve this are welcome. |
+
Activity¶
+
+
+
+
+
+Example
+{
+ "activityType": "WALKING",
+ "probability": 95.93904614448547
+}
+| Property | +Description | +
|---|---|
activityType |
++ |
probability |
+Probability numberExample: 95.93904614448547Probability (or confidence) that the activity type is correct, in the range 0 to 100. |
+
Activity Type¶
+ + +| Activity Type | +Description | +
|---|---|
BOATING |
+ Boating |
+
CATCHING_POKEMON |
+ Catching Pokémon |
+
CYCLING |
+ Cycling |
+
FLYING |
+ Flying |
+
HIKING |
+ Hiking |
+
HORSEBACK_RIDING |
+ Horseback riding |
+
IN_BUS |
+ On a bus |
+
IN_CABLECAR |
+In a cable car |
+
IN_FERRY |
+On a ferry |
+
IN_FUNICULAR |
+On a funicular |
+
IN_GONDOLA_LIFT |
+In a gondola lift |
+
IN_PASSENGER_VEHICLE |
+ Driving |
+
IN_SUBWAY |
+ On the subway |
+
IN_TAXI |
+ In a taxi |
+
IN_TRAIN |
+ On a train |
+
IN_TRAM |
+ On a tram |
+
IN_VEHICLE |
+In a vehicle |
+
IN_WHEELCHAIR |
+ By wheelchair |
+
KAYAKING |
+ Kayaking |
+
KITESURFING |
+ Kitesurfing |
+
MOTORCYCLING |
+ Motorcycling |
+
PARAGLIDING |
+ Paragliding |
+
ROWING |
+ Rowing |
+
RUNNING |
+ Running |
+
SAILING |
+ Sailing |
+
SKATEBOARDING |
+ Skateboarding |
+
SKATING |
+ Skating |
+
SKIING |
+ Skiing |
+
SLEDDING |
+ Sledding |
+
SNOWBOARDING |
+ Snowboarding |
+
SNOWMOBILE |
+ Snowmobiling |
+
SNOWSHOEING |
+ Snowshoeing |
+
STILL |
+ Still |
+
SURFING |
+ Surfing |
+
SWIMMING |
+ Swimming |
+
UNKNOWN_ACTIVITY_TYPE |
+Moving |
+
WALKING |
+ Walking |
+
WALKING_NORDIC |
+ Nordic walking |
+
Duration¶
+
+
+Duration of time defined by a start timestamp and an end timestamp.
+
+
+
+
+
+Example
+{
+ "startTimestamp": "2022-02-02T10:41:08.315Z",
+ "endTimestamp": "2022-02-02T10:45:09.962Z"
+}
+| Property | +Description | +
|---|---|
endTimestamp |
+End Timestamp string (date-time)Example: "2022-02-02T10:45:09.962Z" |
+
startTimestamp |
+Start Timestamp string (date-time)Example: "2022-02-02T10:41:08.315Z" |
+
Edit-Action Metadata¶
+ + +| Property | +Description | +
|---|---|
activitySegment |
+Activity Segment object (Activity Segment) |
+
editHistory |
+Edit History object (Edit History) |
+
originalCandidates |
+Original Candidates object (Original Candidates) |
+
placeVisitSegment |
+Place Visit Segment object (Place Visit Segment) |
+
Location¶
+
+
+
+
+
+Example
+{
+ "latitudeE7": 414036299,
+ "longitudeE7": 21743558,
+ "placeId": "ChIJk_s92NyipBIRUMnDG8Kq2Js",
+ "address": "C/ de Mallorca, 401\n08013 Barcelona\nEspanya",
+ "name": "La Sagrada Familia",
+ "semanticType": "TYPE_SEARCHED_ADDRESS",
+ "sourceInfo": {
+ "deviceTag": 1234567890
+ },
+ "locationConfidence": 87.07311,
+ "calibratedProbability": 76.20023
+}
+| Property | +Description | +
|---|---|
accuracyMetres |
+Accuracy in meters integerExample: 19Approximate accuracy radius of the location measurement, in meters. A lower value means better precision. |
+
address |
+Address stringExample: "C/ de Mallorca, 401\n08013 Barcelona\nEspanya"Address of the location. |
+
calibratedProbability |
+Calibrated Probability numberExample: 100.0 |
+
isCurrentLocation |
+Is Current Location booleanExample: true |
+
latitudeE7 |
+Latitude integerExample: 414216106Latitude coordinate of the location. Degrees multiplied by 10^7 and rounded to the nearest integer, in the range -900000000 to +900000000 (divide value by 10^7 for the usual range -90° to +90°). |
+
locationConfidence |
+Location Confidence numberExample: 100.0 |
+
longitudeE7 |
+Longitude integerExample: 21684775Longitude coordinate of the location. Degrees multiplied by 10^7 and rounded to the nearest integer, in the range -1800000000 to +1800000000 (divide value by 10^7 for the usual range -180° to +180°). |
+
name |
+Name stringExample: "La Sagrada Familia"Name of the location. |
+
placeId |
++ |
semanticType |
+Semantic Type string (Semantic Type)Example: "TYPE_HOME"Place type based on semantic information specific to the user. |
+
sourceInfo |
++ |
Parking Event¶
+
+
+
+
+
+Example
+{
+ "location": {
+ "latitudeE7": 412518975,
+ "longitudeE7": 21683133,
+ "accuracyMetres": 19
+ },
+ "method": "EXITING_VEHICLE_SIGNAL",
+ "locationSource": "FROM_RAW_LOCATION",
+ "timestamp": "2022-02-27T14:47:16.731Z"
+}
+| Property | +Description | +
|---|---|
location |
+Location object (Location) |
+
locationSource |
+Location Source stringExample: "FROM_RAW_LOCATION" |
+
method |
+Method stringExample: "EXITING_VEHICLE_SIGNAL" |
+
timestamp |
+Timestamp string (date-time)Example: "2022-02-27T14:47:16.731Z" |
+
Simplified Raw Path¶
+
+
+
+
+
+Example
+{
+ "points": [
+ {
+ "latE7": 416032766,
+ "lngE7": 21841819,
+ "accuracyMeters": 10,
+ "timestamp": "2022-03-03T08:27:48Z"
+ },
+ {
+ "latE7": 416016705,
+ "lngE7": 21861614,
+ "accuracyMeters": 13,
+ "timestamp": "2022-03-03T08:30:04Z"
+ },
+ {
+ "latE7": 415986545,
+ "lngE7": 21823960,
+ "accuracyMeters": 12,
+ "timestamp": "2022-03-03T08:33:51Z"
+ }
+ ],
+ "source": "INFERRED",
+ "distanceMeters": 2413.400132766728
+}
+| Property | +Description | +
|---|---|
distanceMeters |
+Distance in meters numberExample: 2413.400132766728Distance traveled with the path, in meters. |
+
points[] |
++ |
source |
+Source stringExample: "INFERRED"Source of the location data of the path. One of BACKFILLED, INFERRED, or RESNAPPED_FOR_EDIT. |
+
Transit Path¶
+
+
+A path taken in a public transit system, such as a bus or a metro. Note that it does not describe an entire transit line, but only a specific journey a user does in a transit line.
+
+
+
+
+
+Example
+{
+ "transitStops": [
+ {
+ "latitudeE7": 414083140,
+ "longitudeE7": 21704000,
+ "placeId": "ChIJWey1zMWipBIRiNQSzpI4EDQ",
+ "address": "08025 Barcelona\nEspa\u00f1a",
+ "name": "Sant Antoni Maria Claret-Lepant"
+ },
+ {
+ "latitudeE7": 414066427,
+ "longitudeE7": 21681608,
+ "placeId": "ChIJ3Wr_xsaipBIRctQDPNF0IHM",
+ "address": "08025 Barcelona\nEspa\u00f1a",
+ "name": "Sant Antoni Maria Claret - Sardenya"
+ },
+ {
+ "latitudeE7": 414049343,
+ "longitudeE7": 21659001,
+ "placeId": "ChIJh2lnv8CipBIRpH0ym2Bxo68",
+ "address": "08025 Barcelona\nEspa\u00f1a",
+ "name": "Sant Antoni Maria Claret - N\u00e0pols"
+ }
+ ],
+ "name": "H8",
+ "hexRgbColor": "009EE0",
+ "linePlaceId": "ChIJQVEUoLuipBIRJO37wI4yyBs",
+ "stopTimesInfo": [
+ {
+ "scheduledDepartureTimestamp": "2022-03-03T12:42:00Z",
+ "realtimeDepartureTimestamp": "2022-03-03T12:43:37Z"
+ },
+ {
+ "scheduleArrivalTimestamp": "2022-03-03T12:44:01Z",
+ "scheduledDepartureTimestamp": "2022-03-03T12:44:01Z",
+ "realtimeArrivalTimestamp": "2022-03-03T12:45:38Z",
+ "realtimeDepartureTimestamp": "2022-03-03T12:45:38Z"
+ },
+ {
+ "scheduleArrivalTimestamp": "2022-03-03T12:46:03Z",
+ "scheduledDepartureTimestamp": "2022-03-03T12:46:03Z",
+ "realtimeArrivalTimestamp": "2022-03-03T12:47:40Z",
+ "realtimeDepartureTimestamp": "2022-03-03T12:47:40Z"
+ },
+ {
+ "scheduleArrivalTimestamp": "2022-03-03T12:48:00Z",
+ "scheduledDepartureTimestamp": "2022-03-03T12:48:00Z",
+ "realtimeArrivalTimestamp": "2022-03-03T12:49:37Z",
+ "realtimeDepartureTimestamp": "2022-03-03T12:49:37Z"
+ }
+ ],
+ "source": "INFERRED",
+ "confidence": 0.9155850640140931,
+ "distanceMeters": 2341.0
+}
+| Property | +Description | +
|---|---|
confidence |
+Confidence numberExample: 0.9155850640140931 |
+
distanceMeters |
+Distance in meters numberExample: 396.34176716755843Distance traveled with the transit path, in meters. |
+
hexRgbColor |
+Hexadecimal RGB Color stringExample: "009EE0"Color of the transit line in hexadecimal in the form RRGGBB. |
+
linePlaceId |
++ |
name |
+Name stringExample: "H8"Name of the transit line. |
+
source |
+Source stringExample: "INFERRED"Source of the location data of the transit path. Either BACKFILLED or INFERRED. |
+
stopTimesInfo[] |
+Stop Times Info array of: object (Stop Time Info)Time information (departure and arrival times, both real and scheduled) for each transit stop used. |
+
transitStops[] |
++ |
Waypoint Path¶
+
+
+
+
+
+Example
+{
+ "waypoints": [
+ {
+ "latE7": 416119834,
+ "lngE7": 21768624
+ },
+ {
+ "latE7": 416117012,
+ "lngE7": 21899302
+ },
+ {
+ "latE7": 416119262,
+ "lngE7": 21802315
+ }
+ ],
+ "source": "INFERRED",
+ "distanceMeters": 396.34176716755843,
+ "travelMode": "WALK",
+ "confidence": 0.7986568220419046
+}
+| Property | +Description | +
|---|---|
confidence |
+Confidence numberExample: 0.7986568220419046 |
+
distanceMeters |
+Distance in meters numberExample: 396.34176716755843Total distance of the path, in meters. |
+
roadSegment[] |
+Road Segment array of: object (Road Segment) |
+
source |
+Source stringExample: "INFERRED"Source of the location data of the path. Either BACKFILLED or INFERRED. |
+
travelMode |
+Travel Mode stringExample: "WALK" |
+
waypoints[] |
+Waypoints array of: object (Waypoint) |
+
Checkin¶
+
+
+
+
+Help Wanted: +The meaning of this field is uncertain. Contributions to improve this are welcome.
+| Property | +Description | +
|---|---|
atTime |
+At Time string (date-time)Example: "2022-03-06T14:13:11.092Z" |
+
device |
+Device object (Device) |
+
latestKnownLocation |
+Latest Known Location object (Latest Known Location) |
+
Activity Segment¶
+ + +| Property | +Description | +
|---|---|
activityConfidence |
+Confidence numberExample: 98.705695 |
+
activityType |
+Activity Type string (Activity Type)Example: "WALKING" |
+
Edit History¶
+ + +| Property | +Description | +
|---|---|
editEvent[] |
+Edit Event array of: object (Edit Event) |
+
Original Candidates¶
+ + +| Property | +Description | +
|---|---|
placeVisitSegment |
+Place Visit Segment object (Place Visit Segment) |
+
Place Visit Segment¶
+ + +| Property | +Description | +
|---|---|
location |
+Location object (Location) |
+
Semantic Type¶
+
+
+
+
+Place type based on semantic information specific to the user.
+| Semantic Type | +Description | +
|---|---|
TYPE_ALIASED_LOCATION |
+ Type Aliased Location The place has been given a private label by the user. See: Give a place a private label. |
+
TYPE_HOME |
+ Type Home The place has been designated as 'Home' by the user. See: Set or change your home & work addresses. |
+
TYPE_SEARCHED_ADDRESS |
+ Type Searched Address The user has searched for this place in the past. |
+
TYPE_WORK |
+ Type Work The place has been designated as 'Work' by the user. See: Set or change your home & work addresses. |
+
Source Information¶
+
+
+
+
+Information on the source that provided the location.
+| Property | +Description | +
|---|---|
deviceTag |
+Device Tag integerExample: 1234567890Integer identifier (specific to Location History) associated with the device that obtained the location. Refer to deviceSettings in Settings.json for information about the device with this deviceTag. |
+
Point¶
+
+
+
+
+
+Example
+{
+ "latE7": 416032766,
+ "lngE7": 21841819,
+ "accuracyMeters": 10,
+ "timestamp": "2022-03-03T08:27:48Z"
+}
+| Property | +Description | +
|---|---|
accuracyMeters |
+Accuracy in meters integerExample: 10Approximate accuracy radius of the location measurement, in meters. A lower value means better precision. |
+
latE7 |
+Latitude integerExample: 414216106Latitude coordinate of the point. Degrees multiplied by 10^7 and rounded to the nearest integer, in the range -900000000 to +900000000 (divide value by 10^7 for the usual range -90° to +90°). |
+
lngE7 |
+Longitude integerExample: 21684775Longitude coordinate of the point. Degrees multiplied by 10^7 and rounded to the nearest integer, in the range -1800000000 to +1800000000 (divide value by 10^7 for the usual range -180° to +180°). |
+
timestamp |
+Timestamp string (date-time)Example: "2022-03-03T08:27:48Z"Timestamp of the point. |
+
Stop Time Info¶
+
+
+Departure and/or arrival time information (both real and scheduled) for a stop at a transit line.
+
+
+
+
+
+Example
+{
+ "scheduleArrivalTimestamp": "2022-03-03T12:44:01Z",
+ "scheduledDepartureTimestamp": "2022-03-03T12:44:01Z",
+ "realtimeArrivalTimestamp": "2022-03-03T12:45:38Z",
+ "realtimeDepartureTimestamp": "2022-03-03T12:45:38Z"
+}
+| Property | +Description | +
|---|---|
realtimeArrivalTimestamp |
+Realtime Arrival Timestamp string (date-time)Example: "2022-03-03T12:45:38Z" |
+
realtimeDepartureTimestamp |
+Realtime Departure Timestamp string (date-time)Example: "2022-03-03T12:45:38Z" |
+
scheduleArrivalTimestamp |
+Schedule Arrival Timestamp string (date-time)Example: "2022-03-03T12:44:01Z" |
+
scheduledDepartureTimestamp |
+Scheduled Departure Timestamp string (date-time)Example: "2022-03-03T12:44:01Z" |
+
Road Segment¶
+ + +| Property | +Description | +
|---|---|
duration |
+Duration stringExample: "8s" |
+
placeId |
++ |
Waypoint¶
+
+
+
+
+
+Example
+{
+ "latE7": 414216106,
+ "lngE7": 21684775
+}
+| Property | +Description | +
|---|---|
latE7 |
+Latitude integerExample: 414216106Latitude coordinate of the waypoint. Degrees multiplied by 10^7 and rounded to the nearest integer, in the range -900000000 to +900000000 (divide value by 10^7 for the usual range -90° to +90°). |
+
lngE7 |
+Longitude integerExample: 21684775Longitude coordinate of the waypoint. Degrees multiplied by 10^7 and rounded to the nearest integer, in the range -1800000000 to +1800000000 (divide value by 10^7 for the usual range -180° to +180°). |
+
Device¶
+ + +| Property | +Description | +
|---|---|
android |
+Android object (Android) |
+
Latest Known Location¶
+ + +| Property | +Description | +
|---|---|
detectionTime |
+Detection Time string (date-time)Example: "2022-03-06T14:13:11.092Z" |
+
location |
+Location object (Location) |
+
Edit Event¶
+ + +| Property | +Description | +
|---|---|
editOperation[] |
+Edit Operation array of: string |
+
uiConfiguration |
+UI Configuration object (UI Configuration) |
+
Place Visit Segment¶
+ + +| Property | +Description | +
|---|---|
placeVisitCandidate[] |
+Place Visit Candidate array of: object (Original Candidates) |
+
Android¶
+ + +| Property | +Description | +
|---|---|
fingerprint |
+Fingerprint string |
+
UI Configuration¶
+ + +| Property | +Description | +
|---|---|
uiActivitySegmentConfiguration |
+UI Activity Segment Configuration stringExample: "DEFAULT_ACTIVITY_SEGMENT_CONFIGURATION" |
+
uiPlaceVisitConfiguration |
+UI Place Visit Configuration stringExample: "DEFAULT_PLACE_VISIT_CONFIGURATION" |
+
Original Candidates¶
+ + +| Property | +Description | +
|---|---|
location |
+Location object (Location) |
+
+
+
+
+ Last update:
+ 2024-03-24
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/reference/settings/index.html b/reference/settings/index.html
new file mode 100644
index 0000000..1a67665
--- /dev/null
+++ b/reference/settings/index.html
@@ -0,0 +1,958 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Skip to content
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Settings.json Format Definition¶
+
+
+This page has been automatically generated from the schema Settings.schema.json.
Settings¶
+
+
+The Settings.json file in a Google Takeout Location History extraction. Contains information about the Google account settings related to Location History, information about the devices associated, and other auxiliary metadata.
+
+
+
+
+Example
+{
+ "createdTime": "2013-05-15T21:53:59.385Z",
+ "modifiedTime": "2020-07-01T21:27:31.880Z",
+ "historyEnabled": true,
+ "deviceSettings": [
+ {
+ "deviceTag": 1234567890,
+ "reportingEnabled": true,
+ "legalCountryCode": "es",
+ "devicePrettyName": "ONEPLUS A6013",
+ "platformType": "ANDROID",
+ "deviceCreationTime": "2019-01-07T18:13:23.713Z",
+ "latestLocationReportingSettingChange": {
+ "reportingEnabledModificationTime": "2019-01-07T18:13:24.673Z"
+ },
+ "androidOsLevel": 28,
+ "deviceSpec": {
+ "manufacturer": "OnePlus",
+ "brand": "OnePlus",
+ "product": "OnePlus6T",
+ "device": "OnePlus6T",
+ "model": "ONEPLUS A6013",
+ "isLowRam": false
+ }
+ }
+ ],
+ "retentionWindowDays": 2147483647,
+ "hasReportedLocations": true,
+ "hasSetRetention": false
+}
+| Property | +Description | +
|---|---|
createdTime |
+Created Time string (date-time)Example: "2013-05-15T21:53:59.385Z"Timestamp (as an ISO 8601 string) when Location History was first available on this Google account. |
+
deviceSettings[] |
+Device Settings array of: object (Device Settings)List of devices associated with the Location History information on this Google account. |
+
hasReportedLocations |
+Has Reported Locations booleanExample: trueWhether this Google account has any reported Location History information. |
+
hasSetRetention |
+Has Set Retention booleanExample: falseWhether this Google account has configured the auto-delete setting (retention) for the Location History data. Corresponds to the Auto-delete setting in the Activity Controls page.See also retentionWindowDays. |
+
historyEnabled |
+History Enabled booleanExample: trueWhether Location History is enabled on this Google account (controlled in the Activity Controls page). |
+
modifiedTime |
+Modified Time string (date-time)Example: "2020-07-01T21:27:31.880Z"Timestamp (as an ISO 8601 string) when any Location History setting was last modified on this Google account. |
+
retentionWindowDays |
+Retention Window Days integerExample: 540Number of days the Location History information is retained in this Google account. Corresponds to the Auto-delete setting in the Activity Controls page.This value should be ignored if hasSetRetention is false. |
+
Device Settings¶
+
+
+Information about a device associated with the Google Location History account.
+
+
+
+
+
+Example
+{
+ "deviceTag": 1234567890,
+ "reportingEnabled": true,
+ "legalCountryCode": "es",
+ "devicePrettyName": "ONEPLUS A6013",
+ "platformType": "ANDROID",
+ "deviceCreationTime": "2019-01-07T18:13:23.713Z",
+ "latestLocationReportingSettingChange": {
+ "reportingEnabledModificationTime": "2019-01-07T18:13:24.673Z"
+ },
+ "androidOsLevel": 28,
+ "deviceSpec": {
+ "manufacturer": "OnePlus",
+ "brand": "OnePlus",
+ "product": "OnePlus6T",
+ "device": "OnePlus6T",
+ "model": "ONEPLUS A6013",
+ "isLowRam": false
+ }
+}
+| Property | +Description | +
|---|---|
androidOsLevel |
+Android OS Level integerExample: 28The version of the device's operating system (only applies to Android devices). Corresponds to the API Level (e.g. 28 is Android 9 Pie). |
+
deviceCreationTime |
+Device Creation Time string (date-time)Example: "2019-01-07T18:13:23.713Z"Timestamp (as an ISO 8601 string) of the first time this device was available for Location History reporting on this Google account. |
+
devicePrettyName |
+Device Pretty Name stringExample: "ONEPLUS A6013"Pretty name of the device, recommended for user-facing applications. |
+
deviceSpec |
+Device Specification object (Device Specification)Technical information and specifications about the device. |
+
deviceTag |
+Device Tag integerExample: 1234567890Integer identifier (specific to Location History) of the device. |
+
latestLocationReportingSettingChange |
+Latest Location Reporting Setting Change Information on the latest change(s) to Location History settings on this Google account. Help Wanted: Are properties other than reportingEnabledModificationTime possible? Contributions to improve this are welcome. |
+
legalCountryCode |
+Legal Country Code stringExample: "es"Two-letter ISO 3166 country code. Help Wanted: The meaning of this field is uncertain. Contributions to improve this are welcome. |
+
platformType |
+Platform Type stringExample: "ANDROID"Platform of the device. Valid values are: ANDROID, IOS and UNKNOWN. |
+
reportingEnabled |
+Reporting Enabled booleanExample: trueWhether this device is configured to report Location History information (controlled in the Activity Controls page). |
+
Device Specification¶
+
+
+Technical information and specifications about a device.
+
+
+
+
+
+Example
+{
+ "manufacturer": "OnePlus",
+ "brand": "OnePlus",
+ "product": "OnePlus6T",
+ "device": "OnePlus6T",
+ "model": "ONEPLUS A6013",
+ "isLowRam": false
+}
+| Property | +Description | +
|---|---|
brand |
+Brand stringExample: "OnePlus"Brand of the device. |
+
device |
+Device stringExample: "OnePlus6T"Name of the device. |
+
isLowRam |
+Is Low Ram booleanExample: falseWhether the device is considered low-ram. |
+
manufacturer |
+Manufacturer stringExample: "OnePlus"Manufacturer of the device. |
+
model |
+Model stringExample: "ONEPLUS A6013"Model of the device. |
+
product |
+Product stringExample: "OnePlus6T"Product name of the device. |
+
Latest Location Reporting Setting Change¶
+
+
+Information on the latest change(s) to Location History settings on this Google account.
+
+
+ Help Wanted:
+Are properties other than reportingEnabledModificationTime possible? Contributions to improve this are welcome.
+
+
+
+
+Example
+{
+ "reportingEnabledModificationTime": "2019-01-07T18:13:24.673Z"
+}
+| Property | +Description | +
|---|---|
reportingEnabledModificationTime |
+Reporting Enabled Modification Time stringExample: "2019-01-07T18:13:24.673Z"Time that Location History reporting was enabled or disabled for the last time on this Google account. |
+
+
+
+
+ Last update:
+ 2024-03-24
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/reference/timeline-edits/index.html b/reference/timeline-edits/index.html
new file mode 100644
index 0000000..179bcec
--- /dev/null
+++ b/reference/timeline-edits/index.html
@@ -0,0 +1,1277 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Skip to content
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Timeline Edits.json Format Definition¶
+
+
+This page has been automatically generated from the schema TimelineEdits.schema.json.
Timeline Edits Schema¶
+
+
+
+
+This schema outlines the structure of timeline edits data, encompassing device information, place visit aggregates, and raw signal data from the device.
+| Property | +Description | +
|---|---|
timelineEdits[] |
++ |
Timeline Edit Information¶
+
+
+Various information about the timeline edit, including device ID, place aggregates, and raw signal data.
+
+
+
+
+
+Example
+{
+ "deviceId": "0",
+ "placeAggregates": {
+ "placeAggregateInfo": [
+ {
+ "score": 1228.0,
+ "numBucketsWithLocation": 0,
+ "bucketSpanDays": 0,
+ "point": {
+ "latE7": 429362473,
+ "lngE7": -788308560
+ },
+ "placeId": "ChIJV8SII64E1YkRvAqrnP5G_x8",
+ "placePoint": {
+ "latE7": 429362442,
+ "lngE7": -788308585
+ }
+ },
+ {
+ "score": 166.0,
+ "numBucketsWithLocation": 0,
+ "bucketSpanDays": 0,
+ "point": {
+ "latE7": 426994475,
+ "lngE7": -778539281
+ },
+ "placeId": "ChIJ4_FHs78TK4gRw8h22XkBDEA",
+ "placePoint": {
+ "latE7": 426994650,
+ "lngE7": -778539291
+ }
+ },
+ {
+ "score": 131.0,
+ "numBucketsWithLocation": 0,
+ "bucketSpanDays": 0,
+ "point": {
+ "latE7": 415908301,
+ "lngE7": -739409850
+ },
+ "placeId": "ChIJJRdROh863YkRmXCWQ14VMcI",
+ "placePoint": {
+ "latE7": 415908776,
+ "lngE7": -739409849
+ }
+ }
+ ],
+ "windowSizeHrs": 2011,
+ "topRankedPlacesPlaceIds": [
+ "ChIJV8SII64E1YkRvAqrnP5G_x8",
+ "ChIJ4_FHs78TK4gRw8h22XkBDEA",
+ "ChIJJRdROh863YkRmXCWQ14VMcI"
+ ],
+ "processWindow": {
+ "startTime": "2023-12-14T08:00:55Z",
+ "endTime": "2024-03-07T08:00:55Z"
+ },
+ "metadata": {
+ "platform": "UNKNOWN"
+ }
+ }
+}
+| Property | +Description | +
|---|---|
deviceId |
+Device ID stringExample: "0"The unique identifier for the device that generated the data. |
+
placeAggregates |
++ |
rawSignal |
++ |
Place Aggregates¶
+
+
+
+
+Aggregated information about places visited by the device.
+| Property | +Description | +
|---|---|
metadata |
++ |
placeAggregateInfo[] |
+Place Aggregate Information array of: object (Place Aggregate Info Item)An array of place information, including score, location, and place ID. |
+
processWindow |
++ |
topRankedPlacesPlaceIds[] |
+Top Ranked Places array of: stringAn array of place IDs for the top-ranked places. |
+
windowSizeHrs |
+Time Window Size integerExample: 2016The size of the window in hours for the place aggregates. |
+
Raw Signal¶
+
+
+Raw signal data from the device.
+
+
+
+
+
+Example
+{
+ "signal": {
+ "position": {
+ "point": {
+ "latE7": 426974802,
+ "lngE7": -778539156
+ },
+ "accuracyMm": 100000,
+ "altitudeMeters": 224.0,
+ "source": "WIFI",
+ "timestamp": "2024-02-17T04:14:41.412Z"
+ }
+ },
+ "additionalTimestamp": "2024-02-17T04:14:39.545Z",
+ "metadata": {
+ "platform": "ANDROID"
+ }
+}
+| Property | +Description | +
|---|---|
additionalTimestamp |
+Additional Timestamp string (date-time)Example: "2024-02-17T05:54:01.359Z"An additional timestamp associated with the raw signal. |
+
metadata |
++ |
signal |
++ |
Metadata¶
+
+
+
+
+Metadata about the data object.
+| Property | +Description | +
|---|---|
platform |
+Device Platform stringExample: "ANDROID"The platform that generated the data. |
+
Place Aggregate Info Item¶
+
+
+
+
+The place aggregate info containing score, location, place ID, and other details.
+| Property | +Description | +
|---|---|
bucketSpanDays |
+Bucket Span integerExample: 0The span of the buckets in days. |
+
numBucketsWithLocation |
+Number of Buckets integerExample: 0The number of location buckets associated with the place. |
+
placeId |
+Place ID stringExample: "ChIJV8SII64E1YkRvAqrnP5G_x8"The unique identifier for the place. |
+
placePoint |
++ |
point |
++ |
score |
+Score numberExample: 1228.0The score assigned to the place. |
+
Process Window¶
+
+
+
+
+The start and end time of the processing window.
+| Property | +Description | +
|---|---|
endTime |
+End Time string (date-time)Example: "2024-03-07T08:00:55Z"The end time of the processing window. |
+
startTime |
+Start Time string (date-time)Example: "2023-12-14T08:00:55Z"The start time of the processing window. |
+
Signal¶
+
+
+
+
+The signal data, including position, activity record, and wifi scan.
+| Property | +Description | +
|---|---|
activityRecord |
+Activity Record object (Activity Record)The activity record data, including detected activities and timestamp. |
+
position |
+Position object (Position)The position data, including point, accuracy, altitude, source, and timestamp. |
+
wifiScan |
+Wifi Scan Data object (Wifi Scan Data)The wifi scan data, including delivery time, devices, and source. |
+
Point¶
+
+
+The geographical point.
+
+
+
+
+
+Example
+{
+ "latE7": 416032766,
+ "lngE7": 21841819,
+ "accuracyMeters": 10,
+ "timestamp": "2022-03-03T08:27:48Z"
+}
+| Property | +Description | +
|---|---|
latE7 |
+Latitude integerExample: 439362473Latitude coordinate of the point. Degrees multiplied by 10^7 and rounded to the nearest integer, in the range -900000000 to +900000000 (divide value by 10^7 for the usual range -90° to +90°). |
+
lngE7 |
+Longitude integerExample: -788308560Longitude coordinate of the point. Degrees multiplied by 10^7 and rounded to the nearest integer, in the range -1800000000 to +1800000000 (divide value by 10^7 for the usual range -180° to +180°). |
+
Activity Record¶
+
+
+
+
+The activity record data, including detected activities and timestamp.
+| Property | +Description | +
|---|---|
detectedActivities[] |
+Detected Activities array of: object (Detected Activity Item)An array of detected activities, including activity type and probability. |
+
timestamp |
+Timestamp string (date-time)Example: "2024-02-17T05:26:47.066Z"The timestamp of the activity record. |
+
Position¶
+
+
+
+
+The position data, including point, accuracy, altitude, source, and timestamp.
+| Property | +Description | +
|---|---|
accuracyMm |
+Signal Position Accuracy integerExample: 100000The accuracy of the position in millimeters. |
+
altitudeMeters |
+Altitude numberExample: 224.0The altitude of the position in meters. |
+
point |
++ |
source |
+Signal Position Source stringExample: "WIFI"The source of the position data. |
+
speedMetersPerSecond |
+Speed numberExample: 0.0Speed in meters per second. |
+
timestamp |
+Timestamp string (date-time)Example: "2024-02-17T05:54:00.932Z"The timestamp of the position data. |
+
Wifi Scan Data¶
+
+
+
+
+The wifi scan data, including delivery time, devices, and source.
+| Property | +Description | +
|---|---|
deliveryTime |
+Delivery Time string (date-time)Example: "2024-02-17T04:26:44.661Z"The delivery time of the wifi scan. |
+
devices[] |
+Wifi Devices array of: object (Wifi Device)An array of wifi devices, including mac address and raw RSSI. |
+
source |
+Wifi Scan Source stringExample: "ACTIVE_SCAN"The source of the wifi scan data. |
+
Detected Activity Item¶
+
+
+
+
+The detected activity item info containing activity type and probability.
+| Property | +Description | +
|---|---|
activityType |
+Activity Type stringExample: "STILL"The type of the detected activity. This could re-use the #/$defs/activityType from Records schema later. |
+
probability |
+Probability numberExample: 0.96The probability of the detected activity. |
+
Wifi Device¶
+
+
+
+
+The wifi device info containing mac address and raw RSSI.
+| Property | +Description | +
|---|---|
mac |
+MAC Address stringExample: "145830537259886"The mac address of the wifi device. |
+
rawRssi |
+Raw RSSI integerExample: -51The raw RSSI of the wifi device. |
+
+
+
+
+ Last update:
+ 2024-03-24
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/schemas/Records.schema.json b/schemas/Records.schema.json
new file mode 100644
index 0000000..4b03c53
--- /dev/null
+++ b/schemas/Records.schema.json
@@ -0,0 +1,691 @@
+{
+ "$id": "https://locationhistoryformat.com/schemas/Records.schema.json",
+ "$schema": "http://json-schema.org/draft/2020-12/schema",
+ "title": "Records",
+ "description": "The `Records.json` file in a Google Takeout Location History extraction. Contains raw Location History information from the user's account.",
+ "type": "object",
+ "properties": {
+ "locations": {
+ "type": "array",
+ "title": "Locations",
+ "description": "List of all available location records, in chronological order.",
+ "items": {
+ "$ref": "#/$defs/locationRecord"
+ },
+ "examples": []
+ }
+ },
+ "required": [
+ "locations"
+ ],
+ "$defs": {
+ "locationRecord": {
+ "title": "Location Record",
+ "type": "object",
+ "description": "A specific location record. Contains the information obtained from a user's device at a specific moment in time and at a given location.",
+ "examples": [
+ {
+ "timestamp": "2022-01-12T17:18:24.190Z",
+ "latitudeE7": 414216106,
+ "longitudeE7": 21684775,
+ "accuracy": 20,
+ "velocity": 10,
+ "heading": 270,
+ "altitude": 150,
+ "verticalAccuracy": 10,
+ "source": "WIFI",
+ "deviceTag": 1234567890,
+ "platformType": "ANDROID"
+ }
+ ],
+ "properties": {
+ "accuracy": {
+ "type": "integer",
+ "title": "Accuracy",
+ "description": "Approximate accuracy radius of the location measurement, in meters. A lower value means better precision.",
+ "examples": [
+ 20
+ ]
+ },
+ "activeWifiScan": {
+ "type": "object",
+ "title": "Active Wi-Fi Scan",
+ "description": "Information about the access points found in a Wi-Fi scan done by the device and associated with this location record.",
+ "$ref": "#/$defs/wifiScan"
+ },
+ "activity": {
+ "type": "array",
+ "title": "Activity",
+ "description": "Detected activity information at this location, as a list of activity records at slightly different timestamps but all associated with this location record.",
+ "examples": [
+ [
+ {
+ "activity": [
+ {
+ "type": "ON_FOOT",
+ "confidence": 89
+ },
+ {
+ "type": "WALKING",
+ "confidence": 84
+ },
+ {
+ "type": "ON_BICYCLE",
+ "confidence": 5
+ },
+ {
+ "type": "IN_VEHICLE",
+ "confidence": 2
+ },
+ {
+ "type": "STILL",
+ "confidence": 1
+ },
+ {
+ "type": "UNKNOWN",
+ "confidence": 1
+ }
+ ],
+ "timestamp": "2022-02-12T15:10:56.751Z"
+ },
+ {
+ "activity": [
+ {
+ "type": "STILL",
+ "confidence": 79
+ },
+ {
+ "type": "IN_VEHICLE",
+ "confidence": 12
+ },
+ {
+ "type": "IN_RAIL_VEHICLE",
+ "confidence": 12
+ },
+ {
+ "type": "ON_FOOT",
+ "confidence": 1
+ },
+ {
+ "type": "WALKING",
+ "confidence": 1
+ },
+ {
+ "type": "UNKNOWN",
+ "confidence": 1
+ }
+ ],
+ "timestamp": "2022-02-12T15:12:55.377Z"
+ }
+ ]
+ ],
+ "items": {
+ "type": "object",
+ "title": "Activity Record",
+ "description": "Activity information for a location at a given timestamp.",
+ "examples": [
+ {
+ "activity": [
+ {
+ "type": "ON_FOOT",
+ "confidence": 89
+ },
+ {
+ "type": "WALKING",
+ "confidence": 84
+ },
+ {
+ "type": "ON_BICYCLE",
+ "confidence": 5
+ },
+ {
+ "type": "IN_VEHICLE",
+ "confidence": 2
+ },
+ {
+ "type": "STILL",
+ "confidence": 1
+ },
+ {
+ "type": "UNKNOWN",
+ "confidence": 1
+ }
+ ],
+ "timestamp": "2022-02-12T15:10:56.751Z"
+ }
+ ],
+ "properties": {
+ "activity": {
+ "type": "array",
+ "title": "Activity",
+ "description": "List of candidate detected activities with their associated confidence.",
+ "items": {
+ "$ref": "#/$defs/activity"
+ }
+ },
+ "timestamp": {
+ "type": "string",
+ "format": "date-time",
+ "title": "Timestamp",
+ "description": "Timestamp (as an ISO 8601 string) of the activity.",
+ "examples": [
+ "2022-01-12T17:18:24.190Z"
+ ]
+ }
+ }
+ }
+ },
+ "altitude": {
+ "type": "integer",
+ "title": "Altitude",
+ "description": "Altitude above the WGS84 reference ellipsoid, in meters.",
+ "examples": [
+ 150
+ ]
+ },
+ "batteryCharging": {
+ "type": "boolean",
+ "title": "Battery Charging",
+ "description": "Whether the device was charging its battery or not at the time of the record.",
+ "examples": [
+ true
+ ]
+ },
+ "deviceDesignation": {
+ "type": "string",
+ "title": "Device Designation",
+ "description": "Common values found are: `PRIMARY`, `UNKNOWN`.",
+ "examples": [
+ "PRIMARY"
+ ],
+ "enum": [
+ "PRIMARY",
+ "UNKNOWN"
+ ],
+ "helpWanted": "The meaning of this field is uncertain. Are other values possible?"
+ },
+ "deviceTag": {
+ "type": "integer",
+ "title": "Device Tag",
+ "description": "Integer identifier (specific to Location History) associated with the device that uploaded the location. Refer to `deviceSettings` in Settings.json for information about the device with this `deviceTag`.",
+ "examples": [
+ 1234567890
+ ]
+ },
+ "deviceTimestamp": {
+ "type": "string",
+ "format": "date-time",
+ "title": "Device Timestamp",
+ "description": "",
+ "examples": [],
+ "helpWanted": "The meaning of this field is uncertain."
+ },
+ "formFactor": {
+ "type": "string",
+ "title": "Form Factor",
+ "description": "Form factor (device type) from which the location record originated.\nCommon values are: `PHONE`, `TABLET`.",
+ "examples": [
+ "PHONE"
+ ],
+ "enum": [
+ "PHONE",
+ "TABLET"
+ ],
+ "helpWanted": "What are other possible values?"
+ },
+ "heading": {
+ "type": "integer",
+ "title": "Heading",
+ "description": "Heading in degrees east of true north, from 0 to 359.",
+ "examples": [
+ 270
+ ],
+ "minimum": 0,
+ "maximum": 359
+ },
+ "inferredLocation": {
+ "type": "array",
+ "title": "Inferred Location",
+ "description": "",
+ "items": {
+ "$ref": "#/$defs/locationRecord"
+ },
+ "examples": [],
+ "helpWanted": "The meaning of this field is uncertain."
+ },
+ "latitudeE7": {
+ "type": "integer",
+ "title": "Latitude",
+ "description": "WGS84 Latitude coordinate of the location. Degrees multiplied by 10^7 and rounded to the nearest integer, in the range -900000000 to +900000000 (divide value by 10^7 for the usual range -90° to +90°).",
+ "examples": [
+ 414216106
+ ],
+ "minimum": -900000000,
+ "maximum": 900000000
+ },
+ "locationMetadata": {
+ "type": "array",
+ "title": "Location Metadata",
+ "description": "Additional location metadata. List of different Wi-Fi scans associated with this location record.",
+ "items": {
+ "$ref": "#/$defs/locationMetadata"
+ },
+ "examples": []
+ },
+ "longitudeE7": {
+ "type": "integer",
+ "title": "Longitude",
+ "description": "WGS84 Longitude coordinate of the location. Degrees multiplied by 10^7 and rounded to the nearest integer, in the range -1800000000 to +1800000000 (divide value by 10^7 for the usual range -180° to +180°).",
+ "examples": [
+ 21684775
+ ],
+ "minimum": -1800000000,
+ "maximum": 1800000000
+ },
+ "osLevel": {
+ "type": "integer",
+ "title": "OS Level",
+ "description": "The version of the device's operating system that provided this record. In Android devices, this corresponds to the API Level (e.g. 28 is Android 9 *Pie*).",
+ "examples": [
+ 28
+ ]
+ },
+ "placeId": {
+ "type": "string",
+ "title": "Place ID",
+ "description": "Google Maps [Place ID](https://developers.google.com/maps/documentation/places/web-service/place-id) of the location.",
+ "examples": [
+ "ChIJk_s92NyipBIRUMnDG8Kq2Js"
+ ]
+ },
+ "platformType": {
+ "type": "string",
+ "title": "Platform Type",
+ "description": "Platform of the device that provided this record. Valid values are: `ANDROID`, `IOS` and `UNKNOWN`.",
+ "examples": [
+ "ANDROID"
+ ],
+ "enum": [
+ "ANDROID",
+ "IOS",
+ "UNKNOWN"
+ ]
+ },
+ "serverTimestamp": {
+ "type": "string",
+ "format": "date-time",
+ "title": "Server Timestamp",
+ "description": "",
+ "examples": [],
+ "helpWanted": "The meaning of this field is uncertain."
+ },
+ "source": {
+ "type": "string",
+ "title": "Source",
+ "description": "Source (technology) that provided the location information for this record.\nCommon values are: `WIFI`, `CELL`, `GPS`, `UNKNOWN` (note: sometimes found in lowercase).",
+ "examples": [
+ "WIFI"
+ ],
+ "enum": [
+ "WIFI",
+ "wifi",
+ "CELL",
+ "cell",
+ "GPS",
+ "gps",
+ "UNKNOWN",
+ "unknown"
+ ]
+ },
+ "timestamp": {
+ "type": "string",
+ "format": "date-time",
+ "title": "Timestamp",
+ "description": "Timestamp (as an ISO 8601 string) of the record.",
+ "examples": [
+ "2022-01-12T17:18:24.190Z"
+ ],
+ "added": "around January 2022"
+ },
+ "timestampMs": {
+ "type": "string",
+ "title": "Timestamp (Milliseconds)",
+ "description": "Timestamp of the record as a [Unix timestamp](https://en.wikipedia.org/wiki/Unix_time) in milliseconds.",
+ "examples": [
+ "1636403752674"
+ ],
+ "deprecated": true,
+ "removed": "around January 2022",
+ "replacedBy": "#/$defs/locationRecord/properties/timestamp"
+ },
+ "velocity": {
+ "type": "integer",
+ "title": "Velocity",
+ "description": "Measured velocity (ground speed) in meters per second.",
+ "examples": [
+ 10
+ ],
+ "minimum": 0
+ },
+ "verticalAccuracy": {
+ "type": "integer",
+ "title": "Vertical Accuracy",
+ "description": "Calculated accuracy of the location's altitude measurement, in meters. A lower value means better precision.",
+ "examples": [
+ 10
+ ],
+ "minimum": 0
+ }
+ }
+ },
+ "activity": {
+ "type": "object",
+ "title": "Activity",
+ "description": "A detected activity with an associated confidence. Descriptions partially based on: Collaborative format definition and documentation for Google Location History files.
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.
"},{"location":"#goals","title":"Goals","text":"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 (locationhistoryformat.com) 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 https://support.google.com/.
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.
"},{"location":"#contributing","title":"Contributing","text":"Contributions are welcome! If you notice errors, out-of-date information, or missing information, you can help improve it. See Contributing.
"},{"location":"#license","title":"License","text":"This project is licensed under the terms of the MIT License.
"},{"location":"contributing/","title":"Contributing","text":"Open collaboration is fundamental for this project, a single person can't encounter and document all edge cases of the files. Additionally, Google periodically updates the format and structure of the files without prior warning, so updates to the format definitions will also be needed periodically but might be easy to miss.
All source code, documentation files, and schemas can be found in the project's GitHub repository. If you notice incorrect, out-of-date, or missing information, you can help by creating a new issue or creating a pull request.
Note that Google's Location History data presents unique challenges that make spotting, formalizing, and accurately keeping track of the changes to the format significantly difficult. In particular, there is no known versioning system for the file format (or other indirect versioning clues), and changes to the format of the extracted files are usually not rolled out at the same time for all Google users.
"},{"location":"contributing/#improving-the-json-schemas","title":"Improving the JSON Schemas","text":"All JSON schemas can be found in the schemas/ folder of the repository. Pull requests are welcome. Ideally contributors should be familiar with the structure of JSON Schema files.
All documented objects and properties should at least have the following fields:
-
title: In most cases it is just a \"humanized\" version of the key. -
type: One of\"object\",\"array\",\"string\",\"number\",\"boolean\",\"null\". -
description: Can make use of common basic Markdown syntax. It can be an empty string if no information is known (in which case ahelpWantedfield should be present).
In addition to other basic JSON Schema fields, the following non-standard fields are also supported:
-
helpWanted: Short description to inform that the information provided for this object/property is incomplete and help from the community is welcome. Example:\"The meaning of this field is uncertain. Are other values possible?\" -
added: Approximate date that this object/property was added to the format, if known. Example:\"around January 2022\". -
removed: Approximate date that this object/property was removed from the format, if known. Example:\"around January 2022\". -
replacedBy: For objects/properties that have been removed, the URI-reference of the new object/property that replaced it, if it applies. Example:\"#/$defs/locationRecord/properties/timestamp\"
To convert the JSON Schema files to Markdown files (which are then used for the documentation site) a custom Python script is used (see tools/jsonschema_to_md/).
Info
Not all standard JSON Schema language features are supported when building the site (and it is not in the scope of this project to build a complete JSON Schema to Markdown generator). If you miss some JSON Schema feature in the Markdown generator create a new issue or a pull request.
"},{"location":"contributing/#improving-the-guides","title":"Improving the Guides","text":"To improve the documentation guides provided in this site modify the Markdown files found in the docs/guides/ folder and submit a pull request. Most common Markdown syntax is supported, plus additional syntax extensions provided by the Material for MkDocs theme.
In order to set-up a local environment to preview and test changes to the site first clone the GitHub repository, then:
To install all requirements run:
pip install -r requirements.txt\nTo transform the JSON schemas in the schemas/ folder to Markdown files run:
make build\nInfo
The generated Markdown files are stored in the /docs/reference folder. Note that these dynamically generated Markdown files should not be included in the repository.
To start a local web server and view the site run:
mkdocs serve\nYou can configure a retention period in your Google account settings by using the auto-delete setting. With that said, even if you have disabled auto-deletion from the account settings it's been observed that after some undetermined amount of months Google might start dropping some attributes of your raw location history data. Timestamps, latitudes and longitudes seem to always be conserved, but old values for other attributes such as altitude, speed, or heading, might be discarded without prior warning.
You should therefore not rely on Google Location History data to be always available. If you want to conserve all historic data consider periodically making extractions and backing them up or look for other alternative services.
"},{"location":"guides/downloading/","title":"Downloading the Data","text":"To download your Location History data go to the Google Takeout page while logged in with your Google account.
There, create a new export containing the Location History data (note: make sure all other data sources are not selected).
In most cases a one-off download is enough, so, in the next screen choose Export Once, and leave the other options at their default value (the resulting file will almost certainly not exceed 2 GB).
After a few minutes your data should be ready to download. You will also receive an email informing you about this and providing a link.
"},{"location":"guides/general-structure/","title":"General Structure","text":"A typical Location History extraction from Google Takeout will look something like this:
Takeout/\n\u251c\u2500 archive_browser.html\n\u2514\u2500 Location History/\n \u251c\u2500 Records.json\n \u251c\u2500 Settings.json\n \u251c\u2500 Timeline Edits.json\n \u2514\u2500 Semantic Location History/\n \u2502 ...\n \u251c\u2500 2020/\n \u2502 \u251c\u2500 2020_JANUARY.json\n \u2502 \u251c\u2500 2020_FEBRUARY.json\n \u2502 \u2502 ...\n \u2502 \u2514\u2500 2020_DECEMBER.json\n \u2514\u2500 2021/\n \u251c\u2500 2021_JANUARY.json\n \u251c\u2500 2021_FEBRUARY.json\n \u2502 ...\n \u2514\u2500 2021_DECEMBER.json\nWarning
Folder names might be different for Google accounts in different languages.
From here, the most relevant files and folders are:
Records.json This file contains all available raw Location History data. See Raw Location History Data for more information. Settings.json This file contains additional auxiliary metadata, like information about the devices used and account settings.Timeline Edits.json
Semantic Location History This folder contains higher-level information about the user's inferred activity and movements. There is one subfolder for each year of data, and inside each subfolder one file for each month. See Semantic Location History Data for more information."},{"location":"guides/raw-location/","title":"Raw Location History Data","text":"Raw Location History data consists of a list of timestamped location records in chronological order for all the historical location data available and presumably at the most granular level possible.
This raw Location History data is found in the Records.json file (see General Structure). Inside this file we can find a single flat locations array containing all of the location records:
{\n\"locations\" : [...]\n}\nEach of the location records in this array has a very similar structure. A location record might look like this:
Example location record{\n\"timestamp\": \"2022-01-12T17:18:24.190Z\",\n\"latitudeE7\": 414216106,\n\"longitudeE7\": 21684775,\n\"accuracy\": 47,\n\"velocity\": 0,\n\"heading\": 188,\n\"altitude\": 89,\n\"verticalAccuracy\": 27,\n\"source\": \"WIFI\",\n\"deviceTag\": 1234567890,\n\"platformType\": \"ANDROID\"\n}\nFrom this, the most essential fields are:
timestamp: Timestamp of the record as a string in ISO 8601 format (YYYY-MM-DDTHH:mm:ss.sssZ). The suffixedZindicates that the time is in the UTC time zone.latitudeE7andlongitudeE7: Coordinates (latitude and longitude) of the location reported as integers. The values need to be divided by 107 to be in the expected range.
For more information on the other possible fields see the full format definition.
"},{"location":"guides/semantic-location/","title":"Semantic Location History Data","text":"Semantic Location History data consists of more high-level and processed information compared to the raw Location History data. This semantic information is the same information that can be seen in the Timeline pages on the Google Maps website and app. Instead of individual raw location records, here the information is aggregated and summarized as a sequence of inferred (or manually set) place visits and activity segments between place visits, all with a start time and an end time.
This semantic data can be found inside the Semantic Location History folder. The data is partitioned by year in different subfolders (named e.g. 2021, 2022...). And for each year, the data is partitioned again by month in different JSON files (named e.g. 2022_JANUARY.json, 2022_FEBRUARY.json etc.).
Inside each semantic JSON file we can find a single flat timelineObjects array: Example semantic JSON file
{\n\"timelineObjects\" : [...]\n}\nEach of the timeline objects in this array is either an activitySegment or a placeVisit.
For more technical information see the full format definition.
"},{"location":"guides/semantic-location/#activity-segments","title":"Activity Segments","text":"Activity segments correspond to user activities involving changes in location, usually a journey from one place to another, such as a walk, a car drive, a bus ride, or a flight.
Activity segments contain, among other fields, a start location, an end location, a duration, a distance, and an inferred (or manually set) activity type (walking, running, driving, ...). A list of all known activity types can be found in the Activity Type section.
"},{"location":"guides/semantic-location/#place-visits","title":"Place Visits","text":"Place visits correspond to a user visit or stay at a place in a fixed location for a duration of time, such as a stay at home, at work, a visit to a shopping mall, or to a restaurant.
Place visits contain, among other fields, a location and a duration.
"},{"location":"reference/","title":"Reference","text":"JSON Schema files can be found in the schemas folder in the repository.
User-friendly documentation for these files is provided in the following pages:
- Records.json
- Settings.json
- Timeline Edits.json
- Semantic Location History
Records.json Format Definition","text":"This page has been automatically generated from the schema Records.schema.json.
The Records.json file in a Google Takeout Location History extraction. Contains raw Location History information from the user's account.
locations\u200b[] Locationsarray of: object\u00a0\u00a0(Location Record)List of all available location records, in chronological order."},{"location":"reference/records/#/$defs/locationRecord/","title":"Location Record","text":"A specific location record. Contains the information obtained from a user's device at a specific moment in time and at a given location.
Example{\n\"timestamp\": \"2022-01-12T17:18:24.190Z\",\n\"latitudeE7\": 414216106,\n\"longitudeE7\": 21684775,\n\"accuracy\": 20,\n\"velocity\": 10,\n\"heading\": 270,\n\"altitude\": 150,\n\"verticalAccuracy\": 10,\n\"source\": \"WIFI\",\n\"deviceTag\": 1234567890,\n\"platformType\": \"ANDROID\"\n}\naccuracy AccuracyintegerExample: 20Approximate accuracy radius of the location measurement, in meters. A lower value means better precision. activeWifiScan Active Wi-Fi Scanobject\u00a0\u00a0(Wi-Fi Scan)Information about the access points found in a Wi-Fi scan done by the device and associated with this location record. activity\u200b[] Activityarray of: object\u00a0\u00a0(Activity Record)Detected activity information at this location, as a list of activity records at slightly different timestamps but all associated with this location record. altitude AltitudeintegerExample: 150Altitude above the WGS84 reference ellipsoid, in meters. batteryCharging Battery ChargingbooleanExample: trueWhether the device was charging its battery or not at the time of the record. deviceDesignation Device DesignationstringExample: \"PRIMARY\"Common values found are: PRIMARY, UNKNOWN. Help Wanted: The meaning of this field is uncertain. Are other values possible? Contributions to improve this are welcome. deviceTag Device TagintegerExample: 1234567890Integer identifier (specific to Location History) associated with the device that uploaded the location. Refer to deviceSettings in Settings.json for information about the device with this deviceTag. deviceTimestamp Device Timestampstring\u00a0\u00a0(date-time) Help Wanted: The meaning of this field is uncertain. Contributions to improve this are welcome. formFactor Form FactorstringExample: \"PHONE\"Form factor (device type) from which the location record originated.Common values are: PHONE, TABLET. Help Wanted: What are other possible values? Contributions to improve this are welcome. heading HeadingintegerExample: 270Heading in degrees east of true north, from 0 to 359. inferredLocation\u200b[] Inferred Locationarray of: object\u00a0\u00a0(Location Record) Help Wanted: The meaning of this field is uncertain. Contributions to improve this are welcome. latitudeE7 LatitudeintegerExample: 414216106WGS84 Latitude coordinate of the location. Degrees multiplied by 10^7 and rounded to the nearest integer, in the range -900000000 to +900000000 (divide value by 10^7 for the usual range -90\u00b0 to +90\u00b0). locationMetadata\u200b[] Location Metadataarray of: object\u00a0\u00a0(Location Metadata)Additional location metadata. List of different Wi-Fi scans associated with this location record. longitudeE7 LongitudeintegerExample: 21684775WGS84 Longitude coordinate of the location. Degrees multiplied by 10^7 and rounded to the nearest integer, in the range -1800000000 to +1800000000 (divide value by 10^7 for the usual range -180\u00b0 to +180\u00b0). osLevel OS LevelintegerExample: 28The version of the device's operating system that provided this record. In Android devices, this corresponds to the API Level (e.g. 28 is Android 9 Pie). placeId Place IDstringExample: \"ChIJk_s92NyipBIRUMnDG8Kq2Js\"Google Maps Place ID of the location. platformType Platform TypestringExample: \"ANDROID\"Platform of the device that provided this record. Valid values are: ANDROID, IOS and UNKNOWN. serverTimestamp Server Timestampstring\u00a0\u00a0(date-time) Help Wanted: The meaning of this field is uncertain. Contributions to improve this are welcome. source SourcestringExample: \"WIFI\"Source (technology) that provided the location information for this record.Common values are: WIFI, CELL, GPS, UNKNOWN (note: sometimes found in lowercase). timestamp Timestampstring\u00a0\u00a0(date-time)Example: \"2022-01-12T17:18:24.190Z\" Added around January 2022.Timestamp (as an ISO 8601 string) of the record. timestampMs Timestamp (Milliseconds)stringExample: \"1636403752674\" Removed around January 2022.Replaced by timestamp.Timestamp of the record as a Unix timestamp in milliseconds. velocity VelocityintegerExample: 10Measured velocity (ground speed) in meters per second. verticalAccuracy Vertical AccuracyintegerExample: 10Calculated accuracy of the location's altitude measurement, in meters. A lower value means better precision."},{"location":"reference/records/#/$defs/wifiScan/","title":"Wi-Fi Scan","text":"Information about the access points found in a Wi-Fi scan done by the device.
Example{\n\"accessPoints\": [\n{\n\"mac\": \"220676014124647\",\n\"strength\": -34,\n\"frequencyMhz\": 2437\n},\n{\n\"mac\": \"220676014124646\",\n\"strength\": -47,\n\"frequencyMhz\": 5180\n},\n{\n\"mac\": \"93672086150526\",\n\"strength\": -48,\n\"frequencyMhz\": 2412\n},\n{\n\"mac\": \"251425092175323\",\n\"strength\": -81,\n\"frequencyMhz\": 2412\n}\n]\n}\naccessPoints\u200b[] Access Pointsarray of: object\u00a0\u00a0(Access Point)List of Wi-Fi access points found with the scan."},{"location":"reference/records/#/$defs/locationRecord/properties/activity/items/","title":"Activity Record","text":"Activity information for a location at a given timestamp.
Example{\n\"activity\": [\n{\n\"type\": \"ON_FOOT\",\n\"confidence\": 89\n},\n{\n\"type\": \"WALKING\",\n\"confidence\": 84\n},\n{\n\"type\": \"ON_BICYCLE\",\n\"confidence\": 5\n},\n{\n\"type\": \"IN_VEHICLE\",\n\"confidence\": 2\n},\n{\n\"type\": \"STILL\",\n\"confidence\": 1\n},\n{\n\"type\": \"UNKNOWN\",\n\"confidence\": 1\n}\n],\n\"timestamp\": \"2022-02-12T15:10:56.751Z\"\n}\nactivity\u200b[] Activityarray of: object\u00a0\u00a0(Activity)List of candidate detected activities with their associated confidence. timestamp Timestampstring\u00a0\u00a0(date-time)Example: \"2022-01-12T17:18:24.190Z\"Timestamp (as an ISO 8601 string) of the activity."},{"location":"reference/records/#/$defs/locationMetadata/","title":"Location Metadata","text":"Information about a Wi-Fi scan done by the device at a given timestamp.
Property Descriptiontimestamp Timestampstring\u00a0\u00a0(date-time)Example: \"2022-01-12T17:18:24.190Z\"Timestamp (as an ISO 8601 string) of the location metadata. wifiScan Wi-Fi Scanobject\u00a0\u00a0(Wi-Fi Scan)Information about the access points found in a Wi-Fi scan done by the device."},{"location":"reference/records/#/$defs/accessPoint/","title":"Access Point","text":"Information about a specific wireless access point or router.
Example{\n\"mac\": \"220676014124647\",\n\"strength\": -34,\n\"frequencyMhz\": 2437\n}\nfrequencyMhz Frequency (MHz)integerExample: 2437Frequency of the signal (in MHz) that the access point is using. isConnected Is ConnectedbooleanExample: trueWhether the device that scanned the access point is connected to it. mac MAC AddressstringExample: \"220676014124647\"MAC address of the access point as an integer. MAC addresses typically consist of 48 bits (6 bytes), so it is likely the value found here needs to be interpreted as a 6 byte integer (which when converted to its hexadecimal representation results in a more typical representation for MAC addresses). strength StrengthintegerExample: -34Strength of the signal in dBm (decibels per milliwatt) of the access point."},{"location":"reference/records/#/$defs/activity/","title":"Activity","text":"A detected activity with an associated confidence. Descriptions partially based on: https://developers.google.com/android/reference/com/google/android/gms/location/DetectedActivity
Example{\n\"type\": \"ON_FOOT\",\n\"confidence\": 89\n}\nconfidence ConfidenceintegerExample: 100Value from 0 to 100 indicating the likelihood that the user is performing this activity.The larger the value, the more consistent the data used to perform the classification is with the detected activity. Multiple activities may have high confidence values. For example, the ON_FOOT may have a confidence of 100 while the RUNNING activity may have a confidence of 95. The sum of the confidences of all detected activities for a classification does not have to be <= 100 since some activities are not mutually exclusive (for example, you can be walking while in a bus) and some activities are hierarchical (ON_FOOT is a generalization of WALKING and RUNNING). extra Extra Activity Informationobject\u00a0\u00a0(Extra Activity Information)Generic object containing extra information about an activity, in the form of a property with a type, a name, and a value. So far only the property with name vehicle_personal_confidence has been encountered. type Activity Typestring\u00a0\u00a0(Activity Type)Example: \"STILL\"Type of activity detected."},{"location":"reference/records/#/$defs/activity/properties/extra/","title":"Extra Activity Information","text":"Generic object containing extra information about an activity, in the form of a property with a type, a name, and a value. So far only the property with name vehicle_personal_confidence has been encountered.
{\n\"type\": \"VALUE\",\n\"name\": \"vehicle_personal_confidence\",\n\"intVal\": 100\n}\nintVal Integer ValueintegerExample: 100Integer value of the property. name NamestringExample: \"vehicle_personal_confidence\"Name of the property. type TypestringExample: \"VALUE\"Type of the property."},{"location":"reference/records/#/$defs/activityType/","title":"Activity Type","text":"Type of activity detected, such as WALKING or ON_BICYCLE. Some activity types are hierarchical, for example, WALKING is a subtype of ON_FOOT, and in particular, the following activity type hierarchy is known:
- EXITING_VEHICLE\n- IN_VEHICLE\n- \u251c\u2500 IN_RAIL_VEHICLE\n- \u2514\u2500 IN_ROAD_VEHICLE\n- \u251c\u2500 IN_FOUR_WHEELER_VEHICLE\n- \u2502 \u251c\u2500 IN_BUS\n- \u2502 \u2514\u2500 IN_CAR\n- \u2514\u2500 IN_TWO_WHEELER_VEHICLE\n- ON_BICYCLE\n- ON_FOOT\n- \u251c\u2500 RUNNING\n- \u2514\u2500 WALKING\n- STILL\n- TILTING\n- UNKNOWN\nDescriptions partially based on: https://developers.google.com/android/reference/com/google/android/gms/location/DetectedActivity
Activity Type DescriptionEXITING_VEHICLE Exiting VehicleThe device is exiting a vehicle. IN_BUS In BusThe device is in a bus. IN_CAR In CarThe device is in a car. IN_FOUR_WHEELER_VEHICLE In Four-Wheeler VehicleThe device is in a four-wheeler vehicle. IN_RAIL_VEHICLE In Rail VehicleThe device is in a rail vehicle. IN_ROAD_VEHICLE In Road VehicleThe device is in a road vehicle. IN_TWO_WHEELER_VEHICLE In Two-Wheeler VehicleThe device is in a two-wheeler vehicle. IN_VEHICLE In VehicleThe device is in a vehicle, such as a car. ON_BICYCLE On BicycleThe device is on a bicycle. ON_FOOT On FootThe device is on a user who is walking or running. RUNNING RunningThe device is on a user who is running. STILL StillThe device is still (not moving). TILTING TiltingThe device angle relative to gravity changed significantly. This often occurs when a device is picked up from a desk or a user who is sitting stands up. UNKNOWN UnknownUnable to detect the current activity. WALKING WalkingThe device is on a user who is walking."},{"location":"reference/semantic/","title":"Semantic Location History","text":""},{"location":"reference/semantic/#semantic-location-history-format-definition","title":"Semantic Location History Format Definition","text":"This page has been automatically generated from the schema Semantic.schema.json.
A Semantic Location History JSON file in a Google Takeout Location History extraction. Contains Semantic Location History information from the user's account. Typically this will be a file containing data for a single month, with a name such as 2021_JANUARY.json.
timelineObjects\u200b[] Timeline Objectsarray of: object\u00a0\u00a0(Timeline Object)List of all available semantic information, in chronological order. Each item in the list is either an Activity Segment or a Place Visit, encapsulated in a generic Timeline Object."},{"location":"reference/semantic/#/properties/timelineObjects/items/","title":"Timeline Object","text":"Encapsulates either an Activity Segment or a Place Visit, depending on the single key found.
Single Property DescriptionactivitySegment Activity Segmentobject\u00a0\u00a0(Activity Segment)An activity involving changes in location, usually a journey from one place to another, such as a walk, a car drive, a bus ride, or a flight. placeVisit Place Visitobject\u00a0\u00a0(Place Visit)A visit or stay at a place in a fixed location for a duration of time, such as a stay at home, at work, a visit to a shopping mall, or to a restaurant."},{"location":"reference/semantic/#/$defs/activitySegment/","title":"Activity Segment","text":"An activity involving changes in location, usually a journey from one place to another, such as a walk, a car drive, a bus ride, or a flight.
Example{\n\"activitySegment\": {\n\"startLocation\": {\n\"latitudeE7\": 414083590,\n\"longitudeE7\": 21704229,\n\"sourceInfo\": {\n\"deviceTag\": 1114211210\n}\n},\n\"endLocation\": {\n\"latitudeE7\": 413961889,\n\"longitudeE7\": 21536695,\n\"sourceInfo\": {\n\"deviceTag\": 1114211210\n}\n},\n\"duration\": {\n\"startTimestamp\": \"2022-03-03T12:22:24Z\",\n\"endTimestamp\": \"2022-03-03T12:43:34Z\"\n},\n\"distance\": 2640,\n\"activityType\": \"IN_BUS\",\n\"confidence\": \"HIGH\",\n\"activities\": [\n{\n\"activityType\": \"IN_BUS\",\n\"probability\": 85.6847882270813\n},\n{\n\"activityType\": \"WALKING\",\n\"probability\": 8.418431878089905\n},\n{\n\"activityType\": \"IN_PASSENGER_VEHICLE\",\n\"probability\": 2.8303226456046104\n},\n{\n\"activityType\": \"STILL\",\n\"probability\": 1.7383299767971039\n},\n{\n\"activityType\": \"IN_SUBWAY\",\n\"probability\": 0.4673520103096962\n},\n{\n\"activityType\": \"IN_TRAIN\",\n\"probability\": 0.3031305968761444\n},\n{\n\"activityType\": \"IN_TRAM\",\n\"probability\": 0.269505986943841\n},\n{\n\"activityType\": \"CYCLING\",\n\"probability\": 0.1483310479670763\n}\n],\n\"transitPath\": {\n\"transitStops\": [\n{\n\"latitudeE7\": 414083140,\n\"longitudeE7\": 21704000,\n\"placeId\": \"ChIJWey1zMWipBIRiNQSzpI4EDQ\",\n\"address\": \"08025 Barcelona\\nEspa\\u00f1a\",\n\"name\": \"Sant Antoni Maria Claret-Lepant\"\n},\n{\n\"latitudeE7\": 414066427,\n\"longitudeE7\": 21681608,\n\"placeId\": \"ChIJ3Wr_xsaipBIRctQDPNF0IHM\",\n\"address\": \"08025 Barcelona\\nEspa\\u00f1a\",\n\"name\": \"Sant Antoni Maria Claret - Sardenya\"\n},\n{\n\"latitudeE7\": 414049343,\n\"longitudeE7\": 21659001,\n\"placeId\": \"ChIJh2lnv8CipBIRpH0ym2Bxo68\",\n\"address\": \"08025 Barcelona\\nEspa\\u00f1a\",\n\"name\": \"Sant Antoni Maria Claret - N\\u00e0pols\"\n}\n],\n\"name\": \"H8\",\n\"hexRgbColor\": \"009EE0\",\n\"linePlaceId\": \"ChIJQVEUoLuipBIRJO37wI4yyBs\",\n\"stopTimesInfo\": [\n{\n\"scheduledDepartureTimestamp\": \"2022-03-03T12:42:00Z\",\n\"realtimeDepartureTimestamp\": \"2022-03-03T12:43:37Z\"\n},\n{\n\"scheduleArrivalTimestamp\": \"2022-03-03T12:44:01Z\",\n\"scheduledDepartureTimestamp\": \"2022-03-03T12:44:01Z\",\n\"realtimeArrivalTimestamp\": \"2022-03-03T12:45:38Z\",\n\"realtimeDepartureTimestamp\": \"2022-03-03T12:45:38Z\"\n},\n{\n\"scheduleArrivalTimestamp\": \"2022-03-03T12:46:03Z\",\n\"scheduledDepartureTimestamp\": \"2022-03-03T12:46:03Z\",\n\"realtimeArrivalTimestamp\": \"2022-03-03T12:47:40Z\",\n\"realtimeDepartureTimestamp\": \"2022-03-03T12:47:40Z\"\n},\n{\n\"scheduleArrivalTimestamp\": \"2022-03-03T12:48:00Z\",\n\"scheduledDepartureTimestamp\": \"2022-03-03T12:48:00Z\",\n\"realtimeArrivalTimestamp\": \"2022-03-03T12:49:37Z\",\n\"realtimeDepartureTimestamp\": \"2022-03-03T12:49:37Z\"\n}\n],\n\"source\": \"INFERRED\",\n\"confidence\": 0.9155850640140931,\n\"distanceMeters\": 2341.0\n},\n\"simplifiedRawPath\": {\n\"points\": [\n{\n\"latE7\": 414032766,\n\"lngE7\": 21641819,\n\"accuracyMeters\": 10,\n\"timestamp\": \"2022-03-03T12:27:48Z\"\n},\n{\n\"latE7\": 414016705,\n\"lngE7\": 21661614,\n\"accuracyMeters\": 13,\n\"timestamp\": \"2022-03-03T12:30:04Z\"\n},\n{\n\"latE7\": 413986545,\n\"lngE7\": 21623960,\n\"accuracyMeters\": 12,\n\"timestamp\": \"2022-03-03T12:33:51Z\"\n},\n{\n\"latE7\": 413976870,\n\"lngE7\": 21610201,\n\"accuracyMeters\": 11,\n\"timestamp\": \"2022-03-03T12:37:09Z\"\n},\n{\n\"latE7\": 413968976,\n\"lngE7\": 21609892,\n\"accuracyMeters\": 13,\n\"timestamp\": \"2022-03-03T12:38:50Z\"\n},\n{\n\"latE7\": 413955345,\n\"lngE7\": 21551848,\n\"accuracyMeters\": 11,\n\"timestamp\": \"2022-03-03T12:42:06Z\"\n}\n],\n\"source\": \"INFERRED\",\n\"distanceMeters\": 2413.400132766728\n}\n}\n}\nactivities\u200b[] Activitiesarray of: object\u00a0\u00a0(Activity)List of all the considered candidate activity types and their probabilities. The sum of all the probabilities is always <= 100. activityType Activity Typestring\u00a0\u00a0(Activity Type)Example: \"WALKING\"Best match activity type. Corresponds to the activity type with the highest probability in activities. confidence ConfidencestringExample: \"HIGH\"Confidence that the chosen activity type (see activityType) is correct. One of: LOW, MEDIUM, HIGH or UNKNOWN_CONFIDENCE. Activities that have been manually confirmed always have a confidence of HIGH. distance DistanceintegerExample: 292Distance traveled during the activity, in meters. duration Durationobject\u00a0\u00a0(Duration)Duration of the activity. editActionMetadata Edit-Action Metadataobject\u00a0\u00a0(Edit-Action Metadata) editConfirmationStatus Edit-Confirmation StatusstringExample: \"CONFIRMED\"Whether the user has manually edited the activity segment. Can be NOT_CONFIRMED or CONFIRMED. endLocation End Locationobject\u00a0\u00a0(Location)End location of the activity. lastEditedTimestamp Last-Edited Timestampstring\u00a0\u00a0(date-time)Example: \"2022-03-06T14:13:11.092Z\" parkingEvent Parking Eventobject\u00a0\u00a0(Parking Event) simplifiedRawPath Simplified Raw Pathobject\u00a0\u00a0(Simplified Raw Path) startLocation Start Locationobject\u00a0\u00a0(Location)Start location of the activity. transitPath Transit Pathobject\u00a0\u00a0(Transit Path)Path taken in a public transit system, such as a bus or a metro. waypointPath Waypoint Pathobject\u00a0\u00a0(Waypoint Path)"},{"location":"reference/semantic/#/$defs/placeVisit/","title":"Place Visit","text":"A visit or stay at a place in a fixed location for a duration of time, such as a stay at home, at work, a visit to a shopping mall, or to a restaurant.
Property DescriptioncenterLatE7 Center LatitudeintegerExample: 414216106Latitude coordinate of the location. Degrees multiplied by 10^7 and rounded to the nearest integer, in the range -900000000 to +900000000 (divide value by 10^7 for the usual range -90\u00b0 to +90\u00b0). centerLngE7 Center LongitudeintegerExample: 21684775Longitude coordinate of the location. Degrees multiplied by 10^7 and rounded to the nearest integer, in the range -1800000000 to +1800000000 (divide value by 10^7 for the usual range -180\u00b0 to +180\u00b0). checkin Checkinobject\u00a0\u00a0(Checkin) Help Wanted: The meaning of this field is uncertain. Contributions to improve this are welcome. childVisits\u200b[] Child Visitsarray of: object\u00a0\u00a0(Place Visit) duration Durationobject\u00a0\u00a0(Duration)Duration of the place visit. editActionMetadata Edit-Action Metadataobject\u00a0\u00a0(Edit-Action Metadata) editConfirmationStatus Edit-Confirmation StatusstringExample: \"CONFIRMED\"Whether the user has manually edited the place visit. Can be NOT_CONFIRMED or CONFIRMED. lastEditedTimestamp Last-Edited Timestampstring\u00a0\u00a0(date-time)Example: \"2022-03-06T14:13:11.092Z\" location Locationobject\u00a0\u00a0(Location)Location of the place. locationAssertionType Location Assertion TypestringExample: \"AREA\" locationConfidence Visit ConfidenceintegerExample: 71 Help Wanted: How is this different from visitConfidence Contributions to improve this are welcome. otherCandidateLocations\u200b[] Other Candidate Locationsarray of: object\u00a0\u00a0(Location) placeConfidence Place ConfidencestringExample: \"HIGH\"Categorized confidence for this place visit. One of: LOW_CONFIDENCE, MEDIUM_CONFIDENCE, HIGH_CONFIDENCE or USER_CONFIRMED. Help Wanted: Is this directly related to locationConfidence and/or visitConfidence Contributions to improve this are welcome. placeVisitImportance Place Visit ImportancestringExample: \"MAIN\"One of MAIN or TRANSITIONAL. placeVisitLevel Place Visit LevelintegerExample: 1Level (depth) of this place visit. This value increases by 1 with each recursive access to a childVisits entry. placeVisitType Place Visit TypestringExample: \"SINGLE_PLACE\"Can be SINGLE_PLACE. Help Wanted: Are there other valid values? Contributions to improve this are welcome. sectionId Section IDstring simplifiedRawPath Simplified Raw Pathobject\u00a0\u00a0(Simplified Raw Path) visitConfidence Visit ConfidenceintegerExample: 95 Help Wanted: How is this different from locationConfidence Contributions to improve this are welcome."},{"location":"reference/semantic/#/$defs/activity/","title":"Activity","text":"Example {\n\"activityType\": \"WALKING\",\n\"probability\": 95.93904614448547\n}\nactivityType Activity Typestring\u00a0\u00a0(Activity Type)Example: \"STILL\"Type of activity. probability ProbabilitynumberExample: 95.93904614448547Probability (or confidence) that the activity type is correct, in the range 0 to 100."},{"location":"reference/semantic/#/$defs/activityType/","title":"Activity Type","text":"Activity Type Description BOATING Boating CATCHING_POKEMON Catching Pok\u00e9mon CYCLING Cycling FLYING Flying HIKING Hiking HORSEBACK_RIDING Horseback riding IN_BUS On a bus IN_CABLECAR In a cable car IN_FERRY On a ferry IN_FUNICULAR On a funicular IN_GONDOLA_LIFT In a gondola lift IN_PASSENGER_VEHICLE Driving IN_SUBWAY On the subway IN_TAXI In a taxi IN_TRAIN On a train IN_TRAM On a tram IN_VEHICLE In a vehicle IN_WHEELCHAIR By wheelchair KAYAKING Kayaking KITESURFING Kitesurfing MOTORCYCLING Motorcycling PARAGLIDING Paragliding ROWING Rowing RUNNING Running SAILING Sailing SKATEBOARDING Skateboarding SKATING Skating SKIING Skiing SLEDDING Sledding SNOWBOARDING Snowboarding SNOWMOBILE Snowmobiling SNOWSHOEING Snowshoeing STILL Still SURFING Surfing SWIMMING Swimming UNKNOWN_ACTIVITY_TYPE Moving WALKING Walking WALKING_NORDIC Nordic walking"},{"location":"reference/semantic/#/$defs/duration/","title":"Duration","text":"Duration of time defined by a start timestamp and an end timestamp.
Example{\n\"startTimestamp\": \"2022-02-02T10:41:08.315Z\",\n\"endTimestamp\": \"2022-02-02T10:45:09.962Z\"\n}\nendTimestamp End Timestampstring\u00a0\u00a0(date-time)Example: \"2022-02-02T10:45:09.962Z\" startTimestamp Start Timestampstring\u00a0\u00a0(date-time)Example: \"2022-02-02T10:41:08.315Z\""},{"location":"reference/semantic/#/$defs/editActionMetadata/","title":"Edit-Action Metadata","text":"Property Description activitySegment Activity Segmentobject\u00a0\u00a0(Activity Segment) editHistory Edit Historyobject\u00a0\u00a0(Edit History) originalCandidates Original Candidatesobject\u00a0\u00a0(Original Candidates) placeVisitSegment Place Visit Segmentobject\u00a0\u00a0(Place Visit Segment)"},{"location":"reference/semantic/#/$defs/location/","title":"Location","text":"Example {\n\"latitudeE7\": 414036299,\n\"longitudeE7\": 21743558,\n\"placeId\": \"ChIJk_s92NyipBIRUMnDG8Kq2Js\",\n\"address\": \"C/ de Mallorca, 401\\n08013 Barcelona\\nEspanya\",\n\"name\": \"La Sagrada Familia\",\n\"semanticType\": \"TYPE_SEARCHED_ADDRESS\",\n\"sourceInfo\": {\n\"deviceTag\": 1234567890\n},\n\"locationConfidence\": 87.07311,\n\"calibratedProbability\": 76.20023\n}\naccuracyMetres Accuracy in metersintegerExample: 19Approximate accuracy radius of the location measurement, in meters. A lower value means better precision. address AddressstringExample: \"C/ de Mallorca, 401\\n08013 Barcelona\\nEspanya\"Address of the location. calibratedProbability Calibrated ProbabilitynumberExample: 100.0 isCurrentLocation Is Current LocationbooleanExample: true latitudeE7 LatitudeintegerExample: 414216106Latitude coordinate of the location. Degrees multiplied by 10^7 and rounded to the nearest integer, in the range -900000000 to +900000000 (divide value by 10^7 for the usual range -90\u00b0 to +90\u00b0). locationConfidence Location ConfidencenumberExample: 100.0 longitudeE7 LongitudeintegerExample: 21684775Longitude coordinate of the location. Degrees multiplied by 10^7 and rounded to the nearest integer, in the range -1800000000 to +1800000000 (divide value by 10^7 for the usual range -180\u00b0 to +180\u00b0). name NamestringExample: \"La Sagrada Familia\"Name of the location. placeId Place IDstringExample: \"ChIJk_s92NyipBIRUMnDG8Kq2Js\"Google Maps Place ID of the location. semanticType Semantic Typestring\u00a0\u00a0(Semantic Type)Example: \"TYPE_HOME\"Place type based on semantic information specific to the user. sourceInfo Source Informationobject\u00a0\u00a0(Source Information)Information on the source that provided the location."},{"location":"reference/semantic/#/$defs/parkingEvent/","title":"Parking Event","text":"Example {\n\"location\": {\n\"latitudeE7\": 412518975,\n\"longitudeE7\": 21683133,\n\"accuracyMetres\": 19\n},\n\"method\": \"EXITING_VEHICLE_SIGNAL\",\n\"locationSource\": \"FROM_RAW_LOCATION\",\n\"timestamp\": \"2022-02-27T14:47:16.731Z\"\n}\nlocation Locationobject\u00a0\u00a0(Location) locationSource Location SourcestringExample: \"FROM_RAW_LOCATION\" method MethodstringExample: \"EXITING_VEHICLE_SIGNAL\" timestamp Timestampstring\u00a0\u00a0(date-time)Example: \"2022-02-27T14:47:16.731Z\""},{"location":"reference/semantic/#/$defs/simplifiedRawPath/","title":"Simplified Raw Path","text":"Example {\n\"points\": [\n{\n\"latE7\": 416032766,\n\"lngE7\": 21841819,\n\"accuracyMeters\": 10,\n\"timestamp\": \"2022-03-03T08:27:48Z\"\n},\n{\n\"latE7\": 416016705,\n\"lngE7\": 21861614,\n\"accuracyMeters\": 13,\n\"timestamp\": \"2022-03-03T08:30:04Z\"\n},\n{\n\"latE7\": 415986545,\n\"lngE7\": 21823960,\n\"accuracyMeters\": 12,\n\"timestamp\": \"2022-03-03T08:33:51Z\"\n}\n],\n\"source\": \"INFERRED\",\n\"distanceMeters\": 2413.400132766728\n}\ndistanceMeters Distance in metersnumberExample: 2413.400132766728Distance traveled with the path, in meters. points\u200b[] Pointsarray of: object\u00a0\u00a0(Point)List of all the recorded points that form the path. source SourcestringExample: \"INFERRED\"Source of the location data of the path. One of BACKFILLED, INFERRED, or RESNAPPED_FOR_EDIT."},{"location":"reference/semantic/#/$defs/transitPath/","title":"Transit Path","text":"A path taken in a public transit system, such as a bus or a metro. Note that it does not describe an entire transit line, but only a specific journey a user does in a transit line.
Example{\n\"transitStops\": [\n{\n\"latitudeE7\": 414083140,\n\"longitudeE7\": 21704000,\n\"placeId\": \"ChIJWey1zMWipBIRiNQSzpI4EDQ\",\n\"address\": \"08025 Barcelona\\nEspa\\u00f1a\",\n\"name\": \"Sant Antoni Maria Claret-Lepant\"\n},\n{\n\"latitudeE7\": 414066427,\n\"longitudeE7\": 21681608,\n\"placeId\": \"ChIJ3Wr_xsaipBIRctQDPNF0IHM\",\n\"address\": \"08025 Barcelona\\nEspa\\u00f1a\",\n\"name\": \"Sant Antoni Maria Claret - Sardenya\"\n},\n{\n\"latitudeE7\": 414049343,\n\"longitudeE7\": 21659001,\n\"placeId\": \"ChIJh2lnv8CipBIRpH0ym2Bxo68\",\n\"address\": \"08025 Barcelona\\nEspa\\u00f1a\",\n\"name\": \"Sant Antoni Maria Claret - N\\u00e0pols\"\n}\n],\n\"name\": \"H8\",\n\"hexRgbColor\": \"009EE0\",\n\"linePlaceId\": \"ChIJQVEUoLuipBIRJO37wI4yyBs\",\n\"stopTimesInfo\": [\n{\n\"scheduledDepartureTimestamp\": \"2022-03-03T12:42:00Z\",\n\"realtimeDepartureTimestamp\": \"2022-03-03T12:43:37Z\"\n},\n{\n\"scheduleArrivalTimestamp\": \"2022-03-03T12:44:01Z\",\n\"scheduledDepartureTimestamp\": \"2022-03-03T12:44:01Z\",\n\"realtimeArrivalTimestamp\": \"2022-03-03T12:45:38Z\",\n\"realtimeDepartureTimestamp\": \"2022-03-03T12:45:38Z\"\n},\n{\n\"scheduleArrivalTimestamp\": \"2022-03-03T12:46:03Z\",\n\"scheduledDepartureTimestamp\": \"2022-03-03T12:46:03Z\",\n\"realtimeArrivalTimestamp\": \"2022-03-03T12:47:40Z\",\n\"realtimeDepartureTimestamp\": \"2022-03-03T12:47:40Z\"\n},\n{\n\"scheduleArrivalTimestamp\": \"2022-03-03T12:48:00Z\",\n\"scheduledDepartureTimestamp\": \"2022-03-03T12:48:00Z\",\n\"realtimeArrivalTimestamp\": \"2022-03-03T12:49:37Z\",\n\"realtimeDepartureTimestamp\": \"2022-03-03T12:49:37Z\"\n}\n],\n\"source\": \"INFERRED\",\n\"confidence\": 0.9155850640140931,\n\"distanceMeters\": 2341.0\n}\nconfidence ConfidencenumberExample: 0.9155850640140931 distanceMeters Distance in metersnumberExample: 396.34176716755843Distance traveled with the transit path, in meters. hexRgbColor Hexadecimal RGB ColorstringExample: \"009EE0\"Color of the transit line in hexadecimal in the form RRGGBB. linePlaceId Line Place IDstringExample: \"ChIJQVEUoLuipBIRJO37wI4yyBs\"Google Maps Place ID of the transit line. name NamestringExample: \"H8\"Name of the transit line. source SourcestringExample: \"INFERRED\"Source of the location data of the transit path. Either BACKFILLED or INFERRED. stopTimesInfo\u200b[] Stop Times Infoarray of: object\u00a0\u00a0(Stop Time Info)Time information (departure and arrival times, both real and scheduled) for each transit stop used. transitStops\u200b[] Transit Stopsarray of: object\u00a0\u00a0(Location)List of locations of the transit stops used."},{"location":"reference/semantic/#/$defs/activitySegment/properties/waypointPath/","title":"Waypoint Path","text":"Example {\n\"waypoints\": [\n{\n\"latE7\": 416119834,\n\"lngE7\": 21768624\n},\n{\n\"latE7\": 416117012,\n\"lngE7\": 21899302\n},\n{\n\"latE7\": 416119262,\n\"lngE7\": 21802315\n}\n],\n\"source\": \"INFERRED\",\n\"distanceMeters\": 396.34176716755843,\n\"travelMode\": \"WALK\",\n\"confidence\": 0.7986568220419046\n}\nconfidence ConfidencenumberExample: 0.7986568220419046 distanceMeters Distance in metersnumberExample: 396.34176716755843Total distance of the path, in meters. roadSegment\u200b[] Road Segmentarray of: object\u00a0\u00a0(Road Segment) source SourcestringExample: \"INFERRED\"Source of the location data of the path. Either BACKFILLED or INFERRED. travelMode Travel ModestringExample: \"WALK\" waypoints\u200b[] Waypointsarray of: object\u00a0\u00a0(Waypoint)"},{"location":"reference/semantic/#/$defs/placeVisit/properties/checkin/","title":"Checkin","text":"Help Wanted: The meaning of this field is uncertain. Contributions to improve this are welcome.
Property DescriptionatTime At Timestring\u00a0\u00a0(date-time)Example: \"2022-03-06T14:13:11.092Z\" device Deviceobject\u00a0\u00a0(Device) latestKnownLocation Latest Known Locationobject\u00a0\u00a0(Latest Known Location)"},{"location":"reference/semantic/#/$defs/editActionMetadata/properties/activitySegment/","title":"Activity Segment","text":"Property Description activityConfidence ConfidencenumberExample: 98.705695 activityType Activity Typestring\u00a0\u00a0(Activity Type)Example: \"WALKING\""},{"location":"reference/semantic/#/$defs/editActionMetadata/properties/editHistory/","title":"Edit History","text":"Property Description editEvent\u200b[] Edit Eventarray of: object\u00a0\u00a0(Edit Event)"},{"location":"reference/semantic/#/$defs/editActionMetadata/properties/originalCandidates/","title":"Original Candidates","text":"Property Description placeVisitSegment Place Visit Segmentobject\u00a0\u00a0(Place Visit Segment)"},{"location":"reference/semantic/#/$defs/editActionMetadata/properties/placeVisitSegment/","title":"Place Visit Segment","text":"Property Description location Locationobject\u00a0\u00a0(Location)"},{"location":"reference/semantic/#/$defs/semanticType/","title":"Semantic Type","text":"Place type based on semantic information specific to the user.
Semantic Type DescriptionTYPE_ALIASED_LOCATION Type Aliased LocationThe place has been given a private label by the user. See: Give a place a private label. TYPE_HOME Type HomeThe place has been designated as 'Home' by the user. See: Set or change your home & work addresses. TYPE_SEARCHED_ADDRESS Type Searched AddressThe user has searched for this place in the past. TYPE_WORK Type WorkThe place has been designated as 'Work' by the user. See: Set or change your home & work addresses."},{"location":"reference/semantic/#/$defs/location/properties/sourceInfo/","title":"Source Information","text":"Information on the source that provided the location.
Property DescriptiondeviceTag Device TagintegerExample: 1234567890Integer identifier (specific to Location History) associated with the device that obtained the location. Refer to deviceSettings in Settings.json for information about the device with this deviceTag."},{"location":"reference/semantic/#/$defs/point/","title":"Point","text":"Example {\n\"latE7\": 416032766,\n\"lngE7\": 21841819,\n\"accuracyMeters\": 10,\n\"timestamp\": \"2022-03-03T08:27:48Z\"\n}\naccuracyMeters Accuracy in metersintegerExample: 10Approximate accuracy radius of the location measurement, in meters. A lower value means better precision. latE7 LatitudeintegerExample: 414216106Latitude coordinate of the point. Degrees multiplied by 10^7 and rounded to the nearest integer, in the range -900000000 to +900000000 (divide value by 10^7 for the usual range -90\u00b0 to +90\u00b0). lngE7 LongitudeintegerExample: 21684775Longitude coordinate of the point. Degrees multiplied by 10^7 and rounded to the nearest integer, in the range -1800000000 to +1800000000 (divide value by 10^7 for the usual range -180\u00b0 to +180\u00b0). timestamp Timestampstring\u00a0\u00a0(date-time)Example: \"2022-03-03T08:27:48Z\"Timestamp of the point."},{"location":"reference/semantic/#/$defs/transitPath/properties/stopTimesInfo/items/","title":"Stop Time Info","text":"Departure and/or arrival time information (both real and scheduled) for a stop at a transit line.
Example{\n\"scheduleArrivalTimestamp\": \"2022-03-03T12:44:01Z\",\n\"scheduledDepartureTimestamp\": \"2022-03-03T12:44:01Z\",\n\"realtimeArrivalTimestamp\": \"2022-03-03T12:45:38Z\",\n\"realtimeDepartureTimestamp\": \"2022-03-03T12:45:38Z\"\n}\nrealtimeArrivalTimestamp Realtime Arrival Timestampstring\u00a0\u00a0(date-time)Example: \"2022-03-03T12:45:38Z\" realtimeDepartureTimestamp Realtime Departure Timestampstring\u00a0\u00a0(date-time)Example: \"2022-03-03T12:45:38Z\" scheduleArrivalTimestamp Schedule Arrival Timestampstring\u00a0\u00a0(date-time)Example: \"2022-03-03T12:44:01Z\" scheduledDepartureTimestamp Scheduled Departure Timestampstring\u00a0\u00a0(date-time)Example: \"2022-03-03T12:44:01Z\""},{"location":"reference/semantic/#/$defs/activitySegment/properties/waypointPath/properties/roadSegment/items/","title":"Road Segment","text":"Property Description duration DurationstringExample: \"8s\" placeId Place IDstringExample: \"ChIJk_s92NyipBIRUMnDG8Kq2Js\"Google Maps Place ID of the location."},{"location":"reference/semantic/#/$defs/waypoint/","title":"Waypoint","text":"Example {\n\"latE7\": 414216106,\n\"lngE7\": 21684775\n}\nlatE7 LatitudeintegerExample: 414216106Latitude coordinate of the waypoint. Degrees multiplied by 10^7 and rounded to the nearest integer, in the range -900000000 to +900000000 (divide value by 10^7 for the usual range -90\u00b0 to +90\u00b0). lngE7 LongitudeintegerExample: 21684775Longitude coordinate of the waypoint. Degrees multiplied by 10^7 and rounded to the nearest integer, in the range -1800000000 to +1800000000 (divide value by 10^7 for the usual range -180\u00b0 to +180\u00b0)."},{"location":"reference/semantic/#/$defs/placeVisit/properties/checkin/properties/device/","title":"Device","text":"Property Description android Androidobject\u00a0\u00a0(Android)"},{"location":"reference/semantic/#/$defs/placeVisit/properties/checkin/properties/latestKnownLocation/","title":"Latest Known Location","text":"Property Description detectionTime Detection Timestring\u00a0\u00a0(date-time)Example: \"2022-03-06T14:13:11.092Z\" location Locationobject\u00a0\u00a0(Location)"},{"location":"reference/semantic/#/$defs/editActionMetadata/properties/editHistory/properties/editEvent/items/","title":"Edit Event","text":"Property Description editOperation\u200b[] Edit Operationarray of: string uiConfiguration UI Configurationobject\u00a0\u00a0(UI Configuration)"},{"location":"reference/semantic/#/$defs/editActionMetadata/properties/originalCandidates/properties/placeVisitSegment/","title":"Place Visit Segment","text":"Property Description placeVisitCandidate\u200b[] Place Visit Candidatearray of: object\u00a0\u00a0(Original Candidates)"},{"location":"reference/semantic/#/$defs/placeVisit/properties/checkin/properties/device/properties/android/","title":"Android","text":"Property Description fingerprint Fingerprintstring"},{"location":"reference/semantic/#/$defs/editActionMetadata/properties/editHistory/properties/editEvent/items/properties/uiConfiguration/","title":"UI Configuration","text":"Property Description uiActivitySegmentConfiguration UI Activity Segment ConfigurationstringExample: \"DEFAULT_ACTIVITY_SEGMENT_CONFIGURATION\" uiPlaceVisitConfiguration UI Place Visit ConfigurationstringExample: \"DEFAULT_PLACE_VISIT_CONFIGURATION\""},{"location":"reference/semantic/#/$defs/editActionMetadata/properties/originalCandidates/properties/placeVisitSegment/properties/placeVisitCandidate/items/","title":"Original Candidates","text":"Property Description location Locationobject\u00a0\u00a0(Location)"},{"location":"reference/settings/","title":"Settings.json","text":""},{"location":"reference/settings/#settingsjson-format-definition","title":"Settings.json Format Definition","text":"This page has been automatically generated from the schema Settings.schema.json.
The Settings.json file in a Google Takeout Location History extraction. Contains information about the Google account settings related to Location History, information about the devices associated, and other auxiliary metadata.
{\n\"createdTime\": \"2013-05-15T21:53:59.385Z\",\n\"modifiedTime\": \"2020-07-01T21:27:31.880Z\",\n\"historyEnabled\": true,\n\"deviceSettings\": [\n{\n\"deviceTag\": 1234567890,\n\"reportingEnabled\": true,\n\"legalCountryCode\": \"es\",\n\"devicePrettyName\": \"ONEPLUS A6013\",\n\"platformType\": \"ANDROID\",\n\"deviceCreationTime\": \"2019-01-07T18:13:23.713Z\",\n\"latestLocationReportingSettingChange\": {\n\"reportingEnabledModificationTime\": \"2019-01-07T18:13:24.673Z\"\n},\n\"androidOsLevel\": 28,\n\"deviceSpec\": {\n\"manufacturer\": \"OnePlus\",\n\"brand\": \"OnePlus\",\n\"product\": \"OnePlus6T\",\n\"device\": \"OnePlus6T\",\n\"model\": \"ONEPLUS A6013\",\n\"isLowRam\": false\n}\n}\n],\n\"retentionWindowDays\": 2147483647,\n\"hasReportedLocations\": true,\n\"hasSetRetention\": false\n}\ncreatedTime Created Timestring\u00a0\u00a0(date-time)Example: \"2013-05-15T21:53:59.385Z\"Timestamp (as an ISO 8601 string) when Location History was first available on this Google account. deviceSettings\u200b[] Device Settingsarray of: object\u00a0\u00a0(Device Settings)List of devices associated with the Location History information on this Google account. hasReportedLocations Has Reported LocationsbooleanExample: trueWhether this Google account has any reported Location History information. hasSetRetention Has Set RetentionbooleanExample: falseWhether this Google account has configured the auto-delete setting (retention) for the Location History data. Corresponds to the Auto-delete setting in the Activity Controls page.See also retentionWindowDays. historyEnabled History EnabledbooleanExample: trueWhether Location History is enabled on this Google account (controlled in the Activity Controls page). modifiedTime Modified Timestring\u00a0\u00a0(date-time)Example: \"2020-07-01T21:27:31.880Z\"Timestamp (as an ISO 8601 string) when any Location History setting was last modified on this Google account. retentionWindowDays Retention Window DaysintegerExample: 540Number of days the Location History information is retained in this Google account. Corresponds to the Auto-delete setting in the Activity Controls page.This value should be ignored if hasSetRetention is false."},{"location":"reference/settings/#/$defs/deviceSettings/","title":"Device Settings","text":"Information about a device associated with the Google Location History account.
Example{\n\"deviceTag\": 1234567890,\n\"reportingEnabled\": true,\n\"legalCountryCode\": \"es\",\n\"devicePrettyName\": \"ONEPLUS A6013\",\n\"platformType\": \"ANDROID\",\n\"deviceCreationTime\": \"2019-01-07T18:13:23.713Z\",\n\"latestLocationReportingSettingChange\": {\n\"reportingEnabledModificationTime\": \"2019-01-07T18:13:24.673Z\"\n},\n\"androidOsLevel\": 28,\n\"deviceSpec\": {\n\"manufacturer\": \"OnePlus\",\n\"brand\": \"OnePlus\",\n\"product\": \"OnePlus6T\",\n\"device\": \"OnePlus6T\",\n\"model\": \"ONEPLUS A6013\",\n\"isLowRam\": false\n}\n}\nandroidOsLevel Android OS LevelintegerExample: 28The version of the device's operating system (only applies to Android devices). Corresponds to the API Level (e.g. 28 is Android 9 Pie). deviceCreationTime Device Creation Timestring\u00a0\u00a0(date-time)Example: \"2019-01-07T18:13:23.713Z\"Timestamp (as an ISO 8601 string) of the first time this device was available for Location History reporting on this Google account. devicePrettyName Device Pretty NamestringExample: \"ONEPLUS A6013\"Pretty name of the device, recommended for user-facing applications. deviceSpec Device Specificationobject\u00a0\u00a0(Device Specification)Technical information and specifications about the device. deviceTag Device TagintegerExample: 1234567890Integer identifier (specific to Location History) of the device. latestLocationReportingSettingChange Latest Location Reporting Setting Changeobject\u00a0\u00a0(Latest Location Reporting Setting Change)Information on the latest change(s) to Location History settings on this Google account. Help Wanted: Are properties other than reportingEnabledModificationTime possible? Contributions to improve this are welcome. legalCountryCode Legal Country CodestringExample: \"es\"Two-letter ISO 3166 country code. Help Wanted: The meaning of this field is uncertain. Contributions to improve this are welcome. platformType Platform TypestringExample: \"ANDROID\"Platform of the device. Valid values are: ANDROID, IOS and UNKNOWN. reportingEnabled Reporting EnabledbooleanExample: trueWhether this device is configured to report Location History information (controlled in the Activity Controls page)."},{"location":"reference/settings/#/$defs/deviceSpec/","title":"Device Specification","text":"Technical information and specifications about a device.
Example{\n\"manufacturer\": \"OnePlus\",\n\"brand\": \"OnePlus\",\n\"product\": \"OnePlus6T\",\n\"device\": \"OnePlus6T\",\n\"model\": \"ONEPLUS A6013\",\n\"isLowRam\": false\n}\nbrand BrandstringExample: \"OnePlus\"Brand of the device. device DevicestringExample: \"OnePlus6T\"Name of the device. isLowRam Is Low RambooleanExample: falseWhether the device is considered low-ram. Help Wanted: Is it maybe related to Google Maps Go? Contributions to improve this are welcome. manufacturer ManufacturerstringExample: \"OnePlus\"Manufacturer of the device. model ModelstringExample: \"ONEPLUS A6013\"Model of the device. product ProductstringExample: \"OnePlus6T\"Product name of the device."},{"location":"reference/settings/#/$defs/deviceSettings/properties/latestLocationReportingSettingChange/","title":"Latest Location Reporting Setting Change","text":"Information on the latest change(s) to Location History settings on this Google account.
Help Wanted: Are properties other than reportingEnabledModificationTime possible? Contributions to improve this are welcome.
{\n\"reportingEnabledModificationTime\": \"2019-01-07T18:13:24.673Z\"\n}\nreportingEnabledModificationTime Reporting Enabled Modification TimestringExample: \"2019-01-07T18:13:24.673Z\"Time that Location History reporting was enabled or disabled for the last time on this Google account."},{"location":"reference/timeline-edits/","title":"Timeline Edits.json","text":""},{"location":"reference/timeline-edits/#timeline-editsjson-format-definition","title":"Timeline Edits.json Format Definition","text":"This page has been automatically generated from the schema TimelineEdits.schema.json.
This schema outlines the structure of timeline edits data, encompassing device information, place visit aggregates, and raw signal data from the device.
Property DescriptiontimelineEdits\u200b[] Timeline Editsarray of: object\u00a0\u00a0(Timeline Edit Information)List of all timeline edits."},{"location":"reference/timeline-edits/#/$defs/timelineEditsItem/","title":"Timeline Edit Information","text":"Various information about the timeline edit, including device ID, place aggregates, and raw signal data.
Example{\n\"deviceId\": \"0\",\n\"placeAggregates\": {\n\"placeAggregateInfo\": [\n{\n\"score\": 1228.0,\n\"numBucketsWithLocation\": 0,\n\"bucketSpanDays\": 0,\n\"point\": {\n\"latE7\": 429362473,\n\"lngE7\": -788308560\n},\n\"placeId\": \"ChIJV8SII64E1YkRvAqrnP5G_x8\",\n\"placePoint\": {\n\"latE7\": 429362442,\n\"lngE7\": -788308585\n}\n},\n{\n\"score\": 166.0,\n\"numBucketsWithLocation\": 0,\n\"bucketSpanDays\": 0,\n\"point\": {\n\"latE7\": 426994475,\n\"lngE7\": -778539281\n},\n\"placeId\": \"ChIJ4_FHs78TK4gRw8h22XkBDEA\",\n\"placePoint\": {\n\"latE7\": 426994650,\n\"lngE7\": -778539291\n}\n},\n{\n\"score\": 131.0,\n\"numBucketsWithLocation\": 0,\n\"bucketSpanDays\": 0,\n\"point\": {\n\"latE7\": 415908301,\n\"lngE7\": -739409850\n},\n\"placeId\": \"ChIJJRdROh863YkRmXCWQ14VMcI\",\n\"placePoint\": {\n\"latE7\": 415908776,\n\"lngE7\": -739409849\n}\n}\n],\n\"windowSizeHrs\": 2011,\n\"topRankedPlacesPlaceIds\": [\n\"ChIJV8SII64E1YkRvAqrnP5G_x8\",\n\"ChIJ4_FHs78TK4gRw8h22XkBDEA\",\n\"ChIJJRdROh863YkRmXCWQ14VMcI\"\n],\n\"processWindow\": {\n\"startTime\": \"2023-12-14T08:00:55Z\",\n\"endTime\": \"2024-03-07T08:00:55Z\"\n},\n\"metadata\": {\n\"platform\": \"UNKNOWN\"\n}\n}\n}\ndeviceId Device IDstringExample: \"0\"The unique identifier for the device that generated the data. placeAggregates Place Aggregatesobject\u00a0\u00a0(Place Aggregates)Aggregated information about places visited by the device. rawSignal Raw Signalobject\u00a0\u00a0(Raw Signal)Raw signal data from the device."},{"location":"reference/timeline-edits/#/$defs/timelineEditsItem/properties/placeAggregates/","title":"Place Aggregates","text":"Aggregated information about places visited by the device.
Property Descriptionmetadata Metadataobject\u00a0\u00a0(Metadata)Metadata about the data object. placeAggregateInfo\u200b[] Place Aggregate Informationarray of: object\u00a0\u00a0(Place Aggregate Info Item)An array of place information, including score, location, and place ID. processWindow Process Windowobject\u00a0\u00a0(Process Window)The start and end time of the processing window. topRankedPlacesPlaceIds\u200b[] Top Ranked Placesarray of: stringAn array of place IDs for the top-ranked places. windowSizeHrs Time Window SizeintegerExample: 2016The size of the window in hours for the place aggregates."},{"location":"reference/timeline-edits/#/$defs/timelineEditsItem/properties/rawSignal/","title":"Raw Signal","text":"Raw signal data from the device.
Example{\n\"signal\": {\n\"position\": {\n\"point\": {\n\"latE7\": 426974802,\n\"lngE7\": -778539156\n},\n\"accuracyMm\": 100000,\n\"altitudeMeters\": 224.0,\n\"source\": \"WIFI\",\n\"timestamp\": \"2024-02-17T04:14:41.412Z\"\n}\n},\n\"additionalTimestamp\": \"2024-02-17T04:14:39.545Z\",\n\"metadata\": {\n\"platform\": \"ANDROID\"\n}\n}\nadditionalTimestamp Additional Timestampstring\u00a0\u00a0(date-time)Example: \"2024-02-17T05:54:01.359Z\"An additional timestamp associated with the raw signal. metadata Metadataobject\u00a0\u00a0(Metadata)Metadata about the data object. signal Signalobject\u00a0\u00a0(Signal)The signal data, including position, activity record, and wifi scan."},{"location":"reference/timeline-edits/#/$defs/metadata/","title":"Metadata","text":"Metadata about the data object.
Property Descriptionplatform Device PlatformstringExample: \"ANDROID\"The platform that generated the data."},{"location":"reference/timeline-edits/#/$defs/timelineEditsItem/properties/placeAggregates/properties/placeAggregateInfo/items/","title":"Place Aggregate Info Item","text":"The place aggregate info containing score, location, place ID, and other details.
Property DescriptionbucketSpanDays Bucket SpanintegerExample: 0The span of the buckets in days. numBucketsWithLocation Number of BucketsintegerExample: 0The number of location buckets associated with the place. placeId Place IDstringExample: \"ChIJV8SII64E1YkRvAqrnP5G_x8\"The unique identifier for the place. placePoint Pointobject\u00a0\u00a0(Point)The geographical point. point Pointobject\u00a0\u00a0(Point)The geographical point. score ScorenumberExample: 1228.0The score assigned to the place."},{"location":"reference/timeline-edits/#/$defs/timelineEditsItem/properties/placeAggregates/properties/processWindow/","title":"Process Window","text":"The start and end time of the processing window.
Property DescriptionendTime End Timestring\u00a0\u00a0(date-time)Example: \"2024-03-07T08:00:55Z\"The end time of the processing window. startTime Start Timestring\u00a0\u00a0(date-time)Example: \"2023-12-14T08:00:55Z\"The start time of the processing window."},{"location":"reference/timeline-edits/#/$defs/signal/","title":"Signal","text":"The signal data, including position, activity record, and wifi scan.
Property DescriptionactivityRecord Activity Recordobject\u00a0\u00a0(Activity Record)The activity record data, including detected activities and timestamp. position Positionobject\u00a0\u00a0(Position)The position data, including point, accuracy, altitude, source, and timestamp. wifiScan Wifi Scan Dataobject\u00a0\u00a0(Wifi Scan Data)The wifi scan data, including delivery time, devices, and source."},{"location":"reference/timeline-edits/#/$defs/point/","title":"Point","text":"The geographical point.
Example{\n\"latE7\": 416032766,\n\"lngE7\": 21841819,\n\"accuracyMeters\": 10,\n\"timestamp\": \"2022-03-03T08:27:48Z\"\n}\nlatE7 LatitudeintegerExample: 439362473Latitude coordinate of the point. Degrees multiplied by 10^7 and rounded to the nearest integer, in the range -900000000 to +900000000 (divide value by 10^7 for the usual range -90\u00b0 to +90\u00b0). lngE7 LongitudeintegerExample: -788308560Longitude coordinate of the point. Degrees multiplied by 10^7 and rounded to the nearest integer, in the range -1800000000 to +1800000000 (divide value by 10^7 for the usual range -180\u00b0 to +180\u00b0)."},{"location":"reference/timeline-edits/#/$defs/signal/properties/activityRecord/","title":"Activity Record","text":"The activity record data, including detected activities and timestamp.
Property DescriptiondetectedActivities\u200b[] Detected Activitiesarray of: object\u00a0\u00a0(Detected Activity Item)An array of detected activities, including activity type and probability. timestamp Timestampstring\u00a0\u00a0(date-time)Example: \"2024-02-17T05:26:47.066Z\"The timestamp of the activity record."},{"location":"reference/timeline-edits/#/$defs/signal/properties/position/","title":"Position","text":"The position data, including point, accuracy, altitude, source, and timestamp.
Property DescriptionaccuracyMm Signal Position AccuracyintegerExample: 100000The accuracy of the position in millimeters. altitudeMeters AltitudenumberExample: 224.0The altitude of the position in meters. point Pointobject\u00a0\u00a0(Point)The geographical point. source Signal Position SourcestringExample: \"WIFI\"The source of the position data. speedMetersPerSecond SpeednumberExample: 0.0Speed in meters per second. timestamp Timestampstring\u00a0\u00a0(date-time)Example: \"2024-02-17T05:54:00.932Z\"The timestamp of the position data."},{"location":"reference/timeline-edits/#/$defs/signal/properties/wifiScan/","title":"Wifi Scan Data","text":"The wifi scan data, including delivery time, devices, and source.
Property DescriptiondeliveryTime Delivery Timestring\u00a0\u00a0(date-time)Example: \"2024-02-17T04:26:44.661Z\"The delivery time of the wifi scan. devices\u200b[] Wifi Devicesarray of: object\u00a0\u00a0(Wifi Device)An array of wifi devices, including mac address and raw RSSI. source Wifi Scan SourcestringExample: \"ACTIVE_SCAN\"The source of the wifi scan data."},{"location":"reference/timeline-edits/#/$defs/signal/properties/activityRecord/properties/detectedActivities/items/","title":"Detected Activity Item","text":"The detected activity item info containing activity type and probability.
Property DescriptionactivityType Activity TypestringExample: \"STILL\"The type of the detected activity. This could re-use the #/$defs/activityType from Records schema later. probability ProbabilitynumberExample: 0.96The probability of the detected activity."},{"location":"reference/timeline-edits/#/$defs/signal/properties/wifiScan/properties/devices/items/","title":"Wifi Device","text":"The wifi device info containing mac address and raw RSSI.
Property Descriptionmac MAC AddressstringExample: \"145830537259886\"The mac address of the wifi device. rawRssi Raw RSSIintegerExample: -51The raw RSSI of the wifi device."}]}
\ No newline at end of file
diff --git a/sitemap.xml b/sitemap.xml
new file mode 100644
index 0000000..a05c5b8
--- /dev/null
+++ b/sitemap.xml
@@ -0,0 +1,63 @@
+
+