文档首页/ 园区智能体 CampusGo/ API参考/ 云上服务API/ 云上消防通道占用/ 创建云上消防通道占用作业

更新时间：2022-03-17 GMT+08:00

查看PDF

创建云上消防通道占用作业

功能介绍

该API可分析输入的视频流，提供消防通道占用检测功能。当检测到占道行为时，会上报告警信息。

视频编码格式支持H264或者H265。

调试

您可以在API Explorer中调试该接口。

URI

URI格式

POST /v2/{project_id}/services/c-fire-exit-occupation-cloud/tasks

参数说明

参数	是否必选	类型	说明
project_id	是	String	服务所在区域对应的项目ID，获取方法请参见获取项目ID。

请求

请求样例（VIS输入+DIS输出）

POST /v2/6204a5bd270343b5885144cf9c8c158d/services/c-fire-exit-occupation-cloud/tasks
{
    "name":"fire-exit-occupation-cloud-task",
    "description":"fire-exit-occupation task test",
    "input":{
        "type":"vis",
        "data":[
            {
                "stream_name":"fire-exit-occupation-stream",
                "index":0
            }
        ]
    },
    "output":{
        "dis":{
            "stream_name":"dis-fire-exit-occupation"
        }
    },
    "service_version":"3.0",
    "resource_order_id":"840a5cf90d4a4bbaa71f251dfe8fe64e",
    "service_config":{
        "common":{
            "image_compression_ratio": 90,
            "render_roi_sw": 1,
            "render_result_sw": 1,
            "stacking_occupation_sw": 1,
            "vehicle_occupation_sw": 1,
            "stacking_residence_time": 40,
            "vehicle_residence_time": 50,
            "target_roi": "{\"polygons\":[{\"data\":[[0, 0], [0, 1000], [1920, 1000], [1920, 0]]}]}"
        }
    }
}

参数说明

参数	是否必选	类型	说明
name	是	String	作业名称，只能由中文、字母（a～zA～Z）、数字（0～9）、中划线（-）、下划线（_）组成，长度范围为[1，100]。
description	否	String	作业描述信息，最大长度为500字符长度。
input	是	Object	视频数据输入列表，目前云上消防通道占用支持以下输入类型： vis：从视频接入服务中读取视频数据。详细参数定义参见task.input（任务输入参数）。
service_version	是	String	功能版本号，版本号为3.0。
resource_order_id	是	String	购买的算法能力包ID，在服务界面购买算法能力包获取。
output	是	Object	结果数据的输出列表，目前支持将结果输出到您指定的通道中，输出类型为“dis”。详细参数定义参见task.output（任务输出参数）。
service_config	否	Object	服务的算法配置，配置参数见ServiceConfig参数说明。

service_config中common的参数说明

字段	是否必选	类型	说明
image_compression_ratio	否	Int	对应控制台的界面参数“图片压缩比”。图片压缩百分比，取值范围为[20，100]。默认值：90，表示图片压缩比为90%。
render_result_sw	否	Int	对应控制台的界面参数“目标框渲染开关”。输出图像是否绘制告警目标边框，取值范围: "0"：表示不绘制。 "1"：表示用红色绘制告警目标边框。默认值为0。
render_roi_sw	否	Int	对应控制台的界面参数“检测区域渲染开关”。输出图像是否绘制检测区域，取值范围: "0"：表示不绘制。 "1"：表示用黄色绘制用户设定区域。默认值为0。
stacking_occupation_sw	否	Int	对应控制台的界面参数“堆物占道检测开关”。取值范围: "0"：表示不开启。 "1"：表示开启。默认值为1。
vehicle_occupation_sw	否	Int	对应控制台的界面参数“车辆占道检测开关”。取值范围: "0"：表示不开启。 "1"：表示开启。默认值为1。
stacking_residence_time	否	Int	对应控制台的界面参数“堆物占道停留时间设置”。堆物在无明显遮挡的情况下停留时间超过该设置值则上报告警，其设置取值范围为[10, 3600]，默认值为40，单位秒。
vehicle_residence_time	否	Int	对应控制台的界面参数“车辆占道停留时间设置”。车辆在无明显遮挡的情况下停留时间超过该设置值则上报告警，其设置取值范围为[10, 3600]，默认值为50，单位秒。
target_roi	否	String	对应控制台的界面参数“检测区域设置”。表示检测区域，该字段为JSON格式的字符串，API调用时需要加转义符。详细JSON格式参见target_roi（目标区域）。例如： {"polygons":[{"data":[[84,389],[1840,349],[1824,526],[78,526]]}]} 参数没有携带时，默认区域为整个视频帧。

