Ptaxi网约车牌照代办整理贵州省网约车监管平台数据对接说明
2022-11-17 11:37:30 行业资讯Ptaxi网约车牌照代办公司整理贵州省网约车监管平台数据对接说明,跟着小编一起来看看吧!
一、数据对接流程
以下步骤请按先后顺序完成:
1、申请贵州省网约车监管平台测试环境数据对接账号:
申请账号需提供以下信息:
a、公司全称;
b、在贵州那些市州有业务;
c、公司有多少车;
d、如果已在交通部备案,请提供部里给你们分配的CompanyId;
e、你方技术对接人的姓名及电话。
2、参照《网络预约出租汽车监管信息交互平台总体技术要求(贵州改)》文件制定的标准进行数据对接,平台测试环境数据接收测试环境地址为:http://czc.tyxxtb.com/。如果调用相关数据对接接口返回200或ok则表示数据传输成功。
3、数据传输成功,不代表数据能够正确入库,有数据格式错误导致可能不能入库的情况,所以在传输成功后,等待几秒到几分钟的时间,可以在贵州省网约车监管平台测试环境中通过“传输日志”功能查看数据是否入库成功,入库数量是否和原始报文相符。
如果入库处理出现异常,请点击进去查看异常原因,并针对提示进行数据发送的改进,如下图:
也可以直接进入“传输错误日志”功能,查看近期出现的所有错误:
4、自检查验:确保所有《网络预约出租汽车监管信息交互平台总体技术要求(贵州改)》文档中所约定的28个接口都传输正常后,通过下图所列相关功能开始自检查验入库后的数据是否和贵平台发送的原始报文数据相符。
接口和功能对应表如下:
5、检查完所有接口数据都能正常入库后,为保证传输数据安全,需对数据采用RSA非对称加密算法进行签名。(网约车平台可选择不进行RSA签名直接传送数据,但因此导致数据接收异常和数据被篡改的情况由网约车平台企业自行负责)
a、说明:
传输方式POST(Content-Type:application/json)
签名过程SHA1withRSA签名进行base64编码字符集UTF-8。
b、格式
{"sign":"签名后字符串","data":"数据JSON字符串"}
sign:签名后的字符串
data:数据JSON字符串
样例:
{"sign":"xxxxxxezFgQGfuC+Xen181KGU6OGlPsSTTt5hI3Yk7pPC/SYR8OmPe9vm+M0CSC6D7KXAw/ybfSeeOwjHQwb7zhTZbGMb1aFfK7Zng2lXk3rrfj3UWk/IXVzLmgwIA01DhrnjUHzvNuJffeTgDgGLk6bYUXZqhS0tVTc3vv1S9Y=","data":{"CompanyId":"xinlongjiaxin","Source":"368","IPCType":"vehicleposition","vehicleposition":[{"CompanyId":"1200DDCX3307","VehicleNo":"贵C1787F","VehicleRegionCode":5203,"PositionTime":1554343255,"Longitude":106948012,"Latitude":27693291,"Speed":12,"Direction":129,"Elevation":0,"Mileage":1,"WarnStatus":0,"VehStatus":3,"OrderId":"0"}]}}
c、传输方RSA签名
把“数据JSON字符串”使用RSA私钥签名得到“签名后的字符串”
RSA公钥私钥对(1024位)PKCS#8请向监管平台技术对接工程师申请。
测试时可使用http://www.metools.info/code/c82.html网址提供的工具进行签名的测试,使用该工具时请严格按照下图指示进行:
d、RSA签名常遇错误问题:
(1)、多余的空格和换行、回车字符会导致签名错误,请去除;
(2)、付点型的小数,如果小数部分为0,请转换为整型,如1.0已表示为1,否则也会出现签名错误的情况。
6、前面所述工作完成后,请提交监管平台对接工程师进行最后的数据核验,核验成功就等待监管平台通知接入正式环境,正式环境接口地址届时告知。到此数据对接工作完成,后期日常传送数据过程中,如果出现相关错误,监管平台方会通知贵平台进行错误修正。
二、传输情况说明
贵州省网约车监管平台遵循交通运输部《网络预约出租汽车监管信息交互平台总体技术要求(贵州改)》文件制定的标准。为了保证数据传输质量,对数据质量检查较部标准会更加严格,特提醒以下注意事项:
1、传输的经纬度坐标不能为无意义的0等坐标,新平台对经纬坐标的要求范围为:经度大于70000000,小于140000000,维度大于0,小于55000000;
2、对日期时间,比如订单时间、坐标时间等当前发生的时间,不能大于当前时间+1天,不能小于当前时间-3天。非当前发生时间的,如许可证获取日期、车辆年审日期等,不能小于2010-01-01;
3、优先传输人、车、户等基础信息,否则传输数据时将出现错误报告,车辆或驾驶员无法找到的错误提示;
4、定位数据由于数据量大,建议一分钟集中调用发送一次,如果一分钟的定位数据包大于1M,可以半分钟发送一次,如果依然数据量大,可与对接负责人具体商洽处理方案;
5、新平台数据接收和入库采取异步方式,接收后并非立即入库,而是等待排队处理,根据接口繁忙情况的不同,入库延迟大概在1秒到1分钟之间。
6、必须传送Encrypt字段。
调用举例,如发送车辆GPS定位数据,具体接口地址为:http://czc.tyxxtb.com/position/vehicle
发送数据报文为:
{"CompanyId":"1200DDCX3307","Source":"0","IPCType":"positionvehicle","positionvehicle":[{"CompanyId":"1200DDCX3307","VehicleNo":"贵AV183F","VehicleRegionCode":5201,"PositionTime":1554343255,"Longitude":105642241,"Latitude":25505341,"Speed":0,"Direction":12,"Elevation":0,"Mileage":1,"WarnStatus":0,"VehStatus":3,"OrderId":"0"},{"CompanyId":"1200DDCX3307","VehicleNo":"贵CE4767","VehicleRegionCode":5200,"PositionTime":1554343257,"Longitude":107039725,"Latitude":27702696,"Speed":0,"Direction":0,"Elevation":0,"Mileage":3,"WarnStatus":0,"VehStatus":3,"OrderId":"0"},{"CompanyId":"1200DDCX3307","VehicleNo":"贵A1MS95","VehicleRegionCode":5201,"PositionTime":1554343258,"Longitude":106604620,"Latitude":26398930,"Speed":92,"Direction":125,"Elevation":0,"Mileage":0,"WarnStatus":0,"VehStatus":3,"OrderId":"0"},{"CompanyId":"1200DDCX3307","VehicleNo":"贵C1106R","VehicleRegionCode":5203,"PositionTime":1554343255,"Longitude":106844215,"Latitude":27540118,"Speed":31,"Direction":285,"Elevation":0,"Mileage":1,"WarnStatus":1,"VehStatus":3,"OrderId":"0"},{"CompanyId":"1200DDCX3307","VehicleNo":"贵A0TC71","VehicleRegionCode":5201,"PositionTime":1554343257,"Longitude":106713751,"Latitude":26580161,"Speed":0,"Direction":199,"Elevation":0,"Mileage":0,"WarnStatus":0,"VehStatus":3,"OrderId":"0"},{"CompanyId":"1200DDCX3307","VehicleNo":"贵C1773E","VehicleRegionCode":5203,"PositionTime":1554342466,"Longitude":106811140,"Latitude":28142140,"Speed":0,"Direction":212,"Elevation":0,"Mileage":0,"WarnStatus":1,"VehStatus":2,"OrderId":"0"},{"CompanyId":"1200DDCX3307","VehicleNo":"贵C900A0","VehicleRegionCode":5203,"PositionTime":1554343259,"Longitude":106935156,"Latitude":27704035,"Speed":18,"Direction":356,"Elevation":0,"Mileage":1,"WarnStatus":0,"VehStatus":3,"OrderId":"0"},{"CompanyId":"1200DDCX3307","VehicleNo":"贵A2V70C","VehicleRegionCode":5201,"PositionTime":1554343259,"Longitude":106426970,"Latitude":26632190,"Speed":11,"Direction":174,"Elevation":0,"Mileage":0,"WarnStatus":0,"VehStatus":3,"OrderId":"0"},{"CompanyId":"1200DDCX3307","VehicleNo":"贵A2275A","VehicleRegionCode":5201,"PositionTime":1554343257,"Longitude":106612875,"Latitude":26635915,"Speed":0,"Direction":265,"Elevation":0,"Mileage":2,"WarnStatus":0,"VehStatus":3,"OrderId":"0"},{"CompanyId":"1200DDCX3307","VehicleNo":"贵C1011H","VehicleRegionCode":5203,"PositionTime":1554343259,"Longitude":106853522,"Latitude":27588720,"Speed":25,"Direction":307,"Elevation":0,"Mileage":1,"WarnStatus":0,"VehStatus":3,"OrderId":"0"},{"CompanyId":"1200DDCX3307","VehicleNo":"贵C1787F","VehicleRegionCode":5203,"PositionTime":1554343255,"Longitude":106948012,"Latitude":27693291,"Speed":12,"Direction":129,"Elevation":0,"Mileage":1,"WarnStatus":0,"VehStatus":3,"OrderId":"0"}]}
三、常见问题解答
数据的传输方式,是我们按照文档写好接口调用还是有贵方来读取?
答:按照对接文档写好调用我方平台接口。
公司(/平台)标识或CompanyId是什么?是由贵州省网约车监管平台分配吗?
答:如果你们有在交通部备案过,部里有分配给你们CompanyId作为你们的平台标识。如果没在部里备案过,由贵州省网约车监管平台给你们分配标识。
如何开通测试平台数据对接的账号?
答:将以下五项资料发送给平台方的工程师,由他们来开通:
a、公司全称;
b、在贵州那些市州有业务;
c、公司有多少车;
d、如果已在交通部备案,请提供部里给你们分配的CompanyId;
e、你方技术对接人的姓名及电话。
进行数据对接工作是否需要技术工程师才能做?
答:数据对接需要以技术方式调用贵州省网约车监管平台,需要写代码实现,所以必须由贵平台的开发工程师才能完成。
我司/平台已经在贵阳做过数据对接,请问还需要重新做对接吗?
答:由于全省平台统一,所以在贵阳对接过的,不需要重新对接,只需要将数据发送的范围从贵阳扩大到全省。
我司/平台在全省很多城市都在运营,请问是每个城市单独对接,还是由总部统一对接。
答:由总部统一对接。
Ptaxi猿著提供网约车软件开发以及网约车牌照申请代办、网约车监管平台数据对接服务等,如有需求欢迎咨询我们!
更多资讯
Ptaxi猿著网约车软件开发:铜仁网约车百日整治,已查处4716起
Ptaxi猿著网约车行业10月监管数据公布,滴滴、花小猪等平台订单增长超20%
滴滴打车软件开发公司获悉滴滴在5个城市上线特惠订单相关的新规则
每月持续产品迭代更新
快速Saas搭建+定制开发
专属客户经理提供技术支持
提供企业合同及国家增值税发票