CGO8视频车辆GPS信息获取接口协议

• 描述

发送方根据指定的传输格式，调用指定的接口获取车辆GPS信息；

• 接口地址与约定

1接口地址：http://IP:port/topgps/services/TopDataService.ashx

2字符串编码：UTF8

3 参数名：request。

4返回值格式：json数组，编码格式 UTF8

• 请求、应答数据格式说明及示例

请求参数request定义

字段	类型	值	描述
Action	String	GetVehicleGpsInfo	车辆GPS信息接收
UserId	String		登录账号(必填)
Pwd	String		密码(必填) (分配的密码经MD5加密，32位大写)
Vehicles	Array		车牌+车牌颜色编码组成的json数组（为空时查询登录账号所有有权限车辆GPS信息）
NeedAddress	String	0	默认为0，当值为“1”时返回地理位置解析内容，为1时解析地理位置会影响接口返回速度

用例post参数:

request={

“Action”: “GetVehicleGpsInfo”

"UserId": "test",

"Pwd":"670B14728AD9902AECBA32E22FA4F6BD",

"Vehicles":[

{

"PlateNum":"闽A0089",

"ColorCode":"1"

},

{

"PlateNum":"闽A0000",

"ColorCode":"2"

}

],

"NeedAddress":"0"

}

车辆颜色编码对应表：

颜色编码	颜色名称
1	蓝色
2	黄色
3	黑色
4	白色
9	其他

应答数据格式(json字符串)

字段	属性	描述
Ret	String	0：成功 其他：失败
Msg	String	失败时返回错误信息
Data	Json数组	车辆GPS信息

Data中包含的单个设备数据说明

字段	属性	描述
PlateNum	String	车牌号码
ColorCode	String	车牌颜色编码
Mileage	String	里程
Speed	String	速度
GpsTime	String	时间戳
Longitude	String	经度
Latitude	String	纬度
Address	String	地理位置，参数传入NeedAddress=”1”时才有值否则为空 v1.1版本新增
Altitude	String	海拔  v1.2版本新增
Direction	String	方向  v1.2版本新增
IsGpsValid	String	是否定位 “1”定位 “0”未定位 v1.2版本新增
AlarmInfo	String	报警信息 v1.2版本新增
StateInfo	String	状态信息 v1.2版本新增
DriverLicense	String	从业资格证号 v1.3版本新增
DriverName	String	驾驶员姓名 v1.3版本新增

正确返回示例：

{

"Ret": 0,

"Msg": "" ,

"Data":[

{

" PlateNum ":"闽A0089",

" ColorCode ":"1",

" Mileage ":"1200.00",

" Speed ":"70.0",

" GpsTime ":" 2016-01-14 02:06:11.000 ",

" Longitude ":" 119.502668 ",

" Latitude ":" 26.308888 ",

" Address":" ",

"Direction":"0",

"Altitude":"500",

"IsGpsValid":"0",

"AlarmInfo":"",

"StateInfo":"ACC关;未定位;运营;油路断开;电路断开;车门加锁;",

"DriverLicense":"A1",

"DriverName":"张"

},

{

" PlateNum ":"闽A0000",

" ColorCode ":"2",

" Mileage ":"1200.00",

" Speed ":"70.0",

" GpsTime ":" 2016-01-14 02:06:11.000 ",

" Longitude ":" 119.502668 ",

" Latitude ":" 26.308888 ",

" Address":" ",

"Direction":"0",

"Altitude":"500",

"IsGpsValid":"0",

"AlarmInfo":"",

"StateInfo":"ACC关;未定位;运营;油路断开;电路断开;车门加锁;",

"DriverLicense":"1321351353",

"DriverName":"dq驾驶员"

}

]

}

出错情况下返回示例：

{

" Ret ": 1,

" Msg": "未找到指定车辆的GPS信息" ,

"Data": null

}

了解更多内容 关注公众号