响应

响应样例

[
  { 
    "id": "2f268b9472a544e991eae3c5c3534f5b"
  }
]

返回作业ID列表

参数	类型	说明
id	String	作业ID。

检测结果

输出JSON数据流到DIS指定的通道，包括告警结构化数据和图片数据。
JSON结果包括车辆占用消防通道报警以及堆物占用消防通道报警

车辆占用消防通道报警json实例

{
    "event_type": 1179649,
    "task_id": "2f268b9472a544e991eae3c5c3534f5b",
    "stream_id": "fire-exit-occupation-stream",
    "timestamp": 1560346229,
    "message_id": "0DD1BEA6-634B-11E8-8B0B-407D0FAD9218",
    "image_base64":"/9j/4AAQSkZJRgA...",
     "data":{
         "event_set":[
            {
                "detection_id": "83BFC020-4FC8-11EA-9F93-0242AC110004",
                "plate_id":"粤B7821E",
                "bounding_box": {
                    "x":1712,
                    "y":560,
                    "w":207,
                    "h":180
                }
            }
        ]
    }
}

堆物占用消防通道报警json实例

{
    "event_type": 1179648,
    "task_id": "2f268b9472a544e991eae3c5c3534f5b",
    "stream_id": "fire-exit-occupation-stream",
    "timestamp": 1560346229,
    "message_id": "0DD1BEA6-634B-11E8-8B0B-407D0FAD9218",
    "image_base64":"/9j/4AAQSkZJRgA...",
     "data":{
         "event_set":[
            {
                "detection_id": "83BFC020-4FC8-11EA-9F93-0242AC110004",
                "bounding_box": {
                    "x":679,
                    "y":376,
                    "w":483,
                    "h":342
                }
            }
        ]
    }
}

JSON格式说明

字段	类型	说明
stream_id	String	摄像头编号。
event_type	Uint64	快速标识消防通道占用检测的服务输出消息类型。堆物占用消防通道事件其值固定为1179648，对应16进制为 0x 0000 0000 0012 0000。车辆占用消防通道事件其值固定为1179649，对应16进制为 0x 0000 0000 0012 0001。
task_id	String	作业ID。
message_id	String	唯一标识本次输出消息的UUID。
timestamp	Uint64	触发告警时间点的时间戳。
image_base64	String	告警时刻输入的视频图像的Base64编码结果。
data	Object	业务输出内容。

data参数格式说明

字段	类型	说明
event_set	List<Object>	输出事件列表。

event_set参数格式说明

字段	类型	说明
bounding_box	Object	告警输出对象的矩形框。
detection_id	String	告警目标对应的UUID。画面中同一个占道区域，连续检测到的告警ID不变，若跟踪丢失ID会发生变化。
plate_id	String	占道报警中车辆车牌号牌（7位或者8位）。仅当“车辆占道检测开关”vehicle_occupation_sw为1 时有该字段。需要注意的是由于车牌可能存在遮挡、花屏，模糊，若干字段相近等情况，导致车牌检测失败或者不准确，检测失败输出为空字符串。

字段

类型

说明

bounding_box

Object

告警输出对象的矩形框。

detection_id

String

告警目标对应的UUID。画面中同一个占道区域，连续检测到的告警ID不变，若跟踪丢失ID会发生变化。

plate_id

String

占道报警中车辆车牌号牌（7位或者8位）。仅当“车辆占道检测开关”vehicle_occupation_sw为1 时有该字段。

需要注意的是由于车牌可能存在遮挡、花屏，模糊，若干字段相近等情况，导致车牌检测失败或者不准确，检测失败输出为空字符串。

bounding_box参数格式说明

字段	类型	说明
x	Int	矩形框左上角横坐标
y	Int	矩形框左上角纵坐标
w	Int	矩形框宽度
h	Int	矩形框高度

返回值

正常
 201

异常

返回值	说明
400 Bad Request	请求错误，具体返回错误码请参考错误码。
401 Unauthorized	鉴权失败。
403 Forbidden	没有操作权限。
404 Not Found	找不到资源。
500 Internal Server Error	服务内部错误
503 Service Unavailable	服务不可用。

父主题： 云上消防通道占用

上一篇：云上消防通道占用

下一篇：查询作业列表

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问

创建云上消防通道占用作业

功能介绍

调试

URI

请求

响应

检测结果

返回值

相关文档

意见反馈

文档内容是否对您有帮助？

7*24

备案

专业服务

退订

建议反馈

售前咨询热线