## 根據IMEI獲取最新定位數據
### 接口說明
獲取單個或多個設備最新的位置信息。
### 請求URL
{{url}}/v1/device/location/get
### HTTP請求方式
GET/POST
### 請求參數
(1)通用參數
參見:[通用參數](/2523136)
(2)私有參數
| 參數名稱 | 參數類型 | 是否必填 | 參數說明 | 默認值 |
| --- | --- | --- | --- | --- | --- |
| imeis | String | 是 | 設備imei號,多個中間用英文逗號隔開。 如果設備過多,建議采用POST方式(一次最多100個IMEI) | | |
| mapType | String | 否 | 如用于百度地圖,mapType=BAIDU此時返回經緯度將經過baidu校準方式校準 如用于谷歌地圖、騰訊地圖或高德地圖,mapType=GOOGLE,此時返回的經緯度將經過google校準方式校準 mapType=WGS84,返回WGS84坐標 mapType如果不填,則默認返回百度經緯度 | BAIDU |
### 返回值
| 參數 | 類型 | 描述 |
| --- | --- | --- |
| code | Int | 返回碼:0: 正確返回 其它: 失敗。參考錯誤碼說明 |
| success | Boolean | 成功:true;失敗:false |
| message | String | 如果code不為0,會有相應的錯誤信息提示 |
| result | String | 結果 |
| timestamp | Long | 時間戳 |
#### result參數列表:
| 參數 | 類型 | 描述 |
| --- | --- | --- |
| imei | String | 國際移動設備識別碼 |
| status | Integer | 設備狀態 0:離線 1:在線 |
| lng | Double | 經度 |
| lat | Double | 緯度 |
| gpsDirectionValue | Integer | 航向值 0~360 |
| expireFlag | Integer | 是否過期1-過期 0-未過期 |
| gpsTime | String | GPS定位時間 |
| hbTime | String | 心跳時間 |
| speed | Integer | 速度 (單位:km/h) |
| accStatus | Integer | Acc狀態 0:關閉 1:打開 |
| electricQuantity | Double | 設備電量(例:0.7 = 70%),部分設備型號不支持 |
| mileage| Integer | 里程統計,單位米;|
#### 正確返回示例:
~~~
{
"code": 0,
"success": true,
"message": "Success",
"result":[
{
"imei": "868120233******",
"status": 0,
"lng": 121.638406,
"lat": 29.878845,
"gpsDirectionValue":?0,
"expireFlag": 0,
"gpsTime": "2021-10-13 18:07:21",
"hbTime": "2021-10-13 18:05:11",
"speed": 46,
"accStatus": 1,
"electricQuantity": 0,
"mileage":?550028
}
],
"timestamp": 1636343537081
}
~~~
#### 錯誤返回示例:
~~~
{
"code": 2001,
"success": false,
"message": "設備(868120243xxxxxx)不屬于當前帳戶!",
"result": "",
"timestamp": 1636343446272
}
~~~
- 目錄
- 概述
- 使用場景
- 使用方法
- 協議格式
- 公共約定
- API簡介
- 通信流程
- API列表
- 接口調用限制說明
- API詳情
- 認證說明
- 通用參數
- 獲取accessToken
- 刷新accessToken
- 注冊設備到平臺
- 根據賬戶獲取設備信息
- 根據賬戶獲取所有設備的最新定位數據
- 根據IMEI獲取最新定位數據
- 根據IMEI獲取設備詳細信息
- 根據IMEI獲取軌跡數據
- 獲取設備支持的指令列表
- 指定設備發送指令
- 獲取設備指令結果
- 根據用戶名獲取分組列表
- 創建分組
- 修改分組信息
- 刪除分組
- 根據賬戶獲取車輛列表
- 根據分組ID獲取車輛列表
- 添加車輛
- 修改車牌
- 轉移車輛(改變分組)
- 獲取圍欄列表
- 獲取圍欄相關車輛
- 新增圍欄
- 刪除圍欄
- 圍欄關聯車輛
- 消息推送