电子围栏服务 V1.0

4.4. 电子围栏服务 V1.0

4.4.1. 服务使用场景

通过设置电子围栏，计算车辆触碰等数据，进行分析和汇总，输出围栏触碰数据、评估等分析结果，使用户可以直观了解其围栏使用情况，指导下一步改善方向，以提高用户企业对运输业务的管理能力。

4.4.2. 产品功能说明

智能电子围栏使用可视化的界面及API接口两种接入方式，应用基于车辆行程数据及地图区域数据的大数据算法，在为客户提供电子围栏新增、删除、订阅车辆等管理功能。

4.4.3. 业务规则

支持多边形围栏（多边形区域注册接口）和圆形围栏（自定义区域注册接口）

传入的坐标为84坐标系，小数点后7位，经度与纬度以英文逗号隔开。

多边形围栏，第一个坐标点与最后一个坐标点必须一样。目前仅支持1200个字符，即50个坐标点围成的围栏。

订阅类型为指定车辆。

事件类型：指监控驶入围栏还是驶出围栏。

围栏生命周期：注册后10分钟生效，直至围栏删除。

围栏删除：①客户自己删除。②删除订阅车辆时，若该围栏下没有绑定的车辆，围栏会立即删除。③用户账号有效期过期时，围栏会自动删除。

提醒：注册车辆和围栏后，使用完成请及时删除，长期不删除，车辆进出围栏会一直推送消息持续扣费（按推送扣费）

4.4.4. 电子围栏可视化界面

4.4.4.1. 围栏管理

在客户端电子围栏服务菜单中管理已创建的围栏，支持新增围栏、订阅车辆、围栏设置、删除围栏。

操作流程：
配置 → 新增 → 添加围栏信息 → 订阅车辆 → 新增车辆

4.4.4.2. 创建围栏

支持圆形、矩形/多边形围栏设置，需绑定应用APPID，需设置围栏驶入、驶出类型，当订阅车辆后，基于围栏类型进行通知。

围栏坐标最多支持57个点位。

围栏类型

圆形围栏

支持创建圆形区域围栏，通过设置中心点坐标和半径来定义围栏范围。

矩形围栏

支持创建矩形区域围栏，通过设置四个角点坐标来定义围栏范围。

多边形围栏

支持创建复杂的多边形围栏，最多可设置57个坐标点，适用于不规则区域的围栏设置。

4.4.4.3. 订阅车辆

在电子围栏列表中，点击订阅车辆，进入围栏车辆订阅管理界面，支持新增车辆、删除车辆。

新增车辆

在车辆订阅列表中点击新增进入新增车辆弹窗，支持多车新增，以","隔开。

4.4.5. API对接说明

4.4.5.1. 自定义围栏注册接口

接口基本信息

接口名称：自定义围栏注册接口

请求方式：POST

接口地址：/api/jjzy/save/apis/areaReg

接口方法：ORIGINAL_PLACE

输入参数列表

请求参数	必须参数	参数类型	示例数据	说明
areaname	是	String	北仑港	围栏名称（名称不能超25个字符，不能包含特殊字符，比如下划线）
lonlat	是	String	121.84164,30.893984	圆形经纬度坐标点（GCJ02坐标系）经度在前纬度在后用英文逗号分隔，小数保留6位
radius	是	Int	3	圆形半径（米）
type	是	Int	1	订阅类型：1：指定车辆
actiontype	是	Int	1	事件类型：1进区域通知(目的地)、2出区域通知(起始地)
notifInterval	否	Int	1	通知时间间隔(围栏通知时间间隔，单位为分钟（传-1时只通知一次）)；该参数不传时，每次触发围栏都通知

输出参数列表

响应参数	必须参数	参数类型	示例数据	说明
code	是	Int	200	状态码
message	是	String	请求成功	返回提示消息
data	否	Object	-	获取成功不为空

data字段包含

