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,在线 |
| posType | String | 卫星定位-GPS, 基站定位-LBS, WIFI定位-WIFI, 蓝牙定位-BEACON |
| lng | Double | 经度 (gps84坐标,如果设备过期,值为0) |
| lat | Double | 纬度 (gps84坐标,如果设备过期,值为0) |
| hbTime | String | 心跳时间 |
| accStatus | String | Acc状态 0:关闭 1:打开 |
| gpsNum | String | GPS卫星数 |
| powerValue | String | 外电压 |
| powerStatus | String | 是否已接电源 1已接通 0未接通 |
| speed | String | 速度 (单位:km/h) |
| gpsTime | String | GPS定位时间 |
| direction | String | 移动的方位角度 0-360 |
| activationFlag | String | 是否激活 1-激活 0-未激活 |
| expireFlag | String | 是否过期 1-过期 0-未过期 |
| electQuantity | String | 设备电量(0-100),部分设备型号不支持 |
| iccid | String | 设备sim卡iccid号 |
| mileage | String | 设备总里程 |
| address | String | 设备定位地址 |
| current | BigDecimal | 电流,单位mA |
| voltage | BigDecimal | 电压,单位V |
正确返回示例:
js
{
"code": 0,
"message": "success",
"result": [
{
"imei": "000034570000342",
"deviceName": "EV49-DM-00342",
"icon": "mtc",
"status": "0",
"posType": "GPS",
"lat": 23.115076691543997,
"lng": 114.42098727835496,
"hbTime": "2026-04-01 11:24:04",
"accStatus": "0",
"gpsNum": "0",
"powerValue": "2.93",
"powerStatus": "1",
"speed": "0",
"gpsTime": "2026-04-01 11:23:33",
"direction": "0",
"activationFlag": "1",
"expireFlag": "1",
"electQuantity": "",
"iccid": "89860426102480016170",
"mileage": "310.1585237425395",
"address": null,
"current": 3580,
"voltage": 36.58
}
],
"data": null
}错误返回示例:
js
{"code":xxx,"message":"非法设备"}