设置周界识别区域
更新时间：2022-12-08
接口描述
设置周界识别区域。设置后仅对区域内的目标进行识别。该接口会删除设备上当前全部AI的区域设置，然后用本次请求重新设置。
请求结构
PUT /console/api/v1/device/region
请求头域
| 请求头名称 | 描述 | 示例 |
|---|---|---|
| Authorization | 认证头。登录响应返回的token内容，如果不填或者填错会拒绝请求 | Authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyTmFtZSI6ImFkbWluIiwiZXhwIjoxNjY3NDc4OTc4fQ.JL9R7CqIhPFdQWZry4e9ONZntUTmNzBp0sDE05rMxl |
请求参数
| 参数 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| deviceId | Int64 | 是 | 添加设备时返回的唯一标识ID，例如：23 |
| regions | Map | 是 | 区域绘制设置。key是算法英文名称，value是该算法绘制设置。如果regions为空，比如"regions":{} 表示清空全部周界区域。 |
| +ai | String | 是 | 固定为与key相同，表示算法英文名称 |
| +text | String | 是 | 周界区域名称 |
| +bcolor | String | 是 | RGB颜色的十六进制形式，例如： #FF0099 |
| +polygons | Array | 是 | 多边形顶点的顺序表示。支持绘制多个多边形，数组每一项描述一个多边形区域。 |
| ++polygon | Array | 是 | 多边形顶点描述的整数数组。例如[3, 2, 5, 6, 4, 9]表示多边形由(x1=3, y1=2), (x2=5, y2=6),(x3=4, y3=9)这3个点构成 |
响应头域
无特殊响应头。
响应参数
| 参数 | 类型 | 描述 |
|---|---|---|
| status | Int32 | 接口返回状态, 0表示成功，其他表示失败 |
| message | String | 成功或错误提示 |
| data | JSON | 忽略该字段 |
请求示例
PUT /console/api/v1/device/region HTTP/1.1
{
"deviceId": 18,
"regions": {
"jiandao": {
"ai": "jiandao",
"text": "剪刀区域",
"bcolor": "#ff0099",
"polygons": [
{
"polygon": [55, 66, 655, 666, 150, 550]
},
{
"polygon": [155, 166, 1655, 1666, 1150, 1550]
}
]
}
}
}响应示例
{
"status":0,
"message": "success",
"data": null
}