## 根据账户获取所有设备的最新定位数据 ### 接口说明 获取一个账户名下所有设备最新位置信息。 ### 请求URL {{url}}/v1/device/location/list ### HTTP请求方式 GET/POST ### 请求参数 (1)通用参数 参见:[通用参数](/2523136) (2)私有参数 | 参数名称 | 参数类型 | 是否必填 | 参数说明 | 默认值 | | --- | --- | --- | --- | --- | --- | | userId | String | 是 | 用户ID | | | | 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": "868120273******", "status": 0, "lng": 121.675661, "lat": 29.871204, "gpsDirectionValue": 0, "expireFlag": 0, "gpsTime": "2021-09-22 19:37:18", "hbTime": "2021-09-22 19:48:25", "speed": 21, "accStatus": 0, "electricQuantity": 0, "mileage": 550028 } ], "timestamp": 1636343537081 } ~~~ #### 错误返回示例： ~~~ { "code": 1003, "success": false, "message": "用户不存在！", "result": "", "timestamp": 1636343446272 } ~~~