1、规范性）监控系统命名规范省中心的设备名称由五个字段组成，字段采用字母与数字结合的方法，字段长度不限，各字段之间用进行分割，具体见表A.1。省中心设备名称序号字段名称字段含义1机房位置编号用于标识设备安装机房地点，如：城市十机房：省运营管理中心：QH02其余类推2设备功能区编号用于标识功能区，如：核心交换区：CO服务器区：SRV应用功能区：APPSRV互联网区：INTERNET终端接入区：CAM视频监控交换区：VDS数据监控交换区：DDS运维管理区：OM分公司汇聚：MAN其余类推3设备类型编号用于标识类型功能，如：核心层交换机：CS汇聚交换机：DS终端接入层交换机：AS路由器：RT防火墙：FW
2、IPS入侵防御：IPS其余类推4设备编号用于标识网络设备编号，范围为01-995设备位置用于表示设备物理位置，由机柜号和U位组成，如：ClO机柜第30U：C10_30U6命名举例QH02_C0_CS_01_C10_4U青海省运营管理中心二层机房核心交换区核心层交换机01,物理位置于ClO机柜4U分中心及收费站的设备名称由四个字段组成，字段采用字母与数字结合的方法，字段长度不限，各字段之间用进行分割,具体见表A.2：分中心及收费站设备名称序号字段名称字段含义1机房位置编号用于标识设备安装机房地点，如：分公司心名称十收费站名称西宁分公司：XiNing涅源分公司：HuangYuan黄化公伯侠收费站：
3、HuangHua-GongBoXia西宁分公司上新庄：XiNing-ShangXinZhuang其余类推2设备功能区编号用于标识功能区，如：核心交换区：CO视频监控交换区：VDS数据监控交换区：DDS安全直连区：AQ运维管理区：OM其余类推3设备类型编号用于标识类型功能，如：核心层交换机：CS汇聚交换机：DS接入层交换机：AS路由器：RT防火墙：FWIPS入侵防御：IPS其余类推4设备编号用于标识网络设备编号，范围为01-995命名举例XiNing_C0_CS_01西宁分公司核心交换机Ol通信线缆的命名用于标识线缆所连接本端及对端的设备位置及功能型号等信息。通信线缆名称分为上下两行，上行为线缆
4、本端的具体信息，下行为线缆对端的具体信息。每行信息由五个主要字段组成，字段采用字母与数字结合的方法，字段长度不限，各字段之间用”进行分割。具体见表A.3：通信线缆命名位置字段1字段2字段3字段4字段5上行本端机房编号本端设备机柜编号本端设备功能区及型号本端设备编号本端设备端口号下行对端机房编号对端设备机柜编号对端设备功能区及型号对端设备编号对端设备端口号示例1层机房AOl机柜的核心交换机S7706的10G1/0/1端口，连接至2层Aol机柜的S5700接入交换机的10G1/0/1端口，此时线缆的表示应为：F：1F-A01-S7706-01-10G1/0/1T：2F-A02-S5700-01-1
5、0G1/0/1（规范性）省级视频联网云平台对外接口接口说明业务系统调用相关的接口前需要进行登录，登录之后返回的token,止匕token作为接口鉴权依据，调用接口前在请求头加上SOneP-Token值为token,重新登录之前的token会失效。返回结果：data：返回结果数据集，以下返回参数中说明都是在这个数据集message:返回信息status:返回码200为成功，其它为失败）视频联网云平台接口地址一：接口列表登录接口要求如下：请求地址：https:/IP:Portvideonetloginhttps:/video,请求参数：Username=Xxxxxfepassword=xxxxxx
6、返回参数见表B.1：登录接口返回参数数据类型说明msgString返回的信息codeInteger返回码见返回码200成功tokenString鉴权token获取监控摄像机信息接口要求如下：camerainfo获取摄像机信息请求参数请求地址：https:/ip:port/service/camera/camerainfo请求参数：无返回参数（返回只取data里面数据）见表B.2：参数类型是否必填说明CameraNumString是监控摄像机编号CameraNameString是监控摄像机名称aliasNameString是摄像机别名longitudeString是经度latitudeStrin
7、g是维度classifyInteger是摄像机类别0：默认1：道路沿线2：桥梁3：隧道4：收费广场5：收费站6：服务区7：ETC门架8：移动视频源CameraOrientationInteger是上下行0：上行（桩号数字由小到大方向）1：下行（桩号数字由大到小方向）2：上下行（双向）piIeNumString是监控摄像机桩号roadSecNameString是poiNameString是departmentNameString是CameraTypeString是1:监控型枪机2:监控型球机3:全景型4:抓拍型roadldString是摄像机所在路线isnlineInteger是摄像机在线状态：
8、1在线；0离线返回结果:msg：请求成功,code:200,“data：zzdepartmentNamezz:青海省交通控股集团有限公司高速公路运营分公司，所属单位名称aliasName：G0612（德小高速公路）K291+100（德小高速公路）,/摄像机别名ClaSSify：1,/摄像机位置类型见下字典PoiNanIe：德小高速公路，/兴趣点名称“latitude：“37.43847672176532，纬度zzroadldzz:zzG0612zz,/所在路线编码zzIsOnlinezz:0,是否在线见下字典zzCameraOrientationzz:0,摄像机方向见下字典zzCameraTy
9、pezz:1,/摄像机类型见下字典PiIeNUm：K291+100”,桩号zzCameraNumzz:70b3ac35-2038-4e0f-a2e3-052b4ea254ae”,摄像机编号CanIeraNanIe：G0612（德小高速公路）乌兰分中心K291+100（德小高速公路），/摄像机名称zzIongitudezz:“96.22891228455897经度,departmentName：青海省交通控股集团有限公司高速公路运营分公司，WliasName：G0612（德小高速公路）K294+100（德小高速公路），“classify：1,POiName：德小高速公路，“latitude：”3
10、7.440351586536416,QoadId：G0612，“isnline：0,zzCameraOrientationzz:0,zzCameraTypezz:1,zzPileNumzz:K294+100，zzCameraNumzz:zzf3f14ea3-2b38-43c8-9e46-66e0a657078fzz,zzCameraNamezz:G0612（德小高速公路）乌兰分中心K294+100（德小高速公路），longitude:96.18993697497208,departmentName：青海省交通控股集团有限公司高速公路运营分公司，WliasName：G0612（德小高速公路）K2
11、95+800（德小高速公路），“classify：1,PoiNanIe：德小高速公路，latitude:37.43161602713113，“roadld：G0612，“isnline：0,zzCameraOrientationzz:0,zzCameraTypezz:1,PiIeNUm：K295+800”,zzCameraNumzz:zz6d2eabdl-lbec-458b-bald-2f4c80e0c0alzz,zzCameraNamezz:G0612（西和高速）乌兰分中心K295+800（德小路段），longitude:96.16024364460812）,）监控摄像机播放地址接口要求如下
12、接口描述：视频联网云平台通过此接口获取监控摄像机播放的实际地址信息。播放地址要求携带鉴权信息，鉴权含有失效时间，一般情况下，失效时间为服务端生成链接地址后的5秒后，即用户在拿到服务器给的链接地址后，超过5秒再访问，此地址已经失效。接口和访问形式：https:/ip:port/service/video.GetCameraPlayURL?department=xx&cameraNum=xx&videoType=xfeuser=xx接口请求方式：GET接口入参说明见表B.3：监控摄像机播放地址接口入参说明编号数据元名称定义类型值域补充说明1department监控摄像机所属单位名称字符型该值和监
13、控摄像机信息注册/修改接口的department相同2CameraNum监控摄像机编号字符型该值和监控摄像机信息注册/修改接口的CameraNUm相同，如该值为空，表示获取单位下所有监控摄像机的播放地址如果该值不做规定，需给出department所有的监控摄像机播放地址3videoType视频类型数字型0：低码流；1：高码流4user用户名字符型云平台提供接口出参说明见表B.4：监控摄像机播放地址接口接口出参说明编号数据元名称参数名称定义类型值域1监控摄像机编号CameraNum字符型2HTTP-FLV播放地址flv_url字符型3HLS播放地址hls_url字符型4监控摄像机是否可控IsCa
14、merControl数字型0:不可控；1:可控5是否在线online数字型0表示不在线；1表示在线6描述信息message字符型可以填写地点名等接口出参格式:“code:200,r4x-r4./msg:成功，zzVideoRequestUrlzz:zzCameraNumzz:baee05a7-166a-48f8-9a57-3754CIa7ac65，zzflvur,:https:IiVlivesdjilgssxjglsdjilgs3700000IlOl100lOO1046.flv?auth_key=1538982230-0-0-8ff21a60ce4abac52d25411e80cec552zz
15、zzhlsurz:“https:IiVlivesdjilgssxjglsdjilgs3700000IlOl100lOO1046.flv?auth_key=1538982230-0-0-8ff21a60ce4abac52d25411e80cec552zz,zziSCameraContro1/z:0,“online：1,message:空闲通道_XX市XX地上行G6_K1734+500,zzCameraNumzz:baee05a7-166a-48f8-9a57-3754CIa7ac65，zzflvur,:https:IiVlivesdjilgssxjglsdjilgs3700000IlOl100
16、lOO1046.flv?auth_key=1538982230-0-0-8ff21a60ce4abac52d25411e80cec552zz,zzhls_urz:/zlivesdjilgssxjglsdjilgs3700000IlOl100lOO1046.flv?auth_key=1538982230-0-0-8ff21a60ce4abac52d25411e80cec552zz,zziSCameraControl/z:O,zzonlinezz:1,“message”:空闲通道_XX市云台控制接口要求如下：请求地址：https:/IP:Portvideonetservice/video.PTZC
17、ontrol请求参数见表B.5：云台控制接口请求参数参数类型是否必填说明CameraNumString是监控摄像机编号ationInteger是云台动作1:向左2:向右3:向上4:向下5:变倍短6:变倍长7:聚焦近8:聚焦远9:光圈小10:光圈大11:灯光关12:灯光开stepInteger否，当云台控制为1,2,3,4时需要填步长主要用于控制云台转动方向的操作，-8为步长值，1为最小步长，8为最大步长userString是用户名reqSourceInteger是请求来源：0省中心；1为部中心；2app返回参数见表B.6：云台控制接口返回参数参数类型是否必填说明msgString是返回信息co
18、deInteger是返回码：200成功PTZControlObject是如下PTZCOntrOI信息见表B.7：云台控制接口PTZControl信息参数类型是否必填说明messageString是结果描述CameraNameString是摄像机名称statusInteger是0控制成功；1控制失败返回数据:msg:请求成功，code:200,zzPTZContro,:“message：通过云台控制失败,错误码:400,错误信息:非云台相机,不支持云台控制，zzCameraNamezz:S317（绿大高速公路）乌兰分中心K28+050（绿大高速公路），“status：1）交通事件查询接口要求如下
19、视频云联网系统可以接入基于手机信令的大数据分析平台推送的计算结果数据（车流量数据、交通事件数据等）、集中监控系统等系统产生的事件数据（拥堵、压车、逆行等），以及本系统产生的视频分析数据，并通过感知数据融合分析平台将其进行融合计算后以地图、图表等形式呈现。面向公众出行提供高速公路实时事件（如：交通管制和突发状况）查询功能。信息内容包括：名称、地点、时间、影响道路、影响通行方向、限行时间、疏导方式等。请求地址：https:/IP:Portvideonetscamanalyse/page/get请求参数见表B.8：交通事件查询接口请求参数参数类型是否必填说明alertTypeString是事件类型
20、aliasNameString是摄像机名称pageInteger是页码sizeInteger是页码大小返回参数见表B.9：交通事件查询接口返回参数参数名类型是否必填说明alertStartTimeString是事件开始时间alertEndTimeString否事件结束时间alertTypeInteger是事件类型alertTypeDescString是事件类型描述aliasNameString是摄像机别名CameraNumString是摄像机编号roadIdString是路线编号PoadSecNameString是所属分中心监控摄像机图像质量接口要求如下：视频云联网系统提供摄像机图像质量检测服
21、务，也可通过“接收摄像机图像质量检测结果接口”接收视频上云网关上报的摄像机图像质量检测结果，并实现对抽检结果进行多维度的查询和统计。请求地址：https:/IP:Portvideonetscamquality/page/get请求参数见表B.10：监控摄像机图像质量接口请求参数参数类型是否必填说明CameraNameString是摄像机名称pageInteger是页码sizeInteger是页码大小返回参数见表B.IL监控摄像机图像质量接口返回参数参数名类型是否必填说明CameraNameString是摄像机名称CameraNumString否摄像机编号IsBlackscreenInteger
22、是是否黑屏0正常1异常sFrozenInteger是是否图像冻结0正常1异常isBlurInteger是是否图像模糊0正常1异常isBrightAbnormalInteger是是否亮度异常0正常1异常IsNetOnlineInteger是是否网络在线0正常1异常isNoiseInteger是是否有噪声0正常1异常is0cclusionInteger是是否图像遮挡0正常1异常isnlineInteger是是否在线1在线0离线IsRollingstripeInteger是是否滚动条纹0正常1异常IsTwinkleInteger是是否图像闪烁0正常1异常B.11监控摄像机图像质量接口返回参数（续）参
23、数名类型是否必填说明roadSecNameString是所属分中心roadIdString是所属路线编号视频截图接口要求如下：视频截图在上云网关进行,可节约传输开销,转码中产生可调整分辨率的截图,节约解码运算资源,故参照部省平台接口规范，新增此接口。接口描述：省级平台通过此接口获取摄像机的截图地址，一般每路摄像机每5分钟截一次图。请求地址：https:IP:Port/videonet/service/video.SnapShot请求参数见表B.12：视频截图接口请求参数参数类型是否必填说明CameraNumString是摄像机名称beginTimeString是开始时间endTimeStrin
24、g是结束时间pageNumInteger是页码recordsCountInteger是页码大小返回参数见表B.13：视频截图接口返回参数参数名类型是否必填说明pageNumInteger是当前页码recordsCountInteger否总数totalPagesInteger是总页码totalElementsInteger是总分页大小DataList是以下是data里的数据IdlString是唯一标识CameraNumString是摄像机编号SnapShotPathString是截图地址timeString是截图时间主动获取推流地址接口要求如下：接口描述：视频上云网关在向平台推流失败，在故障排除
25、后可通过此接口，发送摄像机CameraNUm信息获取当前摄像机推流地址，以更新当前推流地址鉴权信息。接口和访问形式（方括号内为可变参数）：http:/IP:PORT/service/video.GetPushAddress?user=xx&department=xx接口请求方式：POST接口入参说明见表B.14：主动获取推流地址接口入参说明编号参数参数名称释义类型说明是否必须备注1user用户名用户名string是平台提供2department管辖单位摄像机所属单位名称string摄像机管辖单位一致是数据入参说明见表B.15：主动获取推流地址数据入参说明编号参数参数名称释义类型说明是否必须备注
26、1CameraNums摄像机组存放CanIeraNUlnS的数组arrayCanIeraNUnI为摄像参数，必须与已上报审核数据一致是至少包含1个参数，最多不超过200个接口入参格式:zzCameraNumszz:zzfjlwg3nd-3551-0523-0000-00000000000,.string)接口出参说明见表B.16：主动获取推流地址接口出参说明编号参数参数名称释义类型说明1code响应码应用服务响应情况Integer200为正常，其他异常2msg错误信息应用错误时信息String除正常外3data返回数据返回数据内容Object返回数据data说明见表B.17：主动获取推流地址返
27、回数据说明编号参数参数名称释义类型说明1cameras推流列表摄像机推流列表Array2video码率格式推流的码率格式Object默认低码率推流列表中对象格式cameras说明见表B.18:主动获取推流地址推流列表说明编号参数参数名称释义类型说明1pushURL推流地址摄像机低码率推流地址String地址已凭借鉴权信息2CameraName摄像机编号摄像机编号String视频码率格式video说明见表B.19:主动获取推流地址视频码率说明编号参数参数名称释义类型说明1framerate帧数视频码率帧数String2width宽度画面宽度String3bitrate码率视频码率String4i
28、framei帧间隔i帧间隔String默认255height高度高度String接口出参格式:“code:200“cameras”:zzPushURLzz:rtmp:/:1935/fjlive/fjlwg3nd-3551-0523-0000-000000000001?Auth-key=1606985884-0-9a03e7001e656d4b744523de87ee780/z,)L“video”：“framerate”:50，“width”:352，“bitrate：32，rame:25,“height”:198，其他说明：接口遵循视频联网技术要求中鉴权要求，请求接口请求头需带有数据权限的to
29、ken作为鉴权值，token获取方法遵循技术要求。视频推送停止接口要求如下：接口描述:平台通知视频上云网关设备停止指定的摄像机视频推送，视频上云网关设备处理后，向平台返回处理结果。接口和访问形式（方括号内为可变参数）：https:/ip:port/service/video.VideoTransFinish?catneraName=xxxx&user=xx&videotype=1接口请求方式：GET接口入参说明见表B.20：视频推送停止接口人参说明编号数据元名称定义类型值域补充说明1CameraName摄像机名称字符型该值和监控摄像机信息注册/修改接口的CameraName相同2user用户名
30、字符型平台提供3videotype视频类型字符型0：低码流；1：高码流；2:4MbPm码率;3:源码率接口出参说明见表B.21：视频推送停止接口出参说明编号数据元名称参数名称定义类型值域1摄像机名称CameraName字符型该值和监控摄像机信息注册/修改接口的CameraName相同2结果编号code接口返回结果编号字符型3结果内容info接口返回结果内容字符型文字描述接口出参格式:Code:200,ra-rj./msg:成功,zzbackResultzz:zzCameraNamezz:104*雍庄互通入口,Code：202,“info”:“停止成功”服务状态表见表B.22服务状态表状态码状态
31、码说明MeSSage内容200正常返回或执行201正在推流400下发格式存在异常异常位置信息403权限出错4041、查询时表示该路视频不存在2、切换时表示该路视频故障3、停止时表示该路视频不存在500操作时转码程序内部出现异常上传异常信息（规范性）省级视频联网云平台与视频上云网关接口接口要求接口采用HTTPS协议通讯，HTTP头参数需指定Content-Type值为application/json,并且新增部分HTTP头参数，具体见表C.1：HTTPS头参数编号头参数名称头参数说明类型头参数值说明1TAuth鉴权值字符型值为令牌环token,token遵循OAUth2.0授权机制2AppVer
32、sion应用版本号字符型目前该值为VL0省级视频联网云平台提供给视频上云网关接口监控摄像机点位信息上报接口接口描述：接收数据上报方提供的监控摄像机列表信息，如果监控摄像机存在则对信息进行修改，否则新增。该接口可以一次上报多条监控摄像机信息。优化内容：接口传输字段。thers,用于上报监控摄像机的国标ID,国标ID与内网视频联网云平台监控摄像机国标ID保持一致。接口和访问形式（方括号内为可变参数）：https:/ip:port/service/video.VideoInformation?user=xx接口请求方式：POST接口入参说明见表C.2：监控摄像机点位信息上报接口入参说明编号数据元名称
33、定义类型长度值域1user用户名字符型64云平台提供数据入参说明见表C.3：监控摄像机点位信息上报数据入参说明编号数据元名称参数名定义类型值域必填1监控摄像机所属单位名称department路公司单位名字符型是2监控摄像机编号CameraNum唯一标识字符型采用UUlD4规则是3监控摄像机名称CameraName字符型是表C3监控摄像机点位信息上报数据入参说明（续）编号数据元名称参数名定义类型值域必填4监控摄像机经度、纬度IongAndLati监控摄像机所在地的经纬度信息字符型格式：经度/纬度，小数点保留6位；例如：101.803717/36.5997455监控摄像机所在路线road监控摄像机
34、所在路线字符型例如：G6&S219是6监控摄像机位置类型classify监控摄像机所在位置类型数字型0：默认L道路沿线2：桥梁3：隧道4：收费广场5：收费站6：服务区7：ETC门架8：移动视频源是7监控摄像机方向CameraOrientation上下行数字型0：上行（桩号数字由小到大方向）1：下行（桩号数字由大到小方向）2：上下行（双向）是8监控摄像机桩号piIeNum千米桩号+百米桩号字符型格式:K100+100是9行政区划代码area行政区划代码数字型采用最新的民政部行政区划代码标准是10监控摄像机所在路段roadSec路段单位名称字符型例如：西宁分公司是11监控摄像机类型CameraTy
35、pe数字型1：监控型枪机2：监控型球机3：全景型4：抓拍型是12视频上云网关编号gatewayNum字符型“路段-部机云平台”对接方式时使用，该值由云平台提供是13兴趣点名称poiName监控摄像机具体位置的名称字符型道路监控摄像机上传道路例如：“京藏高速道路”桥梁监控摄像机上传桥梁例如：“老鸦峡一号纵向桥”隧道监控摄像机上传隧道例如：“老鸦峡隧道”收费站上传收费站例如：“乐都收费站”是14其他参数others其他参数字符型扩展预留字段否数据入参格式:“department：青海省交通控股集团有限公司高速公路运营分公司,zzCameraNumzz:aef89ecc-4cc6-4a6d-80fd
36、283196105b0b”,zzCameraNamezz:G6（京藏高速）青海西宁XX段XX单位K1785+570”,1OngAndLati：“101.7782/36.617，road:Go,“classify：1,/zearnerarientationzz:0,zzpileNumzzzK1785+570zz,“area：630100，z,roadSeczz:西宁分公司，zzCameraTypezz:1,zzgatewayNumzz:aef89ecc-4cc6-4a6d-80fd-283196105b0b”,zzpoiNamezz:京藏高速，/,1others:）,“department：青
37、海省交通控股集团有限公司高速公路运营分公司,zzCameraNumzz:aef89ecc-4cc6-4a6d-80fd-283196105b0b”,zzCameraNamezz:G6（京藏高速）青海西宁XX段XX单位K1785+570”,1OngAndLati：“101.7782/36.617，road:Go,“classify:0,zzCameraOrientationzz:zzIzz,zzpileNumz,zK1785+570zz,zzareazz:630100，zzroadSeczz:西宁分公司，z,cameraTypezz:1“gatewayNum：aef89ecc-4cc6-4a6d
38、80fd-283196105b0b”,zzpoiNamezz:京藏高速，others:）接口出参说明见表C.4：监控摄像机点位信息上报出参说明编号数据元名称参数名称定义类型值域1响应码code数字型详见“服务状态码”2响应消息msg字符型文字描述接口出参格式:1code:,“data：(UsioessListzz:,zzCameraStatuszz:O,zdeviceCompaoy,z:1111,zzdirectiOii：O,encodingFormat：11,zzendRegionCodezz:O,fillInPersonzz:，fiHInTel：，,zfunctionType,z:O,g
39、bld：，,zInitialLatitudezz:O,z,initialLongitudezz:O,Installlype:,ip:，isSupportPtz，/:O,kmPile：，z,isSupportSu11z,:0,“latitude：0,1Icr:,link:,zzIocationTypezz:0,zzIongitudezz:0,mantanrg:,mantanPerson:,mantanTel:,zmapLevez:0,model:,name:,orgl:,OriginalName:,zzOsdStatuszz:0,PageAccessType:,PageIp:,PagePort:,password:,PUnUr1：，zzregionCodezz:0,resolution:,roadCode:,zroadEndRegionCodezz:0,roaSec:,zzroadStartRegionCodezz:0,zzshowStatuszz:O,“sort：O,zzspecifIcLocationzz:O,zzStartRegionCodezz:O,user:)Lmsg:,“success：true)监控摄像机信息删除接口接口描述：接收数据上报方提供的删除监控摄像机编号，删除监控摄像机信息。该接口支持一次性删除多个监控摄像
免费区 
