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,在线
lngDouble经度 (如果设备过期,值为0)
latDouble纬度 (如果设备过期,值为0)
expireFlagString是否过期1-未过期 0-过期
activationFlagString是否激活1-激活 0-未激活
posTypeString卫星定位-GPS, 基站定位-LBS, WIFI定位-WIFI, 蓝牙定位-BEACON
gpsTimeStringGPS定位时间
hbTimeString心跳时间
speedString速度 (单位:km/h)
accStatusStringAcc状态 0:关闭 1:打开
electQuantityString设备电量(0-100),部分设备型号不支持
powerValueString外电电压(0-100),部分设备支持
gpsNumString参与定位卫星数
directionString移动的方向角度0~360
mileageString里程统计

正确返回示例:

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":"查询的账号不存在"}