EXLIVE平台动态数据接口
接口说明
EXLIVE开放平台增加动态数据接口，主要以JSON格式返回车辆当前位置数据、轨迹回放数据等等车辆动态信息
（1）信息内容为json格式，必须采用UTF-8编码。（建议提交方式为post方法,可以避免汉字乱码问题）
（2）错误代码解释
{"success":false,"errorType":6}
success：
>> false：请求失败
>> true：请求成功
errorType：
>> 0：系统出错
>> 1：方法名不存在
>> 2：版本号不存在
>> 3：参数不能为空
>> 4：参数值格式有误
>> 5：用户名或密码错误
>> 6：授权码无效
>> 7：超过一小时最大访问次数
（3）如果接口请求地址不存在，请联系技术支持更新服务器。
用户登录
请求参数
| 参数 | 类型 | 必须 | 说明 |
|---|---|---|---|
| version | Integer | 是 | 版本号 |
| method | String | 是 | 方法 |
| name | String | 是 | 用户名 |
| pwd | String | 是 | 密码 |
HTTP请求例子：
http://60.195.248.67:89/gpsonline/GPSAPI?version=1&method=loginSystem&name=sunyan&pwd=123456
服务器响应
| 参数 | 类型 | 说明 |
|---|---|---|
| version | Integer | 版本号 |
| success | Boolean | 是否成功 |
| uid | Integer | 用户ID |
| uKey | String | 用户授权码 |
返回格式:
{
"version":1,
"success":true,
"uid":2103811,
"uKey":"4cb75a5b8ea89966691535021db029fb"
}
车辆登录
请求参数
| 参数 | 类型 | 必须 | 说明 |
|---|---|---|---|
| version | Integer | 是 | 版本号 |
| method | String | 是 | 方法 |
| name | String | 是 | 车牌号码 |
| pwd | String | 是 | 密码 |
HTTP请求例子：
http://60.195.248.67:89/gpsonline/GPSAPI?version=1&method=vLoginSystem&name=辽HB929&pwd=000000
服务器响应| 参数 | 类型 | 说明 |
|---|---|---|
| version | Integer | 版本号 |
| success | Boolean | 是否成功 |
| vid | Integer | 车辆ID |
| vKey | String | 车辆授权码 |
返回格式:
{
"version":1,
"success":true,
"vid":4103747,
"vKey":"2e8b868d779f1e1c0696e04113e79003"
}
分组车辆数据
请求参数
| 参数 | 类型 | 必须 | 说明 |
|---|---|---|---|
| version | Integer | 是 | 版本号 |
| method | String | 是 | 方法 |
| uid | String | 是 | 用户ID |
| uKey | String | 是 | 用户授权码 |
HTTP请求例子：
服务器响应
| 参数 | 类型 | 说明 |
|---|---|---|
| version | Integer | 版本号 |
| success | Boolean | 是否成功 |
| groups | [] | 分组 |
groups参数
| 参数 | 类型 | 说明 |
|---|---|---|
| id | Integer | 分组ID |
| name | String | 分组名称 |
| vehicles | [] | 车辆 |
vehicles参数
| 参数 | 类型 | 说明 |
|---|---|---|
| id | Integer | 车辆ID |
| name | String | 车牌号码 |
| vKey | String | 车辆授权码 |
返回格式:
{
"version":1,
"success":true,
"groups":
[
{
"id":"3012222",
"name":"私车",
"vehicles":
[
{
"id":"4103780",
"name":"辽G53609new",
"vKey":"0470beb71bc7214db501067ae4c2aeb6"
},
……
]
}
……
]
}
车辆最新位置
请求参数
| 参数 | 类型 | 必须 | 说明 |
|---|---|---|---|
| version | Integer | 是 | 版本号 |
| method | String | 是 | 方法 |
| vid | Integer | 是 | 车辆ID |
| vKey | String | 是 | 车辆授权码 |
HTTP请求例子：
服务器响应
| 参数 | 类型 | 说明 |
|---|---|---|
| version | Integer | 版本号 |
| success | Boolean | 是否成功 |
| locs | [] | 位置 |
locs 参数
| 参数 | 类型 | 说明 |
|---|---|---|
| id | Integer | 车辆ID |
| name | String | 车牌号码 |
| recvtime | Integer | 服务器时间(毫秒数) |
| gpstime | Integer | GPS时间(毫秒数) |
| lat | Double | 纬度 |
| lng | Double | 经度 |
| lat_xz | Double | 纬度修正值 |
| lng_xz | Double | 经度修正值 |
| state | String | 车辆状态 |
| speed | Double | 速度 |
| direct | Integer | 方向 |
| temp | Double | 温度 |
| oil | Double | 油量 |
| oilMN1 | Integer | 模拟量1 |
| oilMN2 | Integer | 模拟量2 |
| distance | Double | 行驶里程 |
| totalDis | Double | 总里程 |
| av | String | 有效性 |
| info | String | 文字位置信息 |
| vhcofflinemin | Integer | 不在线时长（分钟） |
| stopDefDis | Double | 设防距离 |
| stopDefLat | Double | 设防纬度 |
| stopDefLng | Double | 设防经度 |
| temp1 | String | 温度1 |
| temp2 | String | 温度2 |
| temp3 | String | 温度3 |
| temp4 | String | 温度4 |
返回格式:
{
"version":1,
"success":true,
"locs":
[
{
"id":4103747,
"name":"辽HB929 ",
"recvtime":1375867746000,
"gpstime":1375867680000,
"lat":40.77228,
"lng":122.27882,
"lat_xz":0.001645,
"lng_xz":0.005182,
"state":"防劫报警 停车超时报警(7h11m) ",
"speed":0,
"direct":336,
"temp":-50,
"oil":0,
"oilMN1":0,
"oilMN2":0,
"distance":62.4,
"totalDis":22559.44,
"av":"1",
"info":"辽宁省 营口市 大石桥市 加油站西南1673米 [1]",
"vhcofflinemin":10,
"stopDefDis":0,
"stopDefLat":0,
"stopDefLng":0,
"temp1":"0.0",
"temp2":"0.0",
"temp3":"0.0",
"temp4":"0.0"
}
]
}
轨迹回放
请求参数
| 参数 | 类型 | 必须 | 说明 |
|---|---|---|---|
| version | Integer | 是 | 版本号 |
| method | String | 是 | 方法 |
| vid | Integer | 是 | 车辆ID |
| vKey | String | 是 | 车辆授权码 |
| bTime | Integer | 是 | 开始时间(毫秒数) |
| eTime | Integer | 是 | 结束时间(毫秒数) |
HTTP请求例子：
服务器响应
| 参数 | 类型 | 说明 |
|---|---|---|
| version | Integer | 版本号 |
| success | Boolean | 是否成功 |
| history | [] | 历时轨迹 |
history 参数：
| 参数 | 类型 | 说明 |
|---|---|---|
| av | String | 有效性 |
| dir | Integer | 方向 |
| dis | Double | 里程 |
| gpst | String | GPS时间 |
| id | Integer | ID |
| lat | Double | 纬度 |
| lat_xz | Double | 纬度修正值 |
| lng | Double | 经度 |
| lng_xz | Double | 经度修正值 |
| oil | Double | 油量 |
| p1 | Integer | 模拟量1 |
| p2 | Integer | 模拟量2 |
| photo | String | 照片路径 |
| posinfo | String | 文字位置信息 |
| recvt | String | 服务器时间 |
| state | String | 状态 |
| temp | Double | 温度 |
| totaldistance | Double | 总里程 |
| veo | Double | 速度 |
返回格式:
{
"version":1,
"success":true,
"history":
[
{
"av":"1",
"dir":330,
"dis":0,
"gpst":"2013-08-03 00:00:30",
"id":18215,
"lat":40.662804,
"lat_xz":0.001645,
"lng":122.250465,
"lng_xz":0.005182,
"oil":0,
"p1":0,
"p2":0,
"photo":"",
"posinfo":"辽宁省 营口市 站前区 桂丰园小区西105米 [1]",
"recvt":"2013-08-03 00:01:29",
"state":"防劫报警 停车(24m)",
"temp":-50,
"totaldistance":22250.303,
"veo":0,
},
……
]
}
车辆地图位置接口
功能介绍：
第三方软件（如：ERP、OA等内部管理软件）可以通过传入车牌号码在地图上获取车辆当前位置信息。
URL接口地址：
http://XX.XX.XX.XX:89/Interface/findPosition.action?carNum=车牌号码
（注：这里的车牌号码需为完整正确的车牌号码。）
如：http://60.195.248.67:89/Interface/findPosition.action?carNum=京G41064天顺&u=gbk
 |