
超越物联
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
![]()  |