3.27查询车辆最新位置接口getVehicleLastLocation
**请求地址:** - `/ivci/api/vehicle/getVehicleLastLocation` **请求方式:** - POST,GET **实施方案:** 从数据库中查询,不从hbase中获取 **参数说明** |参数名称|类型|说明|备注| |:---- |:---|:----- |----- | |content |String |请求的加密数据 |必填 | |merchantId |String |请求用户所属商户 | 必填 | **备注** content经过RSA解密后的json格式 ``` { "userName":"testuser", "antiFake":"4bbab6ff0d8042548cc6f2df9f3655fa", "timestamp":"20160518165030", "serverIP":"127.0.0.1", "data":{ "vehicleIds":”123,234,567” } } ``` **content参数说明** |名称|类型|说明|备注| |:---- |:---|:----- |----- | |userName| String| 用户名| 必须| |antiFake| String| 防伪随机串| 必须| |timestamp| String| 请求时间戳,精确到秒| 必须| |serverIP| String| 服务器IP| 必须| |data| json| 查询车辆信息| 必须| |data.vehicleIds| String| 查询车辆Ids 多个ID用”,”分隔| 必须| **使用示例:** 1. 后台 ```java //读取privateKeyStr String privateKey=........... //获取数据签名 SimpleDateFormat formatter = new SimpleDateFormat ("yyyyMMddHHmmss"); String timestamp=formatter.format(new Date()); String signStr=RSAUtils.sign(timestamp.getBytes(), privateKey); String ip=request.getRemoteAddr(); //用私钥加密 String ext=",\"queryVehicle\":{.............}";//组装车辆信息 String dataStr="{\"userName\":\"testuser\",\"antiFake\":\""+signStr+"\",\"timestamp\":\""+timestamp+"\",\"serverIP\":\""+ip+"\" "+ext+" }"; String content=RSAUtils.encryptByPrivateKey(dataStr, privateKey); ``` 2. 前端 后台返回给前端加密后的content,然后发送请求调用 http://xxxxx/ivci/api/vehicle/getVehicleLastLocation?merchantId=100000&content=content **返回数据** 返回数据统一都是json格式 ```json {"code":0,"msg":"操作失败","data":{}} ``` **返回参数** |名称|类型|说明|备注| |:---- |:---|:----- |----- | |code| String| 操作结果码(成功=0,失败=1),见附录1 |返回| |msg| String| 操作返回信息(一般操作成功,返回null,失败的操作,才返回提示信息) | | |data| json| 轨迹信息,如果查询不到轨迹,则为null |返回| Data数据格式,如下: ```javascript "data":[{ drtime:”2016-12-20 00:00:00”, lon:"", lat:"", bd_lon:"", bd_lat:"", gd_lon:"", gd_lat:"", speed:"", direction:"", position:"", acc_state:"", vehicle_id:"", insspeed:"", vim:"", tank:"", temp:"", batteryVoltage:"", mileages:"" },{ drtime:”2016-12-20 00:00:00”, lon:"", lat:"", bd_lon:"", bd_lat:"", gd_lon:"", gd_lat:"", speed:"", direction:"", position:"", acc_state:"", vehicle_id:"", insspeed:"", vim:"", tank:"", temp:"", batteryVoltage:"", mileages:"" }] ``` **返回的轨迹字段描述:** |名称|类型|说明|备注| |:---- |:---|:----- |----- | |drtime| Date| 定位时间 UTC时间 | | |lon| Double| 经度 | | |lat| Double| 纬度 | | |bd_lon| Double| 百度经度 | | |bd_lat| Double| 百度纬度 | | |gd_lon| Double| 高德经度 | | |gd_lat| Double| 高德纬度 | | |speed| Float| 速度 km/h | | |direction| Int| 方向,0-360 | | |position| String| 位置 | | |acc_state| Int| 熄火状态 0熄火, 1点火 | | |vehicle_id| Int| 车辆Id | | |Insspeed| Float| 仪表时速(公里) km/h | | | vim |String| 车辆车架号| | | tank |String| 油箱油量百分比| | | temp |Float| 水温 ,单位:°C| | | batteryVoltage |Float| 电瓶电压,单位 :v| | | mileages |Int| 仪表里程,单位:米| |