parser/dev.hossain.timeline.model.record/LocationRecord

LocationRecord

@JsonClass(generateAdapter = true)

data class LocationRecord(val accuracy: Int?, val activeWifiScan: WifiScan?, val activity: List<ActivityRecord>?, val altitude: Int?, val batteryCharging: Boolean?, val deviceDesignation: String?, val deviceTag: Int?, val osLevel: Int?, val heading: Int?, val latitudeE7: Int?, val locationMetadata: List<LocationMetadata>?, val longitudeE7: Int?, val platformType: String?, val source: LocationRecordSource?, val timestamp: String, val velocity: Int?, val verticalAccuracy: Int?)

A specific location record. Contains the information obtained from a user's device at a specific moment in time and at a given location.

Constructors

LocationRecord

constructor(accuracy: Int?, activeWifiScan: WifiScan?, activity: List<ActivityRecord>?, altitude: Int?, batteryCharging: Boolean?, deviceDesignation: String?, deviceTag: Int?, osLevel: Int?, heading: Int?, latitudeE7: Int?, locationMetadata: List<LocationMetadata>?, longitudeE7: Int?, platformType: String?, source: LocationRecordSource?, timestamp: String, velocity: Int?, verticalAccuracy: Int?)

Properties

accuracy

val accuracy: Int?

Approximate accuracy radius of the location measurement, in meters. A lower value means better precision.

activeWifiScan

val activeWifiScan: WifiScan?

Information about the access points found in a Wi-Fi scan done by the device and associated with this location record.

activity

val activity: List<ActivityRecord>?

Detected activity information at this location, as a list of activity records at slightly different timestamps but all associated with this location record.

altitude

val altitude: Int?

Altitude above the WGS84 reference ellipsoid, in meters.

batteryCharging

val batteryCharging: Boolean?

Whether the device was charging its battery or not at the time of the record.

deviceDesignation

val deviceDesignation: String?

Common values found are: PRIMARY, UNKNOWN.

deviceTag

val deviceTag: Int?

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.

heading

val heading: Int?

Heading in degrees east of true north, from 0 to 359.

latitudeE7

val latitudeE7: Int?

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

val locationMetadata: List<LocationMetadata>?

Additional location metadata. List of different Wi-Fi scans associated with this location record.

longitudeE7

val longitudeE7: Int?

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

val osLevel: Int?

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).

platformType

val platformType: String?

Platform of the device that provided this record. Valid values are: ANDROID, IOS and UNKNOWN.

source

val source: LocationRecordSource?

Source (technology) that provided the location information for this record. Common values are: WIFI, CELL, GPS, UNKNOWN (note: sometimes found in lowercase).

timestamp

val timestamp: String

Timestamp (as an ISO 8601 string) of the record.

velocity

val velocity: Int?

Measured velocity (ground speed) in meters per second.

verticalAccuracy

val verticalAccuracy: Int?

Calculated accuracy of the location's altitude measurement, in meters. A lower value means better precision.