`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 Edits array of: `object` (Timeline Edit Information) List of all timeline edits.

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 `string`Example: `"0"` The unique identifier for the device that generated the data.
`placeAggregates`	Place Aggregates `object` (Place Aggregates) Aggregated information about places visited by the device.
`rawSignal`	Raw Signal `object` (Raw Signal) Raw signal data from the device.

Place Aggregates¶

Aggregated information about places visited by the device.

Property	Description
`metadata`	Metadata `object` (Metadata) Metadata about the data object.
`placeAggregateInfo[]`	Place Aggregate Information array of: `object` (Place Aggregate Info Item) An array of place information, including score, location, and place ID.
`processWindow`	Process Window `object` (Process Window) The start and end time of the processing window.
`topRankedPlacesPlaceIds[]`	Top Ranked Places array of: `string` An array of place IDs for the top-ranked places.
`windowSizeHrs`	Time Window Size `integer`Example: `2016` The 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`	Metadata `object` (Metadata) Metadata about the data object.
`signal`	Signal `object` (Signal) The signal data, including position, activity record, and wifi scan.

Metadata¶

Metadata about the data object.

Property	Description
`platform`	Device Platform `string`Example: `"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 `integer`Example: `0` The span of the buckets in days.
`numBucketsWithLocation`	Number of Buckets `integer`Example: `0` The number of location buckets associated with the place.
`placeId`	Place ID `string`Example: `"ChIJV8SII64E1YkRvAqrnP5G_x8"` The unique identifier for the place.
`placePoint`	Point `object` (Point) The geographical point.
`point`	Point `object` (Point) The geographical point.
`score`	Score `number`Example: `1228.0` The 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 `integer`Example: `439362473` Latitude 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 `integer`Example: `-788308560` Longitude 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 `integer`Example: `100000` The accuracy of the position in millimeters.
`altitudeMeters`	Altitude `number`Example: `224.0` The altitude of the position in meters.
`point`	Point `object` (Point) The geographical point.
`source`	Signal Position Source `string`Example: `"WIFI"` The source of the position data.
`speedMetersPerSecond`	Speed `number`Example: `0.0` Speed 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 `string`Example: `"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 `string`Example: `"STILL"` The type of the detected activity. This could re-use the `#/$defs/activityType` from Records schema later.
`probability`	Probability `number`Example: `0.96` The probability of the detected activity.

Wifi Device¶

The wifi device info containing mac address and raw RSSI.

Property	Description
`mac`	MAC Address `string`Example: `"145830537259886"` The mac address of the wifi device.
`rawRssi`	Raw RSSI `integer`Example: `-51` The raw RSSI of the wifi device.

Last update: 2024-03-24

Timeline Edits.json Format Definition¶

Timeline Edits Schema¶

Timeline Edit Information¶

Place Aggregates¶

Raw Signal¶

Metadata¶

Place Aggregate Info Item¶

Process Window¶

Signal¶

Point¶

Activity Record¶

Position¶

Wifi Scan Data¶

Detected Activity Item¶

Wifi Device¶

`Timeline Edits.json` Format Definition¶