获取设备轨迹信息(API名称:getTrailList)
功能介绍
用于获取设备轨迹信息。
相关接口
|
接口名称 |
调用说明 |
|---|---|
|
调用该接口获取到Token,再调用其他接口时,需要在请求消息头中添加“Authorization”,其值即为Token。 |
URL
|
请求方式 |
HTTPS地址 |
服务架构 |
消息体类型 |
|---|---|---|---|
|
POST |
https://isdp+域名/openapi/v1/helmet/getTrailList |
OpenAPI |
application/json |
请求头
|
KEY |
VALUE |
是否必填 |
描述 |
|---|---|---|---|
|
Content-Type |
application/json |
是 |
无 |
|
Authorization |
bearer ${access_token} |
是 |
bearer +“ ”+5.2.1中获取的access_token的值 |
请求参数
|
参数 |
类型 |
是否必填 |
描述 |
|---|---|---|---|
|
page |
Object |
否 |
分页参数 |
|
start |
Integer |
否 |
当前页码,分页参数,page子项 |
|
count |
Integer |
否 |
每页条数,分页参数,page子项 |
|
isdpDeviceId |
String |
否 |
设备唯一编码 |
|
startTime |
String |
是 |
开始时间 |
|
endTime |
String |
是 |
结束时间 |
|
coordType |
String |
否 |
坐标分类 |
响应参数
|
字段名 |
数据类型 |
描述 |
|---|---|---|
|
id |
Long |
主键Id |
|
tenantId |
Long |
租户Id |
|
isdpDeviceId |
String |
设备唯一ID |
|
startTime |
Date |
开始时间 |
|
startLongitude |
String |
开始经度 |
|
startLatitude |
String |
结束纬度 |
|
startAddress |
String |
开始地址 |
|
endTime |
Date |
结束时间 |
|
endLongitude |
String |
结束经度 |
|
endLatitude |
String |
结束纬度 |
|
endAddress |
String |
结束地址 |
|
status |
String |
状态 |
|
coordType |
String |
坐标类型 |
请求示例
{
"isdpDeviceId": "FBA_YS001--1",
"startTime": "2022-05-22 10:30:06",
"endTime": "2022-05-27 10:30:06",
"page": {
"pageSize": 10,
"pageNo": 1
},
"coordType": "BD09"
}
响应示例
{
"data": {
"list": [
{
"COORDTYPE": "BD09",
"ENDADDRESS": "广东省东莞市xxxxxxxx",
"ENDLATITUDE": "22.890076631807478",
"ENDLONGITUDE": "113.89738100046407",
"ENDTIME": 1653550756000,
"ID": 142972,
"ISDPDEVICEID": "FBA_YS001--1",
"STARTADDRESS": "广东省东莞市xxxxxxxx",
"STARTLATITUDE": "22.890059838666158",
"STARTLONGITUDE": "113.89739267786578",
"STARTTIME": 1653550697000,
"STATUS": "FINISH",
"TENANTID": 886
}
],
"pageNo": 1,
"pageSize": 15,
"totalCount": 1
},
"error": null,
"message": "SUCCESS",
"status": 1,
"timestamp": "2024-01-18T13:56:30.767+0800"
}