## 根據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獲取車輛列表
- 添加車輛
- 修改車牌
- 轉移車輛(改變分組)
- 獲取圍欄列表
- 獲取圍欄相關車輛
- 新增圍欄
- 刪除圍欄
- 圍欄關聯車輛
- 消息推送