超越物联
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=utf-8