`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 `integer`Example: `20` Approximate 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 `integer`Example: `150` Altitude above the WGS84 reference ellipsoid, in meters.
`batteryCharging`	Battery Charging `boolean`Example: `true` Whether the device was charging its battery or not at the time of the record.
`deviceDesignation`	Device Designation `string`Example: `"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 `integer`Example: `1234567890` 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`.
`deviceTimestamp`	Device Timestamp `string` (`date-time`) Help Wanted: The meaning of this field is uncertain. Contributions to improve this are welcome.
`formFactor`	Form Factor `string`Example: `"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 `integer`Example: `270` Heading 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 `integer`Example: `414216106` 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°).
`locationMetadata[]`	Location Metadata array of: `object` (Location Metadata) Additional location metadata. List of different Wi-Fi scans associated with this location record.
`longitudeE7`	Longitude `integer`Example: `21684775` 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°).
`osLevel`	OS Level `integer`Example: `28` 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).
`placeId`	Place ID `string`Example: `"ChIJk_s92NyipBIRUMnDG8Kq2Js"` Google Maps Place ID of the location.
`platformType`	Platform Type `string`Example: `"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 `string`Example: `"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) `string`Example: `"1636403752674"` Removed around January 2022.Replaced by `timestamp`. Timestamp of the record as a Unix timestamp in milliseconds.
`velocity`	Velocity `integer`Example: `10` Measured velocity (ground speed) in meters per second.
`verticalAccuracy`	Vertical Accuracy `integer`Example: `10` Calculated 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[]`	Access Points array of: `object` (Access Point) List of Wi-Fi access points found with the scan.

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) `integer`Example: `2437` Frequency of the signal (in MHz) that the access point is using.
`isConnected`	Is Connected `boolean`Example: `true` Whether the device that scanned the access point is connected to it.
`mac`	MAC Address `string`Example: `"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 `integer`Example: `-34` Strength 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 `integer`Example: `100` Value 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`	Activity Type `string` (Activity Type)Example: `"STILL"` Type of activity detected.

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 `integer`Example: `100` Integer value of the property.
`name`	Name `string`Example: `"vehicle_personal_confidence"` Name of the property.
`type`	Type `string`Example: `"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

Records.json Format Definition¶

Records¶

Location Record¶

Wi-Fi Scan¶

Activity Record¶

Location Metadata¶

Access Point¶

Activity¶

Extra Activity Information¶

Activity Type¶

`Records.json` Format Definition¶