视频接入分析服务 VIAS-创建边缘非机动车检测作业:请求

时间:2023-12-26 14:16:17

请求

  • 请求样例1(摄像头输入+DIS/Webhook输出)
    POST /v2/6204a5bd270343b5885144cf9c8c158d/services/c-non-motor-detection-edge/tasks
    {
        "name": "c-non-motor-detection-edge-task",
        "description": "c-non-motor-detection-edge task test",
        "input": {
            "type": "edgecamera",
            "data": [
                {
                    "id": "9f8933c9-448c-48e5-8bc0-631ea83b92eb",
                    "index": 0
                }
            ]
        },
        "output": {
            "dis": {
                "stream_name": "dis-c-non-motor-detection-edge"
            },
            "webhook": {
                "url": "https://apigw.huawei.com/api/event/callback",
                "headers": {
                    "content-type":"application/json"
                }
            }
        },
        "service_version": "3.0",
        "resource_order_id": "840a5cf90d4a4bbaa71f251dfe8fe64e",
        "edge_pool_id": "8dcf5ec7bc4d4a26aa1d3e1bb5ed2b5a",
        "service_config": {
            "common": {
                  "event_disappear_alert_sw": 0,
                  "illegal_park_detection_sw": 1,
                  "illegal_park_alert_threshold": 30,
                  "intrusion_detection_sw": 0,
                  "electromobile_detect_sw": 1,
                  "bicycle_detect_sw": 1,
                  "target_roi": "{\"polygons\":[{\"data\":[[43,266],[42,645],[472,644],[416,212]],\"name\":\"legal_area\"},{\"data\":[[311,182],[282,670],[941,661],[835,170]],\"name\":\"prohibit_entering_area\"}]}",
                  "render_result_sw": 1,
                  "render_roi_sw": 1,
                  "image_compression_ratio":90
                 }
            }
    }
  • 请求样例2(edgerestful输入+DIS/Webhook输出)
    POST /v2/6204a5bd270343b5885144cf9c8c158d/services/c-non-motor-detection-edge/tasks
    {
        "name": "c-non-motor-detection-edge-task",
        "description": "c-non-motor-detection-edge task test",
        "input": {
            "type": "edgerestful",
            "data": [
                {
                    "index": 0,
                    "url":"https://100.127.134.69:554/test/data",
                    "certificate_check": false,
                    "rtsp_path_in_response": "data/url"
                }
            ]
        },
        "output": {
            "dis": {
                "stream_name": "dis-c-non-motor-detection-edge"
            },
            "webhook": {
                "url": "https://apigw.huawei.com/api/event/callback",
                "headers": {
                    "content-type":"application/json"
                }
            }
        },
        "service_version": "3.0",
        "resource_order_id": "840a5cf90d4a4bbaa71f251dfe8fe64e",
        "edge_pool_id": "8dcf5ec7bc4d4a26aa1d3e1bb5ed2b5a",
        "service_config": {
             "common": {
                  "event_disappear_alert_sw": 0,
                  "illegal_park_detection_sw": 1,
                  "illegal_park_alert_threshold": 30,
                  "intrusion_detection_sw": 0,
                  "electromobile_detect_sw": 1,
                  "bicycle_detect_sw": 1,
                  "target_roi": "{\"polygons\":[{\"data\":[[43,266],[42,645],[472,644],[416,212]],\"name\":\"legal_area\"},{\"data\":[[311,182],[282,670],[941,661],[835,170]],\"name\":\"prohibit_entering_area\"}]}",
                  "render_result_sw": 1,
                  "render_roi_sw": 1,
                  "image_compression_ratio":90
                 }
    
           }
    }
  • 请求样例3(VCN输入+DIS/Webhook输出)
    POST /v2/6204a5bd270343b5885144cf9c8c158d/services/c-non-motor-detection-edge/tasks
    {
        "name": "c-non-motor-detection-edge-task",
        "description": "c-non-motor-detection-edge task test",
        "input": {
            "type": "vcn",
            "vcn":{
                    "ip":"172.100.119.6",
                    "password":"CQeNfcRLwyMvH77AkDBaPS+BKXdFu/1bAXtIMNTx3QPbVewjipNq06nNodxWI28I1lCUsvv2+wB1joepzynLVW3g2nz0k9vaCRDoK6=",
                    "port":"4675",
                    "username":"testname"
            },
            "data": [
                {
                    "index": 0,
                    "deivce_id":"07211540881586160101#f7964493ff764bbf9294d58b22e63de6",
                    "stream_type":1
                }
            ]
        },
        "output": {
            "dis": {
                "stream_name": "dis-c-non-motor-detection-edge"
            },
            "webhook": {
                "url": "https://apigw.huawei.com/api/event/callback",
                "headers": {
                    "content-type":"application/json"
                }
            }
        },
        "service_version": "3.0",
        "resource_order_id": "840a5cf90d4a4bbaa71f251dfe8fe64e",
        "edge_pool_id": "8dcf5ec7bc4d4a26aa1d3e1bb5ed2b5a",
        "service_config": {
             "common": {
                  "event_disappear_alert_sw": 0,
                  "illegal_park_detection_sw": 1,
                  "illegal_park_alert_threshold": 30,
                  "intrusion_detection_sw": 0,
                  "electromobile_detect_sw": 1,
                  "bicycle_detect_sw": 1,
                  "target_roi": "{\"polygons\":[{\"data\":[[43,266],[42,645],[472,644],[416,212]],\"name\":\"legal_area\"},{\"data\":[[311,182],[282,670],[941,661],[835,170]],\"name\":\"prohibit_entering_area\"}]}",
                  "render_result_sw": 1,
                  "render_roi_sw": 1,
                  "image_compression_ratio":90
                 }
           }
    }
  • 参数说明

    参数

    是否必选

    类型

    说明

    name

    String

    作业名称,只能由中文、字母(a~zA~Z)、数字(0~9)、中划线(-)、下划线(_)组成,长度范围为[1,100]。

    description

    String

    作业描述信息,最大长度为500字符长度。

    input

    Object

    视频数据输入列表,支持从指定的边缘摄像头读取数据,即输入类型为“edgecamera”“edgerestful”“VCN”

    详细参数定义参见task.input(任务输入参数)

    service_version

    String

    功能版本号,版本号为3.0。边缘算法版本支持的显卡硬件为T4和Davinci芯片。

    resource_order_id

    String

    购买的算法能力包ID,在服务界面购买算法能力包获取。

    edge_pool_id

    String

    边缘运行池ID,获取方法参见创建边缘运行池

    output

    Object

    结果数据的输出列表,目前支持以下输出类型:
    • DIS:将结果输出到您指定的DIS通道 。
    • Webhook:将结果输出到Webhook URL。
    • Localpath:将作业的运行结果保存在边缘节点本地(节点必须为linux系统),必须为linux路径,例如“/opt/cloud/”

      详细参数定义见task.output(任务输出参数)

    service_config

    Object

    服务的算法配置,配置参数见ServiceConfig参数说明

  • service_config中common参数说明

    字段

    是否必选

    类型

    说明

    event_disappear_alert_sw

    Int

    对应控制台的界面参数“事件消失告警开关”

    取值范围:

    • "0":表示不开启。
    • "1":表示开启。

    默认值为0。

    illegal_park_detection_sw

    Int

    对应控制台的界面参数“违停检测开关”

    违停检测开关,取值范围[0,1]:

    • 0: 表示不检测违停事件。
    • 1: 表示检测违停事件。

    默认值:1。

    illegal_park_alert_threshold

    Int

    对应控制台的界面参数“告警触发时间”

    告警触发时间阈值,当illegal_park_detection_sw=1时该参数生效。单位秒,取值范围[10,300]。电动车停留超过这个时间则告警。

    默认值:30。

    intrusion_detection_sw

    Int

    对应控制台的界面参数“入侵检测开关”

    • 0: 表示不检测入侵事件。
    • 1: 表示检测入侵事件。

    默认值:0。

    electromobile_detect_sw

    Int

    对应控制台的界面参数“电动车检测开关”

    • 0: 表示不检测电动车。
    • 1: 表示检测电动车。

    默认值:1。

    bicycle_detect_sw

    Int

    对应控制台的界面参数“自行车检测开关”

    • 0: 表示不检测自行车。
    • 1: 表示检测自行车。

    默认值:1。

    target_roi

    String

    对应控制台的界面参数“区域设置”

    电动车检测区域设置,包括合法停车区域、非法停车区域、禁止进入区域。

    • 合法停车区域,区域参数。用"name":"legal_area"标识。当电动车停在合法停车区域之外,则触发违停事件。
    • 非法停车区域,区域参数。用"name":"illegal_area"标识。当电动车停在非法停车区域时,则触发违停事件。
    • 禁止进入区域,区域参数。用"name":"prohibit_entering_area"标识。当有电动车入侵禁止进入区域,则触发入侵事件。

    该字段为JSON格式的字符串,API调用时需要加转义符。详细JSON格式参见target_roi(目标区域)

    例如:

    {"polygons":[{"data":[[43,266],[42,645],[472,644],[416,212]],"name":"legal_area"},{"data":[[311,182],[282,670],[941,661],[835,170]],"name":"prohibit_entering_area"},{"data":[[1272,592],[1481,813],[1623,638],[1293,356]],"name":"illegal_area"}]}

    当同时设置"legal_area"与"illegal_area"时,生效的为"illegal_area",在绘制渲染区域时,也只会渲染非法停车区域。

    参数没有携带时,默认全屏都是不合法停车区域,在绘制渲染区域时,只会在左上角[0,0]-[0,0]位置绘制一个绿色的合法停车区域;全屏都是禁止进入区域。

    render_result_sw

    Int

    对应控制台的界面参数“目标框渲染开关”

    输出图像是否绘制告警目标边框,取值范围:

    • "0":表示不绘制。
    • "1":表示用红色绘制告警目标边框。

    默认值为0。

    render_roi_sw

    Int

    对应控制台的界面参数“检测区域渲染开关”

    输出图像是否绘制检测区域,取值范围:

    • "0":表示不绘制。
    • "1":表示用绿色绘制用户设定的合法停车区域,用黄色绘制用户设定的禁止进入区域或者非法停车区域。

    默认值为0。

    image_compression_ratio

    Int

    对应控制台的界面参数“图片压缩比”

    输出图片压缩百分比,取值范围为[20,100]。

    默认值:90,表示图片压缩比为90%。

support.huaweicloud.com/api-vias/vias_03_0123.html