EXLIVE 车辆/人员定位服务专业平台

显示全部 动态数据接口

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请求例子:

http://60.195.248.67:89/gpsonline/GPSAPI?version=1&method=loadVehicles&uid=2103811&uKey=4cb75a5b8ea89966691535021db029fb

服务器响应

参数 类型 说明
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请求例子:

http://60.195.248.67:89/gpsonline/GPSAPI?version=1&method=loadLocation&vid=4103747&vKey=2e8b868d779f1e1c0696e04113e79003

服务器响应

参数 类型 说明
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请求例子:

http://60.195.248.67:89/gpsonline/GPSAPI?version=1&method=loadHistory&vid=4103747&vKey=2e8b868d779f1e1c0696e04113e79003&bTime=1375459200000&eTime=1375545599000

服务器响应

参数 类型 说明
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

 

 

版权信息
手机产品   |    论坛   |    收藏   |    GPS+   |    帮助   |    建议   |    登录   |    管理(183)
京ICP备09069461号    京公网安备110105002252