## 根据IMEI获取轨迹数据
### 接口说明
允许有线设备获取三个月内,时间跨度不超过2天的轨迹数据。
允许无线设备获取三个月内,时间跨度不超过60天的轨迹数据。
### 请求URL
{{url}}/v1/device/track/list
### HTTP请求方式
GET/POST
### 请求参数
(1)通用参数
参见:[通用参数](/2523136)
(2)私有参数
| 参数名称 | 参数类型 | 是否必填 | 参数说明 | 默认值 |
| --- | --- | --- | --- | --- | --- |
| imei | String | 是 | 设备imei号 | |
| startTime | String | 是 | 开始时间 格式yyyy-MM-dd HH:mm:ss | |
| endTime | String | 是 | 结束时间 格式yyyy-MM-dd HH:mm:ss | |
| mapType | String | 是 | 如果要显示在百度地图上,mapType=BAIDU此时返回的经纬度将经过baidu校准方式校准 如果要显示在google地图、腾讯地图或高德地图上,mapType=GOOGLE,此时返回的经纬度将经过google校准方式校准 mapType=WGS84,返回WGS84坐标,mapType如果不填,则返回WGS84原始经纬度 | WGS84 |
### 返回值
| 参数 | 类型 | 描述 |
| --- | --- | --- |
| code | Int | 返回码:0: 正确返回 其它: 失败。参考错误码说明 |
| success | Boolean | 成功:true;失败:false |
| message | String | 如果code不为0,会有相应的错误信息提示 |
| result | String | 结果 |
| timestamp | Long | 时间戳 |
#### result参数列表:
| 参数 | 类型 | 描述 |
| --- | --- | --- |
| lng | Double | 经度 |
| lat | Double | 纬度 |
| gpsTime | String | gps定位时间 格式yyyy-MM-dd HH:mm:ss |
| direction | Integer | 方位,正北开始的一个360度的极坐标方向 |
| gpsSpeed | Integer | GPS速度 |
| mileage| Integer | 里程统计(需设备连接ACC ),单位米;|
| accStatus | Integer | Acc状态 0:关闭 1:打开 |
#### 正确返回示例:
~~~
{
"code": 0,
"success": true,
"message": "Success",
"result": [
{
"lng": 121.53855338164662,
"lat": 29.86758205113003,
"gpsTime": "2021-10-16 08:42:06",
"direction": 44,
"gpsSpeed": 31,
"mileage":0
}
],
"timestamp": 1636343537081
}
~~~
#### 错误返回示例:
~~~
{
"code": 2001,
"success": false,
"message": "设备(868120243xxxxxx)不属于当前帐户!",
"result": "",
"timestamp": 1636343446272
}
~~~
- 目录
- 概述
- 使用场景
- 使用方法
- 协议格式
- 公共约定
- API简介
- 通信流程
- API列表
- 接口调用限制说明
- API详情
- 认证说明
- 通用参数
- 获取accessToken
- 刷新accessToken
- 注册设备到平台
- 根据账户获取设备信息
- 根据账户获取所有设备的最新定位数据
- 根据IMEI获取最新定位数据
- 根据IMEI获取设备详细信息
- 根据IMEI获取轨迹数据
- 获取设备支持的指令列表
- 指定设备发送指令
- 获取设备指令结果
- 根据用户名获取分组列表
- 创建分组
- 修改分组信息
- 删除分组
- 根据账户获取车辆列表
- 根据分组ID获取车辆列表
- 添加车辆
- 修改车牌
- 转移车辆(改变分组)
- 获取围栏列表
- 获取围栏相关车辆
- 新增围栏
- 删除围栏
- 围栏关联车辆
- 消息推送