创建行政区划围栏

POST

/api/v3/fence/createdistrictfence

请求示例

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'https://yingyan.baidu.com/api/v3/fence/createdistrictfence?service_id=127980&keyword=北京市&ak=&sn='

响应示例

成功示例

{
  "status": 0,
  "message": "成功",
  "fence_id": 1,
  "district": "北京市海淀区"
}

请求参数

Query 参数

service_id

integer

必需

service的唯一标识

示例值:

127980

fence_name

string

围栏名称

可选

示例值:

站点1

monitored_person

string

可选

监控对象；监控对象的entity_name，使用说明： 1、监控一个entity（私有围栏：一个entity最多创建100个私有围栏，service总私有围栏个数无限制）规则：monitored_person=entity_name 示例：monitored_person=张三 2、监控多个entity（公共围栏：一个service默认最多创建1000个公共围栏，若需更高围栏限额可通过反馈平台联系购买，一个service支持公共围栏个数上限为10万个）首先按照监控一个entity的方法创建围栏，再调用geofence/addmonitoredperson接口添加其他entity 3、监控service下全部entity（公共围栏：一个service默认最多创建1000个公共围栏，若需更高围栏限额可通过反馈平台联系购买，一个service支持公共围栏个数上限为10万个）规则：monitored_person=#allentity "#allentity"为监控全部entity的特殊字符

示例值:

小明

keyword

string

必需

多行政区划关键字；支持中国国家、省、市、区/县、乡镇名称。请尽量输入完整的行政区层级和名称，保证名称的唯一性。若输入的行政区名称匹配多个行政区，围栏将创建失败。示例：中国北京市湖南省长沙市湖南省长沙市雨花区

示例值:

北京市

denoise

integer

可选

围栏去噪参数；单位：米。每个轨迹点都有一个定位误差半径radius，这个值越大，代表定位越不准确，可能是噪点。围栏计算时，如果噪点也参与计算，会造成误报的情况。设置denoise可控制，当轨迹点的定位误差半径大于设置值时，就会把该轨迹点当做噪点，不参与围栏计算。denoise默认值为0，不去噪。

示例值:

100

string

必需

开发者的访问密钥，必填项。v2之前该属性为key。申请秘钥

默认值:

string

可选

可选，若开发者所用AK的校验方式为SN校验时该参数必须。

默认值:

返回响应

🟢200成功

application/json

Body

status

integer

必需

状态码；返回状态，0为成功

message

string

必需

响应信息；对status的中文描述

fence_id

integer

必需

fence的id；status=0，围栏创建成功时返回

district

string

必需

结构化的行政区划描述；status=0，围栏创建成功时返回该字段

district_list

array[string]

必需

关键字匹配的行政区划列表，status=5108，围栏创建失败，关键字匹配至多个行政区时，返回该字段

修改于 2022-08-22 02:54:05

更新线型围栏

更新行政区划围栏