Skip to content

根据IMEI获取最新定位数据

接口说明

获取单个或多个设备最新的位置信息

请求URL

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

HTTP请求方式

GET/POST

请求参数

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

参数名称参数类型是否必填默认值描述
access_tokenString访问令牌,表明其是一个合法第三方
imeisString设备imei号,多个中间用英文逗号隔开; 如果设备过多,建议采用POST方式(一次最多100个IMEI)
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心跳时间 UTC秒数(如果设备过期,值为0)
speedString速度 (单位:km/h)
accStatusStringAcc状态 0:关闭 1:打开
electQuantityString设备电量(0-100),部分设备型号不支持
mileageString设备总里程
offlineTimeString状态时长
powerStatusString接通电源状态 1 已接通 0:未接通 空值:不存在该属性配置

正确返回示例:

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",
      "offlineTime": 31433769,
    }
  ]
}

错误返回示例:

js
{"code":xxx,"message":"非法设备"}