Device Data Statistics

Feature Description

The device data statistics feature is mainly used to obtains device-related statistical information.

QuecDeviceStatisticsService

Data Statistics

Query Device's Historical Trajectory

API

Query a device's historical trajectory.

fun getLocationHistory(
    productKey: String,
    deviceKey: String,
    startTimestamp: Long,
    endTimestamp: Long,
    gatewayDk: String?,
    gatewayPk: String?,
    locateTypes: String?,
    callback: QuecCallback<List<QuecLocationHistoryModel>>
)

Parameter

Parameter	Required	Description
productKey	Y	ProductKey.
deviceKey	Y	DeviceKey.
startTimestamp	Y	Start time (timestamp in millisecond).
endTimestamp	Y	End time (timestamp in millisecond).
gatewayDk	N	Gateway DeviceKey.
gatewayPk	N	Gateway ProductKey.
locateTypes	N	Positioning type (query all types of positioning by default). Separate multiple positionings by commas. GNSS-Global Navigation Satellite System GPS-Global Positioning System GL-Global Navigation Satellite System GA-Galileo Positioning System BD/PQ-BeiDou Navigation Satellite System LBS-Location-Based Service
callback	Y	Callback function of the request.

QuecLocationHistoryModel Definition

Field	Type	Description
bdLat	Double	Device latitude (BD09).
bdLng	Double	Device longitude (BD09).
deviceKey	String	DeviceKey.
gcjLat	Double	Device latitude (GCJ02).
gcjLng	Double	Device longitude (GCJ02).
hdop	Double	Horizontal dilution of precision (0.5 – 99.99).
locateId	String	Trajectory ID.
locateType	int	Location method. 0-GNSS 1-LBS 2-Manual fixed-point
locationTime	String	Location time.
productKey	String	ProductKey.
satellites	int	Current number of satellites.
tsLocateTime	int	The latest positioning time (timestamp).
wgsLat	Double	Device latitude (WGS84).
wgsLng	Double	Device longitude (WGS84).

Example

QuecDeviceStatisticsService.getLocationHistory(
    "pk",
    "dk",
    System.currentTimeMillis() - 90000,
    System.currentTimeMillis(),
    null,
    null,
    "GNSS"
) {
    if (it.isSuccess) {
        val data = it.data //Query a device historical trajectory successfully.
    } else {
        val code = it.code //Failed. Error code.
        val msg = it.msg //Failed. Error message.
    }
}

Query List of Device Property Chart

API

Query a list of device property charts.

fun getPropertyChartList(
    productKey: String,
    deviceKey: String,
    startTimestamp: Long,
    endTimestamp: Long,
    attributeCode: String,
    gatewayDk: String?,
    gatewayPk: String?,
    countType: Int,
    timeGranularity: Int,
    callback: QuecCallback<List<QuecPropertyChartListModel>>
)

Parameter

Parameter	Required	Description
productKey	Y	ProductKey.
deviceKey	Y	DeviceKey.
startTimestamp	Y	Start time (timestamp in millisecond).
endTimestamp	Y	End time (timestamp in millisecond).
attributeCode	N	TSL model property identifier. Separate multiple properties by commas.
gatewayDk	N	Gateway DeviceKey.
gatewayPk	N	Gateway ProductKey.
countType	N	Aggregation type (Default value: 3). 1-Maximum 2-Minimum 3-Average 4-Difference.
timeGranularity	N	Statistical time granularity (Default value: 3). 1-Month 2-Day 3-Hour 4-Minute 5-Second
callback	Y	Callback function of the request.

QuecPropertyChartListModel Definition

Field	Type	Description
propertyCode	String	TSL code.
xaxisData	List<String>	Recording time.
xaxisDataTs	List<Double>	Timestamp.
yaxisData	List<Any>	Property content.

Example

QuecDeviceStatisticsService.getPropertyChartList(
    "pk",
    "dk",
    System.currentTimeMillis() - 90000,
    System.currentTimeMillis(),
    "temperature",
    null,
    null,
    3,
    1
) {
    if (it.isSuccess) {
        val data = it.data //Query a list of device property charts successfully.
    } else {
        val code = it.code //Failed. Error code.
        val msg = it.msg //Failed. Error message.
    }
}

Query Device Property MoM Statistical Data

API

Query device property MoM statistical data.

fun getPropertyStatisticsPath(
    productKey: String,
    deviceKey: String,
    currentTimestamp: Long,
    attributeCode: String,
    gatewayDk: String?,
    gatewayPk: String?,
    countType: Int,
    timeGranularities: String?,
    callback: QuecCallback<List<QuecPropertyStatisticsModel>>
)

Parameter

Parameter	Required	Description
productKey	Y	ProductKey.
deviceKey	Y	DeviceKey.
currentTimestamp	Y	Current time (timestamp in millisecond).
attributeCode	N	TSL model property identifier. Separate multiple properties by commas.
gatewayDk	N	Gateway DeviceKey.
gatewayPk	N	Gateway ProductKey.
countType	N	Aggregation type (Default value: 3). 1-Maximum 2-Minimum 3-Average 4-Difference.
timeGranularities	N	Statistical time granularity (Default value: 1). Separate multiple granularities by commas. 1-Day 2-Week 3-Month 4-Year
callback	Y	Callback function of the request.

QuecPropertyStatisticsModel Definition

Field	Type	Description
statValue	ListList<Any>	Current MoM value.
timeGranularity	int	Time units. 1-Day 2-Week 3-Month 4-Year

Example

QuecDeviceStatisticsService.getPropertyStatisticsPath(
    "pk",
    "dk",
    System.currentTimeMillis(),
    "temperature",
    null,
    null,
    3,
    "1,2,3"
) {
    if (it.isSuccess) {
        val data = it.data //Query device property MoM statistical data successfully.
    } else {
        val code = it.code //Failed. Error code.
        val msg = it.msg //Failed. Error message.
    }
}

Query Property Data List

API

Query a property data list.

fun getPropertyDataList(
    productKey: String,
    deviceKey: String,
    startTimestamp: Long,
    endTimestamp: Long,
    attributeCode: String,
    gatewayDk: String?,
    gatewayPk: String?,
    pageNumber: Int,
    pageSize: Int,
    callback: QuecCallback<QuecPageResponse<QuecPropertyDataListModel>>
)

Parameter

Parameter	Required	Description
productKey	Y	ProductKey.
deviceKey	Y	DeviceKey.
startTimestamp	Y	Start time (timestamp in millisecond).
endTimestamp	Y	End time (timestamp in millisecond).
attributeCode	N	TSL property identifier. Separate multiple properties by commas.
gatewayDk	N	Gateway DeviceKey.
gatewayPk	N	Gateway ProductKey.
pageNumber	N	Current Page. Default value: 1.
pageSize	N	Page size: Default value: 10.
callback	Y	Callback function of the request.

Example

QuecDeviceStatisticsService.getPropertyDataList(
    "pk",
    "dk",
    System.currentTimeMillis() - 90000,
    System.currentTimeMillis(),
    "temperature",
    null,
    null,
    1,
    10
) {
    if (it.isSuccess) {
        val data = it.data //Query a property data list successfully.
    } else {
        val code = it.code //Failed. Error code.
        val msg = it.msg //Failed. Error message.
    }
}