互联网租赁自行车系统数据接口协议.docx
- 文档编号:4026265
- 上传时间:2022-11-27
- 格式:DOCX
- 页数:24
- 大小:21.23KB
互联网租赁自行车系统数据接口协议.docx
《互联网租赁自行车系统数据接口协议.docx》由会员分享,可在线阅读,更多相关《互联网租赁自行车系统数据接口协议.docx(24页珍藏版)》请在冰豆网上搜索。
互联网租赁自行车系统数据接口协议
附 录 A
(规范性附录)
数据接口协议
A.1 数据接口协议说明
1)各企业运营平台与行业监管与服务平台数据交换需要按照协议中的要求进行交换;
2)各企业采集的数据,按照需要的频率,放入消息队列中;
3)服务交换结构使用JSON字符串格式。
json为两层,type代表协议类型,jsonStr代表传输内容。
例如订单请求(MSG_ORDER)接口:
{"type":
"MSG_ORDER","jsonStr":
"{\"ORDERCODE\":
\"1000000001A\"}"},其中订单类型是MSG_ORDER,订单编码是“1000000001A”。
数据接口协议类型字段定义如表A.1所示。
4)行业监管与服务平台对接收到的数据进行格式、取值、范围等检查,检查有错误的数据,通过消息队列将数据返回给企业,并说明错误原因。
企业应对数据进行检查,核对后重新进行发送。
序号
数据交换信息项
协议类型
1
企业基本信息
MSG_COMPANY
2
车辆基本信息
MSG_BICYCLE
3
车辆动态信息
MSG_DYNAMIC
4
订单信息
MSG_ORDER
5
运维人员基本信息
MSG_YW_PERSON
6
运维人员实时动态信息
MSG_YW_PC_DYNAMIC
7
运维车辆基本信息
MSG_YW_CAR
8
运维车辆实时动态信息
MSG_YW_CAR_DYNAMIC
9
调度信息
MSG_YW_BYCYCLE
10
入栏信息
MSG_BYCYCLE_PARKING
11
停放不规范信息
MSG_USERCREDIT
表A.1 企业数据交换接口协议类型对照表
行业监管与服务平台交换给企业运营平台数据应使用表A.2所示的协议类型。
表A.2 行业监管与服务平台共享数据协议类型表
序号
数据交换信息项
协议类型
1
停放区信息
MSG_PARKING
2
禁止停放区信息
MSG_NOPARKING
3
入栏结算区信息
MSG_MANAGEMENT
A.2 企业基本信息
用于企业运营平台向行业监管与服务平台上传企业基本信息,企业运营平台将数据发送到行业监管与服务平台前置机上的消息队列中,如果发送失败,应具备补传机制,数据有更新时传输。
企业基本信息数据项描述见表A.3。
表A.3 企业基本信息数据项表
序号
属性项名称
描述
是否必填
字段名称
字段类型
字段最大长度(字节)
1
企业标识
统一分配
是
COMPANYID
varchar
6
2
企业名称
企业注册名称
是
COMPANYNAME
varchar
256
3
统一社会信用代码
唯一标识
是
IDENTIFIER
varchar
32
4
经营范围
按照经营许可证内容填写
是
BUSINESSSCOPE
varchar
256
5
通信地址
是
CONTACTADDRESS
varchar
256
6
注册资本
按照营业执照内容填写
是
REGCAPITAL
varchar
128
7
法人代表姓名
按照营业执照内容填写
是
LEGALNAME
varchar
12
8
法人代表身份证号
是
LEGALID
varchar
18
9
法人代表电话
是
LEGALPHONE
varchar
11
10
状态
0:
有效,1:
失效
是
STATUS
varchar
1
11
操作标识
1:
新增,2:
更新,3:
删除
是
COMPANYFLAG
varchar
1
12
更新时间
完成数据更新时间YYYYMMDDHHMMSS
是
COMPANYUPDATETIME
Date
14
A.3 车辆基本信息
用于企业运营平台向行业监管与服务平台上传车辆基本信息,企业运营平台将数据发送到行业监管与服务平台前置机上的消息队列中,如果发送失败,应具备补传机制,数据有更新时上传。
车辆基本信息数据项描述见表A.4。
表A.4 车辆基本信息数据项表
序号
属性项名称
描述
是否必填
字段名称
字段类型
字段最大长度(字节)
1
企业标识
统一分配
是
COMPANYID
varchar
6
2
车辆编码
车辆在企业内唯一标识
是
BICYCLEID
varchar
16
3
车锁编码
车锁在企业内的唯一标识
是
LOCKID
varchar
16
4
蓝牙MAC地址
十六进制的编码
是
MAC
varchar
32
5
车辆型号
企业车辆型号
否
TYPE
varchar
32
6
投放批次
企业投放车辆的批次编号
否
BATCH
number
8
表A.4车辆基本信息数据项(续)
序号
属性项名称
描述
是否必填
字段名称
字段类型
字段最大长度(字节)
7
投放日期
车辆首次投放日期
格式:
YYYYMMDD
是
BICYCLEDATE
date
8
8
投放区域
车辆投放区域代码
否
BICYCLEAREA
varchar
20
9
车辆状态
0:
正常,1:
维修,2:
报废,3:
回收4:
暂扣
是
BICYCLESTATE
varchar
1
10
更新时间
YYYYMMDDhhmmss
是
UPDATETIME
date
14
A.4 车辆动态信息
用于企业运营平台向行业监管与服务平台上传车辆动态信息,企业运营平台将数据发送到行业监管与服务平台前置机上的消息队列中,如果发送失败,应具备补传机制,数据传输为实时传输,车辆位置有更新时即传输。
车辆运行实时信息数据项描述见表A.5。
表A.5 车辆动态信息数据项表
序号
属性项名称
描述
是否必填
字段名称
字段类型
字段最大长度(字节)
1
企业标识
统一分配
是
COMPANYID
varchar
6
2
锁编码
车锁的唯一标识
是
LOCKID
varchar
16
3
车锁状态
车锁实时状态0:
开,1:
关
是
LOCKSTATUS
varchar
1
4
定位装置时间
数据采集时间格式:
YYYYMMDDHHMMSS
是
POSITIONTIME
date
14
5
车辆实时坐标-经度
车辆位置经度,WGS84坐标系,小数点后保留6位
是
BICYCLE_LNG
varchar
9
6
车辆实时坐标-纬度
车辆位置纬度,WGS84坐标系,小数点后保留6位
是
BICYCLE_LAT
varchar
8
7
车辆编码
车辆在企业内的唯一标识
是
BICYCLEID
varchar
16
A.5 订单信息
用于企业运营平台向行业监管与服务平台上传订单信息,企业运营平台实时将数据发送到监管与服务平台前置机上的消息队列中,如果发送失败,应具备补传机制,数据传输为实时传输,订单信息数据项描述见表A.6。
表A.6 订单信息数据项表
序号
属性项名称
描述
是否必填
字段名称
字段类型
字段最大长度(字节)
1
订单编号
唯一标识
是
ORDERCODE
varchar
20
表A.6订单信息数据项表(续)
序号
属性项名称
描述
是否必填
字段名称
字段类型
字段最大长度(字节)
2
企业标识
统一分配
是
COMPANYID
varchar
6
3
车辆编码
车辆在企业内的唯一标识
是
BICYCLEID
varchar
16
4
锁编码
车锁的唯一标识
是
LOCKID
varchar
16
5
电子标签
行业监管平台分配编码
是
EID
varchar
9
6
租车时间
运营系统确认承租人租车时间,
格式:
YYYYMMDDHHMMSS
是
STARTIME
Date
14
7
还车时间
运营系统确认承租人还车时间,
格式:
YYYYMMDDHHMMSS
是
ENDTIME
Date
14
8
租车地经度
WGS84坐标系,小数点后6位
是
START_LNG
varchar
10
9
租车地纬度
WGS84坐标系,小数点后6位
是
START_LAT
varchar
9
10
还车地经度
WGS84坐标系,小数点后6位
是
END_LNG
varchar
10
11
还车地纬度
WGS84坐标系,小数点后6位
是
END_LAT
varchar
9
12
单价(元)
企业自主计费单价,格式如1.31,保留小数点后2位。
指的是定价,不是实际收费。
否
UNITPRICE
varchar
50
13
订单里程
单位:
km,如10.5
订单一次租还车计费里程,保留小数点后1位
是
ORDER_KM
number
4
14
订单状态
订单实际发生状态。
0:
已完成,1:
未完成,2:
其它
是
ORDER_STATUS
varchar
1
15
出生年
出生年格式:
YYYY
是
BRI_DATE
Date
4
16
性别
0:
男,1:
女
是
GENDER
varchar
2
17
是否弹锁
0:
是,1:
否
是
UNLOCK
varchar
1
A.6 运维人员基本信息
用于企业运营平台向行业监管与服务平台上传运维人员基本信息,企业运营平台将数据发送到行业监管与服务平台前置机上的消息队列中,如果发送失败,应具备补传机制,数据有更新时传输。
运维人员基本信息数据项描述见表A.7。
表A.7 运维人员基本信息数据项表
序号
属性项名称
描述
是否必填
字段名称
字段类型
字段最大长度(字节)
1
企业标识
统一分配
是
COMPANYID
varchar
6
2
人员编号
人员在企业内唯一标识
是
PERSONID
varchar
16
3
负责区域
负责的网点名称
是
AREA
varchar
400
4
所属街道编码
北京市街道行政编码
是
TOWN_CODE
varchar
7
A.7 运维人员实时动态信息
用于企业运营平台向行业监管与服务平台上传运维人员实时动态信息,企业运营平台将数据发送到行业监管与服务平台前置机上的消息队列中,如果发送失败,应具备补传机制,数据传输频率为每分钟一次。
运维人员实时动态信息数据项描述见表A.8。
表A.8 运维人员实时动态信息数据项表
序号
属性项名称
描述
是否必填
字段名称
字段类型
字段最大长度(字节)
1
企业标识
统一分配
是
COMPANYID
varchar
6
2
定位时间
数据采集时间格式:
YYYYMMDDHHMMSS
是
POSITIONTIME
date
14
3
人员实时坐标-经度
人员位置经度,WGS84坐标系,小数点后保留6位
是
PERSON_LNG
varchar
9
4
人员实时坐标-纬度
人员位置纬度,WGS84坐标系,小数点后保留6位
是
PERSON-LAT
varchar
8
5
人员编号
人员在企业内唯一标识
是
PERSONID
varchar
16
A.8 运维车辆基本信息
用于企业运营平台向行业监管与服务平台上传运维车辆基本信息,企业运营平台将数据发送到行业监管与服务平台前置机上的消息队列中,如果发送失败,应具备补传机制,数据有更新时传输。
运维车辆基本信息数据项描述见表A.9。
表A.9 运维车辆基本信息数据项表
序号
属性项名称
描述
是否必填
字段名称
字段类型
字段最大长度(字节)
1
企业标识
统一分配
是
COMPANYID
varchar
6
2
运维车编码
车辆在企业内唯一标识
是
VEHICLEID
varchar
16
3
运维车类型
0:
厢式货车,1:
三轮车
是
TYPE
varchar
16
4
车辆负责区域
负责的网点名称
是
AREA
varchar
400
5
所属街道编码
北京市行政区编码
是
TOWN_CODE
varchar
7
A.9 运维车辆实时动态信息
用于企业运营平台向行业监管与服务平台上传运维车辆实时动态信息,企业运营平台将数据发送到行业监管与服务平台前置机上的消息队列中,如果发送失败,应具备补传机制,数据传输频率为每分钟一次。
运维车辆实时动态信息数据项描述见表A.10。
表A.10 运维车辆实时动态信息数据项表
序号
属性项名称
描述
是否必填
字段名称
字段类型
字段最大长度(字节)
1
企业标识
统一分配
是
COMPANYID
varchar
6
2
定位时间
数据采集时间格式:
YYYYMMDDHHMMSS
是
POSITIONTIME
date
14
3
车辆实时坐标-经度
车辆位置经度,WGS84坐标系,小数点后保留6位
是
VEHICLE_LNG
varchar
9
4
车辆实时坐标-纬度
车辆位置纬度,WGS84坐标系,小数点后保留6位
是
VEHICLE-LAT
varchar
8
5
运维车编码
车辆在企业内唯一标识
是
VEHICLEID
varchar
16
A.10 调度信息
用于企业运营平台向行业监管与服务平台上传调度信息,企业运营平台将数据发送到行业监管与服务平台前置机上的消息队列中,如果发送失败,应具备补传机制,数据传输频率为实时传输。
调度人员和车辆信息描述见表A.11。
表A.11 调度人员数据项表
序号
属性项名称
描述
是否必填
字段名称
字段类型
字段最大长度(字节)
1
被调度车辆编码
被调度的自行车的编码
是
BICYCLEID
varchar
400
2
人员编码
人员在企业内唯一标识
是
PERSONID
varchar
16
3
企业标识
统一分配
是
COMPANYID
varchar
6
4
调出时间
数据采集时间格式:
YYYYMMDDHHMMSS
是
OUTTIME
DATE
14
5
调出位置经度
装车位置经度,WGS84坐标系,小数点后保留6位
是
OUT_LAG
varchar
10
6
调出位置纬度
装车位置纬度,WGS84坐标系,小数点后保留6位
是
OUT_LAT
varchar
10
7
调入时间
数据采集时间格式:
YYYYMMDDHHMMSS
是
INTIME
DATE
16
8
调入位置经度
卸车位置经度,WGS84坐标系,小数点后保留6位
是
IN_LAG
varchar
10
9
调入位置纬度
卸车位置纬度,WGS84坐标系,小数点后保留6位
是
IN_LAT
varchar
10
A.11 入栏信息
用于企业运营平台向行业监管与服务平台上传入栏结果信息,企业运营平台将数据发送到行业监管与服务平台前置机上的消息队列中,如果发送失败,应具备补传机制,数据传输频率为实时传输。
入栏结果信息描述见表A.12。
表A.12 入栏结果信息数据项表
序号
属性项名称
描述
是否必填
字段名称
字段类型
字段最大长度(字节)
1
企业标识
统一分配
是
COMPANYID
varchar
6
2
订单编号
订单在企业唯一标识
是
ORDERCODE
varchar
20
3
入栏状态
0:
未入栏,1:
入栏,2:
其他
是
PARK_STATUS
varchar
1
4
类型
0:
无,1:
扣信用分,2:
加收调度费,3:
加信用分,4:
禁止使用车辆,5:
其它
是
CREDIT_STATUS
varchar
1
5
入栏结算区编码
行业管理部门编码,不在入栏结算区内的订单此处填写000000000000
是
CODE
varchar
12
A.12 不规范停放信息
用于企业运营平台向行业监管与服务平台上传承租人停放违约信息。
由企业运营平台主动发送到行业监管与服务平台前置机上的消息队列中,如果发送失败,应具备补传机制,数据传输频率为实时传输。
基本信息数据项描述见表A.13。
表A.13 不规范停放信息数据项表
序号
属性项名称
描述
是否必填
字段名称
字段类型
字段最大长度(字节)
1
记录ID
企业对承租人违反使用协议对应的措施唯一编码
是
PENALTYID
varchar
20
2
订单编码
与订单表关联,订单唯一标识
是
ORDERID
varchar
20
3
企业标识
统一分配
是
COMPANYID
varchar
6
4
承租人代码
手机号
是
TENANTID
varchar
11
5
控制区编号
禁止停放区/入栏结算区编码
是
RECODE
varchar
20
6
订单时间
YYYYMMDDHHMMSS
是
TIME
Date
14
7
更新时间
完成数据更新时间YYYYMMDDhhmmss
是
UPDATETIME
date
14
表A.13不规范停放信息数据项表(续)
序号
属性项名称
描述
是否必填
字段名称
字段类型
字段最大长度(字节)
8
类型
0:
无,1:
扣信用分,2:
加收调度费,3:
其它,4:
禁止使用车辆;
是
TYPE
varchar
2
9
截止时间
完成对承租人违约执行的时间YYYYMMDDhhmmss
是
DEADLINE
Date
14
A.13 停放区信息
用于行业监管与服务平台向企业发送停放区信息。
行业监管与服务平台将数据发送到消息队列中,并由企业从消息队列读取数据,数据有更新时传输。
基本信息数据项描述见表表A.14。
表A.14 停放区信息数据项表
序号
属性项名称
描述
是否必填
字段名称
字段类型
字段最大长度(字节)
1
编号
对停放区的编号,16位,前四位是行政区编码,中间三位是街道编码,后四位顺序编码,街道内顺序编码唯一
是
CODE
varchar
16
2
坐标
84坐标系,小数点后保留7位,每个文件经纬度大于等于4组,多个经度信息由竖线(|)分隔。
是
COORDINATE
varchar
400
3
面积
停车区面积,m2
是
AREA
number
7
4
可容纳车辆
停车区范围内可容纳车辆数
是
CAPACITY
varchar
4
5
位置
1:
专门用地,2:
行道树间,3:
绿化带,4:
机非隔离带,5:
临街空地,6:
封闭居民区或园区,7:
其他
是
LOCATION
varchar
1
6
类型
1:
地铁,2:
居住区,3:
办公区,4:
商业,5:
学校,6:
景区,7:
交通枢纽,8:
其他
是
TYPE
varchar
1
7
性质
1:
长期,2:
临时
是
ATTRIBUTE
varchar
1
8
允许停放时间
例:
7:
00-19:
00
否
TIME
varchar
22
9
属性
1:
收费,2:
免费
是
CHARACTER
number
1
10
场景
1:
城市峡谷2:
一般城市环境,3:
树荫,4:
开阔地带
是
SCENCE
varchar
1
11
辅助设施
蓝牙道钉,地笼等
是
FACILITY
varchar
10
12
辅助设施数量
0-99
是
NUMBER
number
2
13
道路名称
停放区所在道路的名称
是
DLMC
varchar
20
14
入栏结算区编码
0:
在“规范管理区”;其他情况填写入栏结算区编码
是
JSQ_ID
varchar
2
表A.14停放区信息数据项表(续)
序号
属性项名称
描述
是否必填
字段名称
字段类型
字段最大长度(字节)
15
备注
其他说明
否
MORE
varchar
256
A.14 禁止停放区信息
用于行业监管与服务平台向企业发送禁止停放区信息。
行业监管与服务平台将数据发送到消息队列中,并由企业从消息队列读取数据,数据有更新时传输。
基本信息数据项描述见表A.15。
表A.15 禁止停放区信息数据项表
序号
属性项名称
描述
是否必填
字段名称
字段类型
字段最大长度(字节)
1
名称
禁止停放区范围描述
是
NAME
varchar
10
2
编码
11位,前3位禁停区代码,中间6位是行政区编码,后2位顺序编码,
是
CODE
varchar
11
3
坐标
84坐标系,小数点后保留7位,每个文件经纬度大于等于4组,多个经度信息由竖线(|)分隔。
是
COORDINATE
varchar
400
4
性质
1:
长期,2:
临时
是
ATTRIBUTE
varchar
1
5
类型
1:
政策管制,2:
人行道宽度不足,3:
内部区域,4.设施等专属用地,5:
重大活动临时设置,6:
其他
是
TYPE
varchar
1
6
面积
禁止停放区面积
是
AREA
number
20
7
禁停时间
例;7:
00-19:
00
否
TIME
varchar
20
8
备注
其他补充内容
否
MORE
varchar
256
A.15 入栏结算区信息
用于行业监管与服务平台向企业发送入栏结算区信息。
行业监管与服务平台将数据发送到消息队列中,并由企业从消息队列读取数据,数据有更新时传输。
基本信息数据项描述见表A.16。
表A.16 入栏结算区信息数据项表
序号
属性项名称
描述
是否必填
字段名称
字段类型
字段最大长度(字节)
1
名称
入栏结算区范围描述
是
NAME
varchar
50
2
编码
行业管理部门编码
是
CODE
varchar
12
3
性质
1:
交通枢纽,2:
地铁沿线,3:
商业区,4:
办公区,5:
住宅小区,6:
学校,7:
景区,8:
其他
是
ATTIBUTE
varchar
1
4
类型
1:
临时,2:
长期,3:
其他
是
TYPE
varchar
1
表A.16入栏结算区信息数据项(续)
序号
属性项名称
描述
是
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 互联网 租赁 自行车 系统 数据 接口 协议