淄博暢行電子科技有限公司
主營油管家。TEL:138-6440-1440
EXLIVE開放平臺增加動態(tài)數(shù)據(jù)接口,主要以JSON格式返回車輛當(dāng)前位置數(shù)據(jù)、軌跡回放數(shù)據(jù)等等車輛動態(tài)信息
(1)信息內(nèi)容為json格式,必須采用UTF-8編碼。(建議提交方式為post方法,可以避免漢字亂碼問題)
(2)錯誤代碼解釋
{"success":false,"errorType":6}
success:
>> false:請求失敗
>> true:請求成功
errorType:
>> 0:系統(tǒng)出錯
>> 1:方法名不存在
>> 2:版本號不存在
>> 3:參數(shù)不能為空
>> 4:參數(shù)值格式有誤
>> 5:用戶名或密碼錯誤
>> 6:授權(quán)碼無效
>> 7:超過一小時最大訪問次數(shù)
(3)如果接口請求地址不存在,請聯(lián)系技術(shù)支持更新服務(wù)器。
請求參數(shù)
參數(shù) | 類型 | 必須 | 說明 |
---|---|---|---|
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
服務(wù)器響應(yīng)
參數(shù) | 類型 | 說明 |
---|---|---|
version | Integer | 版本號 |
success | Boolean | 是否成功 |
uid | Integer | 用戶ID |
uKey | String | 用戶授權(quán)碼 |
返回格式:
{
"version":1,
"success":true,
"uid":2103811,
"uKey":"4cb75a5b8ea89966691535021db029fb"
}
請求參數(shù)
參數(shù) | 類型 | 必須 | 說明 |
---|---|---|---|
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
服務(wù)器響應(yīng)參數(shù) | 類型 | 說明 |
---|---|---|
version | Integer | 版本號 |
success | Boolean | 是否成功 |
vid | Integer | 車輛ID |
vKey | String | 車輛授權(quán)碼 |
返回格式:
{
"version":1,
"success":true,
"vid":4103747,
"vKey":"2e8b868d779f1e1c0696e04113e79003"
}
請求參數(shù)
參數(shù) | 類型 | 必須 | 說明 |
---|---|---|---|
version | Integer | 是 | 版本號 |
method | String | 是 | 方法 |
uid | String | 是 | 用戶ID |
uKey | String | 是 | 用戶授權(quán)碼 |
HTTP請求例子:
服務(wù)器響應(yīng)
參數(shù) | 類型 | 說明 |
---|---|---|
version | Integer | 版本號 |
success | Boolean | 是否成功 |
groups | [] | 分組 |
groups參數(shù)
參數(shù) | 類型 | 說明 |
---|---|---|
id | Integer | 分組ID |
name | String | 分組名稱 |
vehicles | [] | 車輛 |
vehicles參數(shù)
參數(shù) | 類型 | 說明 |
---|---|---|
id | Integer | 車輛ID |
name | String | 車牌號碼 |
vKey | String | 車輛授權(quán)碼 |
返回格式:
{
"version":1,
"success":true,
"groups":
[
{
"id":"3012222",
"name":"私車",
"vehicles":
[
{
"id":"4103780",
"name":"遼G53609new",
"vKey":"0470beb71bc7214db501067ae4c2aeb6"
},
……
]
}
……
]
}
請求參數(shù)
參數(shù) | 類型 | 必須 | 說明 |
---|---|---|---|
version | Integer | 是 | 版本號 |
method | String | 是 | 方法 |
vid | Integer | 是 | 車輛ID |
vKey | String | 是 | 車輛授權(quán)碼 |
HTTP請求例子:
服務(wù)器響應(yīng)
參數(shù) | 類型 | 說明 |
---|---|---|
version | Integer | 版本號 |
success | Boolean | 是否成功 |
locs | [] | 位置 |
locs 參數(shù)
參數(shù) | 類型 | 說明 |
---|---|---|
id | Integer | 車輛ID |
name | String | 車牌號碼 |
recvtime | Integer | 服務(wù)器時間(毫秒數(shù)) |
gpstime | Integer | GPS時間(毫秒數(shù)) |
lat | Double | 緯度 |
lng | Double | 經(jīng)度 |
lat_xz | Double | 緯度修正值 |
lng_xz | Double | 經(jīng)度修正值 |
state | String | 車輛狀態(tài) |
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 | 設(shè)防距離 |
stopDefLat | Double | 設(shè)防緯度 |
stopDefLng | Double | 設(shè)防經(jīng)度 |
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"
}
]
}
請求參數(shù)
參數(shù) | 類型 | 必須 | 說明 |
---|---|---|---|
version | Integer | 是 | 版本號 |
method | String | 是 | 方法 |
vid | Integer | 是 | 車輛ID |
vKey | String | 是 | 車輛授權(quán)碼 |
bTime | Integer | 是 | 開始時間(毫秒數(shù)) |
eTime | Integer | 是 | 結(jié)束時間(毫秒數(shù)) |
HTTP請求例子:
服務(wù)器響應(yīng)
參數(shù) | 類型 | 說明 |
---|---|---|
version | Integer | 版本號 |
success | Boolean | 是否成功 |
history | [] | 歷時軌跡 |
history 參數(shù):
參數(shù) | 類型 | 說明 |
---|---|---|
av | String | 有效性 |
dir | Integer | 方向 |
dis | Double | 里程 |
gpst | String | GPS時間 |
id | Integer | 車輛ID |
lat | Double | 緯度 |
lat_xz | Double | 緯度修正值 |
lng | Double | 經(jīng)度 |
lng_xz | Double | 經(jīng)度修正值 |
oil | Double | 油量 |
p1 | Integer | 模擬量1 |
p2 | Integer | 模擬量2 |
photo | String | 照片路徑 |
posinfo | String | 文字位置信息 |
recvt | String | 服務(wù)器時間 |
state | String | 狀態(tài) |
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":"遼寧省 營口市 站前區(qū) 桂豐園小區(qū)西105米 [1]",
"recvt":"2013-08-03 00:01:29",
"state":"防劫報警 停車(24m)",
"temp":-50,
"totaldistance":22250.303,
"veo":0,
},
……
]
}
功能介紹:
第三方軟件(如:ERP、OA等內(nèi)部管理軟件)可以通過傳入車牌號碼在地圖上獲取車輛當(dāng)前位置信息。
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
聯(lián)系人:蘇經(jīng)理
手機:138-6440-1440
電話:0533-2266656
QQ:107415444
電子郵箱:107415444@qq.com
地址:山東省淄博市張店區(qū)黃金廣場c座7樓723號