区域内停车提醒服务
简要描述
生产型企业或者销售型企业，对于销售有区域限制的时候，因为价格差异，经常会出现 不法经销商进行串货。 生产型企业的风控部门，针对已知的部分串货区域，进行围栏检测，进入围栏后，若有停车，则疑似串货，实时通知风控部门。企业风控部门进行实时监控和处理。
说明
本服务包含 5 个接口：区域注册接口，车辆订阅接口，车辆停车时间通知接口，删除车辆订阅接口，删除区域接口。
规则
1.注册后 1 分钟生效，生效后 10 分钟（默认阈值），开始推送数据 2.删除围栏的情况：客户自己删除。 3.删除围栏的情况：删除订阅车辆时，若该围栏下没有绑定的车辆，围栏会立即删除。 4.删除围栏的情况：用户账号有效期，过期时，围栏会自动删除。 提醒：注册车辆和围栏后，使用完成请及时删除，长期不删除，车辆进出围栏会一直推 送消息，扣费较多（按推送扣费）。
Header
请求前都需要设置Token
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| Token | 是 | string | 应用令牌 |
区域注册
请求地址
/v4/api/fence/operateOperateAreaReg请求参数
| 参数名 | 必选 | 类型 | 层级 | 说明 | 示例 |
|---|---|---|---|---|---|
| areaname | 是 | string | 1 | 自定义区域名称（名称不能超 25个字符，不能包含特殊字符，比如下划线） | 北仑港 |
| lonlats | 是 | string | 1 | GCJ02 高德坐标系，自定义区域坐标格式：经度,纬度英文逗号分隔,多个用|分割。坐标点的个数，最少 4 个，最多20 个（多边形）（第一个和最后一个必须一样）,圆心坐标格式：经度,纬度以英文逗号分隔。 | 113.796387,41.19519|118.410645,41.228249|117.773438,40.245992|116.015625,40.212441|114.938965,39.520992113.796387,41.19519（多边形）；116.015625,40.212441（圆形） |
| type | 是 | string | 1 | 订阅类型：1：指定车辆 | 1 |
| actiontype | 是 | string | 1 | 事件类型：1 驶入；2 驶出；3 区域内停车；4 驶入+驶出；5 驶入+驶出+驶出超时；6 驶入+区域内停车；7 驶入+驶出+区域内停车；8 驶入+驶出+区域内停车+驶出超时； | 1 |
| timeout | 是 | string | 1 | 驶出超时（单位：分钟）驶出超时时间=驶出时间-驶入时间,（要求正整数据） | 20 |
| stoptime | 是 | string | 1 | 区域内停车时长（单位：分钟）不能小于 5 | 5 |
| coorType | 是 | string | 1 | 坐标类型 2.百度、3.高德 | 3 |
| areatype | 否，不传默认是1 | string | 1 | 区域类型 1 多边形 2 圆形 | 1 |
| radius | 否，Areatype为2时，必传 | string | 1 | 半径（单位：米）最小 500M，最大 30000M | 1000 |
json
{
"areaname":"北京",
"lonlats":"116.015625,40.212441",
"type":"1",
"actiontype":"3",
"stoptime":"5",
"timeout":"20",
"areatype":"2",
"radius":"1000",
"coorType":"3"
}返回参数
| 参数名 | 类型 | 层级 | 说明 |
|---|---|---|---|
| code | int | 1 | 状态码 |
| msg | string | 1 | 请求结果 |
| total | int | 1 | 返回总条数 |
| requestId | string | 1 | 请求编号 |
| data | object | 1 | 返回数据 |
| 输出参数名称 | 输出参数字段 | 示例数据 | 备注 |
|---|---|---|---|
| 自定义区域ID | areaid | 5239375 | 当注册成功时返回自定义区域ID，失败时为空 |
| 状态 | state | 1 | 1：注册成功，2：注册失败，3：区域名称被占用 |
json
{
"code": 200,
"data": {
"areaid": "5239375***6697772",
"state": "1"
},
"msg": "业务处理成功",
"total": null,
"requestId": "97183569-113010"
}车辆订阅接口
请求地址
/v4/api/fence/operateFenceSubscribe请求参数
| 参数名 | 必选 | 类型 | 层级 | 说明 | 示例 |
|---|---|---|---|---|---|
| vnos | 是（最大支持 50 个） | string | 1 | 车牌号_车牌颜色，英文逗号分隔车牌颜色：1 蓝色，2 黄色 | 京A12345_1 |
| areaid | 是 | string | 1 | 自定义区域 ID | 85225156456 |
json
{
"vnos":"鲁RT5**_2",
"areaid":"6863**552747412993"
}返回参数
| 参数名 | 类型 | 层级 | 说明 |
|---|---|---|---|
| code | int | 1 | 状态码 |
| msg | string | 1 | 请求结果 |
| total | int | 1 | 返回总条数 |
| requestId | string | 1 | 请求编号 |
| data | object | 1 | 返回数据 |
data
| 输出参数名称 | 输出参数字段 | 示例数据 | 备注 |
|---|---|---|---|
| 结果 | result | 2 | 1：成功，2：自定义区域 ID 不存在 |
json
{
"code": 200,
"data": {
"result": "2"
},
"msg": "业务处理成功",
"total": null,
"requestId": "1292fecf-285567"
}车辆停车事件通知
你们需要提供一个 POST 请求接口，Content-Type为application/json，接收以下所有参数。入参列表如下：
参数
| 参数名 | 类型 | 层级 | 说明 |
|---|---|---|---|
| vco | string | 1 | 颜色（1 蓝色，2 黄色） |
| areaId | string | 1 | 区域 ID |
| type | string | 1 | 区域 ID |
| areaName | string | 1 | 区域名称 |
| utc | string | 1 | 事件类型：5 区域内停车；8:驶出超时； |
| vin | string | 1 | 时间：UTC 格式精确到毫秒 |
| stopLonlat | string | 1 | 停靠点经纬度(GCJ02 高德坐标系，小数点后小于等于 7 位)，格式：经度,纬度二 者以英文逗号分隔 |
| stopAddr | string | 1 | 停靠点位置 |
| stopStartTime | String | 1 | 停靠开始时间 |
车辆取消订阅接口
请求地址
/v4/api/fence/operateFenceUnsubscribe请求参数
| 参数名 | 必选 | 类型 | 层级 | 说明 | 示例 |
|---|---|---|---|---|---|
| vnos | 是 | string | 1 | 车牌号_车牌颜色，英文逗号分隔，一次请求最多 100 个车牌号 车牌颜色：1 蓝色，2 黄色 | 京 A12345_1,京 B12345_2 |
| areaid | 是 | string | 1 | 自定义区域 ID | 48649262BA33928BE050A8C0366804C9 |
json
{
"vnos" : "鲁R**9_2",
"areaid": "4882**45451529396"
}返回参数
| 参数名 | 类型 | 层级 | 说明 |
|---|---|---|---|
| code | int | 1 | 状态码 |
| msg | string | 1 | 请求结果 |
| total | int | 1 | 返回总条数 |
| requestId | string | 1 | 请求编号 |
| data | object | 1 | 返回数据 |
data
| 输出参数名称 | 输出参数字段 | 示例数据 | 备注 |
|---|---|---|---|
| 结果 | result | 2 | 1：成功，2：自定义区域 ID 不存在 |
json
{
"code": 200,
"data": {
"result": "2"
},
"msg": "业务处理成功",
"total": null,
"requestId": "1292fecf-285567"
}删除自定义区域注册接口
请求地址
/v4/api/fence/operateFenceAreaUnReg请求参数
| 参数名 | 必选 | 类型 | 层级 | 说明 | 示例 |
|---|---|---|---|---|---|
| areaid | 是 | string | 1 | 自定义区域 ID | 48649262BA33928BE050A8C0366804C9 |
json
{
"areaid":"48821367454***529396"
}返回参数
| 参数名 | 类型 | 层级 | 说明 |
|---|---|---|---|
| code | int | 1 | 状态码 |
| msg | string | 1 | 请求结果 |
| total | int | 1 | 返回总条数 |
| requestId | string | 1 | 请求编号 |
| data | object | 1 | 返回数据 |
data
| 输出参数名称 | 输出参数字段 | 示例数据 | 备注 |
|---|---|---|---|
| 结果 | result | 2 | 1：成功，2：自定义区域 ID 不存在，3：已删除 |
json
{
"code": 200,
"data": {
"result": "2"
},
"msg": "业务处理成功",
"total": null,
"requestId": "1292fecf-285567"
}