园区智能体 CampusGo-创建云上共享单车检测作业:URI

时间:2023-11-01 16:13:47

URI

  • URI格式
    POST /v2/{project_id}/services/c-sharedbicycledetection-cloud/tasks
  • 参数说明

    参数

    是否必选

    类型

    说明

    project_id

    String

    服务所在区域对应的项目ID,获取方法请参见获取项目ID

    请求

    • 请求样例(VIS输入+DIS输出)
      POST /v2/6204a5bd270343b5885144cf9c8c158d/services/c-sharedbicycledetection-cloud/tasks{    "name": "sharedbicycledetection-cloud-task",    "description": "Sharedbicycledetection task test",    "input": {        "type": "vis",        "data": [            {                "stream_name": "sharedbicycledetection-cloud-video",                "index": 0            }        ]    },    "output": {        "dis": {            "stream_name": "dis-sharedbicycledetection-cloud"        }    },    "service_version": "3.0",    "resource_order_id": "840a5cf90d4a4bbaa71f251dfe8fe64e",    "service_config": {        "common": {"alert_mode": "single",              "alert_detection_interval": 60,              "illegal_park_alert_threshold": 30,              "render_result_sw": 1,              "target_roi": "{\"polygons\":[{\"data\":[[84,389],[1840,349],[1824,526],[78,526]]}]}",              "image_compression_ratio":90        }   }}
    • 参数说明

    参数

    是否必选

    类型

    说明

    name

    String

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

    description

    String

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

    input

    Object

    视频数据输入列表,目前云上共享单车检测支持以下输入类型:

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

    service_version

    String

    功能版本号,版本号为3.0。

    resource_order_id

    String

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

    output

    Object

    结果数据的输出列表,目前支持将结果输出到您指定的通道中,输出类型为“dis”

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

    service_config

    Object

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

  • service_config参数格式

    字段

    是否必选

    类型

    说明

    alert_mode

    String

    对应控制台的界面参数“告警模式”

    共享单车违停告警模式,共有两种告警模式:

    • "single": 表示单次告警模式,每当出现新的告警目标时,上报告警信息。
    • "periodic": 表示周期告警模式,每过一个检测周期,上报当前所有告警目标信息。

    默认值:"single"。

    alert_detection_interval

    Int

    对应控制台的界面参数“检测周期”

    共享单车违停检测周期,单位为秒。取值范围为[1, 3600]。

    默认值:60。

    illegal_park_alert_threshold

    Int

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

    告警触发时间阈值,单位秒,取值范围[10,300]。共享单车停留超过这个时间则告警。

    默认值:30。

    all_print

    Int

    对应控制台的界面参数“全告警渲染开关”。

    是否开启全渲染开关在输出图片中,取值范围[0, 1],默认值为0:

    • "0":表示绘制只当前告警的目标边框,渲染方式见normal_render字段介绍;
    • "1":表示在画面中绘制所有告警过的违停共享单车,新增的告警目标与其余渲染目标在框的颜色上有所区分。

      当normal_render为0时,当前告警用红框+warning标志+红色底色渲染,历史告警用黄框+黄色底色渲染。

      当normal_render为1时,当前告警用红框渲染,历史告警用暗红色框渲染。

    只有在目标框渲染开关打开时,该字段才会生效。

    render_result_sw

    Int

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

    是否开启检测框渲染在输出图片中(渲染方式见normal_render字段说明),取值范围:

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

    默认值为0。

    target_roi

    String

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

    • 合法停车区域,区域参数用"name":"legal"标识。车辆停在合法停车区域时不会触发违停事件;当"name"缺省时默认为合法停车区域。
    • 禁止停车区域,区域参数用"name":"illegal"标识。当有车辆停在禁止停车区域,则会触发违停事件。
    • 若name为"legal"和"illegal"以外的任何值,该区域默认为合法停车区域。

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

    例如:

    {"polygons":[{"data":[[84,389],[1840,349],[1824,526],[78,526]],"name":"illegal"}]}

    参数没有携带时,默认整个视频帧都不是合法停车区,都是禁止停车区域。

    image_compression_ratio

    Int

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

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

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

    normal_render

    Int

    对应控制台的界面参数“经典渲染开关”。取值范围[0,1]。默认值为0。

    当all_print字段为0时,采用如下方式进行画面目标渲染。

    当为1时,对目标框采用红框标记。

    当为0时,对目标框采用红色边框+红色底色,同时在框左上角位置标上warning标志。

    all_print字段为1时,仍需参考all_print的值进行画面渲染,详见all_print字段介绍。

support.huaweicloud.com/api-campusgo/campusgo_03_0189.html