Skip to content

根据账户,获取该账户下所有IMEI的最新定位数据

接口说明

获取一个账户名下所有设备最新位置信息。

请求URL

本接口通用参数里面method的值为jimi.user.device.location.list

HTTP请求方式

GET/POST

请求参数

(1)通用参数
参见: 通用参数
(2)私有参数

参数名参数类型是否必须默认值描述
access_tokenString访问令牌,表明其是一个合法第三方
targetString要查询的用户账号(获取token时使用的账户或者其子账户)
map_typeString如果要显示在百度地图上,map_type=BAIDU此时返回的经纬度将经过baidu校准方式校准 如果要显示在google、高德、腾讯地图上,map_type=GOOGLE,此时返回的经纬度将经过google校准方式校准 map_type如果不填,则返回原始经纬度

返回值

参数类型描述
codeInt返回码:
0: 正确返回
其它: 失败。参考错误码说明
messageString如果code不为0,会有相应的错误信息提示
resultString返回的数据

result参数列表:

参数类型描述
imeiString设备IMEI
deviceNameString设备名称
iconString设备图标
statusString设备状态 0,离线; 1,在线
posTypeString卫星定位-GPS, 基站定位-LBS, WIFI定位-WIFI, 蓝牙定位-BEACON
lngDouble经度 (gps84坐标,如果设备过期,值为0)
latDouble纬度 (gps84坐标,如果设备过期,值为0)
hbTimeString心跳时间
accStatusStringAcc状态 0:关闭 1:打开
gpsNumStringGPS卫星数
powerValueString外电压
powerStatusString是否已接电源 1已接通 0未接通
speedString速度 (单位:km/h)
gpsTimeStringGPS定位时间
directionString移动的方位角度 0-360
activationFlagString是否激活 1-激活 0-未激活
expireFlagString是否过期  1-过期 0-未过期
electQuantityString设备电量(0-100),部分设备型号不支持
iccidString设备sim卡iccid号
mileageString设备总里程
addressString设备定位地址
currentBigDecimal电流,单位mA
voltageBigDecimal电压,单位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
        },
        {
            "imei": "780901807727718",
            "deviceName": "PB708-27718",
            "icon": "per",
            "status": "0",
            "posType": "BEACON",
            "lat": 22.67609038389399,
            "lng": 114.00091142010092,
            "hbTime": null,
            "accStatus": "0",
            "gpsNum": null,
            "powerValue": null,
            "powerStatus": null,
            "speed": null,
            "gpsTime": "2026-04-01 01:02:17",
            "direction": null,
            "activationFlag": "1",
            "expireFlag": "1",
            "electQuantity": "92.1",
            "iccid": "",
            "mileage": null,
            "address": null,
            "current": null,
            "voltage": null
        }
	],
   "data": null
}

错误返回示例:

js
{"code":xxx,"message":"查询的账号不存在"}