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