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: true Whether this Google account has any reported Location History information.
hasSetRetention	Has Set Retention booleanExample: false Whether 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: true Whether 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: 540 Number 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: 28 The 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: 1234567890 Integer identifier (specific to Location History) of the device.
latestLocationReportingSettingChange	Latest Location Reporting Setting Change object  (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: true Whether 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: false Whether the device is considered low-ram. Help Wanted: Is it maybe related to Google Maps Go? Contributions to improve this are welcome.
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