参数	必须参数	参数类型	示例数据	说明
areaid	是	String	c850ea300cae8ada 699595c6623c8952	自定义区域ID（当注册成功时返回自定义区域ID，失败时为空）
state	是	String	1	1:注册成功、2：注册失败、3重复注册

4.4.5.2. 多边形围栏注册接口

接口基本信息

接口名称：多边形围栏注册接口

请求方式：POST

接口地址：/api/jjzy/save/apis/areaPolygonReg

接口方法：ORIGINAL_PLACE

输入参数列表

请求参数	必须参数	参数类型	示例数据	说明
areaname	是	String	北仑港	围栏名称（名称不能超25个字符，不能包含特殊字符，比如下划线）
lonlats	是	String	113.796387,41.19519\| 118.410645,41.228249\| 117.773438,40.245992\| 116.015625,40.212441\| 114.938965,39.520992\| 113.796387,41.19519	多边形区域坐标点(坐标类型根据coorType判定)；格式：经度,纬度二者以英文逗号分隔,多个坐标用\|分割
type	是	Int	1	订阅类型：1：指定车辆
actiontype	是	Int	1	事件类型：1进区域通知(目的地)、2出区域通知(起始地)
coorType	是	Int	WGS84	多边形注册坐标类型：1:WGS84、2:BD09、3:GCJ02
notifInterval	否	Int	1	通知时间间隔(围栏通知时间间隔，单位为分钟（传-1时只通知一次）)；该参数不传时，每次触发围栏都通知

输出参数列表

响应参数	必须参数	参数类型	示例数据	说明
code	是	Int	200	状态码
message	是	String	请求成功	返回提示消息
data	否	Object	-	获取成功不为空

data字段包含

参数	必须参数	参数类型	示例数据	说明
areaid	是	String	c850ea300cae8ada 699595c6623c8952	自定义区域ID（当注册成功时返回自定义区域ID，失败时为空）
state	是	String	1	1:注册成功、2：注册失败、3：重复注册

4.4.5.3. 删除围栏接口

接口基本信息

接口名称：删除围栏接口

请求方式：POST

接口地址：/api/jjzy/save/apis/areaDel

接口方法：ORIGINAL_PLACE

输入参数列表

请求参数	必须参数	参数类型	示例数据	说明
areaid	是	String	c850ea300cae8ada 699595c6623c8952	围栏ID

输出参数列表

响应参数	必须参数	参数类型	示例数据	说明
code	是	Int	200	状态码
message	是	String	请求成功	返回提示消息
data	否	Object	-	获取成功不为空

data字段包含

参数	必须参数	参数类型	示例数据	说明
result	是	Long	1	1：成功，2：自定义区域ID不存在 3:已删除
status	是	String	1001	状态

4.4. 电子围栏服务 V1.0#

4.4.1. 服务使用场景#

4.4.2. 产品功能说明#

4.4.3. 业务规则#

4.4.4. 电子围栏可视化界面#

4.4.4.1. 围栏管理#

4.4.4.2. 创建围栏#

围栏类型#

4.4.4.3. 订阅车辆#

新增车辆#

4.4.5. API对接说明#

4.4.5.1. 自定义围栏注册接口#

输入参数列表#

输出参数列表#

data字段包含#

4.4.5.2. 多边形围栏注册接口#

输入参数列表#

输出参数列表#

data字段包含#

4.4.5.3. 删除围栏接口#

输入参数列表#

输出参数列表#

data字段包含#

4.4. 电子围栏服务 V1.0

4.4.1. 服务使用场景

4.4.2. 产品功能说明

4.4.3. 业务规则

4.4.4. 电子围栏可视化界面

4.4.4.1. 围栏管理

4.4.4.2. 创建围栏

围栏类型

4.4.4.3. 订阅车辆

新增车辆

4.4.5. API对接说明

4.4.5.1. 自定义围栏注册接口

输入参数列表

输出参数列表

data字段包含

4.4.5.2. 多边形围栏注册接口

输入参数列表

输出参数列表

data字段包含

4.4.5.3. 删除围栏接口

输入参数列表

输出参数列表

data字段包含