Appearance
根据IMEI获取最新定位数据
接口说明
获取单个或多个设备最新的位置信息
请求URL
本接口通用参数里面method的值为jimi.device.location.get
HTTP请求方式
GET/POST
请求参数
(1)通用参数
参见: 通用参数
(2)私有参数
| 参数名称 | 参数类型 | 是否必填 | 默认值 | 描述 |
|---|---|---|---|---|
| access_token | String | 是 | 访问令牌,表明其是一个合法第三方 | |
| imeis | String | 是 | 无 | 设备imei号,多个中间用英文逗号隔开。 如果设备过多,建议采用POST方式(一次最多100个IMEI) |
| map_type | String | 否 | 无 | 如果要显示在百度地图上,map_type=BAIDU此时返回的经纬度将经过baidu校准方式校准 如果要显示在google、高德、腾讯地图上,map_type=GOOGLE,此时返回的经纬度将经过google校准方式校准 map_type如果不填,则返回原始经纬度 |
返回值
| 参数 | 类型 | 描述 |
|---|---|---|
| code | Int | 返回码: 0: 正确返回 其它: 失败。参考错误码说明 |
| message | String | 如果code不为0,会有相应的错误信息提示 |
| result | String | 返回的数据 |
result参数列表:
| 参数 | 类型 | 描述 |
|---|---|---|
| imei | String | 设备IMEI |
| deviceName | String | 设备名称 |
| icon | String | 车辆图标 |
| status | String | 设备状态 0,离线; 1,在线 |
| lng | Double | 经度 (如果设备过期,值为0) |
| lat | Double | 纬度 (如果设备过期,值为0) |
| expireFlag | String | 是否过期1-未过期 0-过期 |
| activationFlag | String | 是否激活1-激活 0-未激活 |
| posType | String | 卫星定位-GPS, 基站定位-LBS, WIFI定位-WIFI, 蓝牙定位-BEACON |
| gpsTime | String | GPS定位时间 |
| hbTime | String | 心跳时间 UTC秒数(如果设备过期,值为0) |
| speed | String | 速度 (单位:km/h) |
| accStatus | String | Acc状态 0:关闭 1:打开 |
| electQuantity | String | 设备电量(0-100),部分设备型号不支持 |
| powerValue | String | 外电电压(0-100),部分设备支持 |
| gpsNum | String | 参与定位卫星数 |
| direction | String | 移动的方向角度0~360 |
| mileage | String | 里程统计 |
正确返回示例:
js
{
"code": 0,
"message": "success",
"result": [
{
"imei": "868120145233604",
"deviceName": "868120145233604",
"icon": "bus",
"status": "0",
"posType": "GPS",
"lat": 22.577282,
"lng": 113.916604,
"hbTime": "2017-04-26 09:14:50",
"accStatus": "0",
"speed": "0",
"gpsTime": "2017-04-26 09:17:46",
"activationFlag": "1",
"expireFlag": "1",
"electQuantity": "60",
"powerValue": null,
"gpsNum": "",
"direction": "",
"mileage": ""
}
]
}错误返回示例:
js
{"code":xxx,"message":"非法设备"}