熟车运力池服务

4.7 熟车运力池服务

4.7.1 服务使用场景

熟车运力池业务场景是依托成熟车辆资源构建的运力可视化服务。通过设定特定电子围栏，查询已订阅的车辆是否在围栏内，并展示围栏内车辆位置，为运力智能化调度提供基础车辆运力资源服务。

4.7.2 产品功能说明

调用已订阅的围栏，查询围栏内所有已订阅熟车地理位置。

4.7.3 业务规则

4.7.4 API 对接说明

4.7.4.1 围栏订阅接口

接口名称：围栏订阅接口

请求方式：POST

接口地址：/api/vehPool/regFences

接口方法：MATURE_VEHICLE_CAPACITY_POOL

输入参数列表

请求参数	必须	参数类型	示例数据	说明
list	是	List	`[{}]`	围栏订阅参数集合

list 中对象字段说明：

参数	必须	参数类型	示例数据	说明
code	是	String	123	围栏编号
name	是	String	围栏名称	围栏名称
type	是	Int	1	围栏类型：0 表示圆形，1 表示多边形
points	是	String	137.421235,46.898234; 126.762834,41.238423	围栏坐标点集，格式为 lng,lat；多个点用分号分隔；圆形仅取前两个点，第二点的 lat 为半径；多边形点数不得少于 4 个，最多不超过 20 个；圆形半径不得超过 300 公里

输出参数列表

响应参数	必须	参数类型	示例数据	说明
code	是	Int	200	状态码
message	是	String	请求成功	返回提示消息
data	是	List	`["121203 注册成功","121204 注册成功"]`	围栏订阅结果说明

4.7.4.2 围栏取消订阅接口

接口名称：围栏取消订阅接口

请求方式：POST

接口地址：/api/vehPool/unRegFences

接口方法：MATURE_VEHICLE_CAPACITY_POOL

输入参数列表

请求参数	必须	参数类型	示例数据	说明
fenceCode	是	List	`["123","456"]`	围栏编码集合

输出参数列表

响应参数	必须	参数类型	示例数据	说明
code	是	Int	200	状态码
message	是	String	请求成功	返回提示消息

4.7.4.3 围栏查询接口

接口名称：围栏查询接口

请求方式：POST

接口地址：/api/vehPool/fencesList

接口方法：MATURE_VEHICLE_CAPACITY_POOL

输入参数列表

请求参数	必须参数	参数类型	示例数据	说明
key	否	String	123	围栏编码（可模糊查询，不传默认查全部）
page	是	Int	1	当前页数
rows	是	Int	20	单页显示行数

输出参数列表

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

data 中包含字段：

参数	必须参数	参数类型	示例数据	说明
list	是	List	`[{}]`	结果列表

list 中每项字段说明：

参数	必须参数	参数类型	示例数据	说明
code	是	String	1	围栏编码
name	是	String	围栏名称	围栏名称
type	是	Int	1	围栏类型：0-圆形，1-多边形
points	是	String	87.510307,43.907551;200000,0	围栏坐标点（lat,lng;lat,lng）
createdTime	是	String	2022-12-31 10:34:21	创建时间（yyyy-MM-dd HH:mm:ss）

4.7.4.4 车辆增量订阅接口

接口名称：车辆增量订阅接口

请求方式：POST

接口地址：/api/vehPool/regVehicles

接口方法：MATURE_VEHICLE_CAPACITY_POOL

输入参数列表

请求参数	必须参数	参数类型	示例数据	说明
vehicleNo	是	List	["鲁A12345_2", "京A10000_2"]	车牌号_颜色（颜色见文档最后代码集）

输出参数列表

响应参数	必须参数	参数类型	示例数据	说明
code	是	Int	200	状态码
message	是	String	请求成功	返回提示消息
data	否	List	-	返回订阅结果，包括成功和失败记录

data 中每项字段说明：

参数	必须参数	参数类型	示例数据	说明
vehicleNo	是	String	鲁A12345	车牌号
des	是	String	订阅成功车辆数 1 台	结果描述（成功或失败）

4.7.4.5 车辆取消订阅接口

接口名称：车辆取消订阅接口

请求方式：POST

接口地址：/api/vehPool/unregVehicles

接口方法：MATURE_VEHICLE_CAPACITY_POOL

输入参数列表

请求参数	必须参数	参数类型	示例数据	说明
vehicleNo	是	List	["鲁A12345_2", "京A10000_2"]	车牌号_颜色（颜色见文档最后代码集）

输出参数列表

响应参数	必须参数	参数类型	示例数据	说明
code	是	Int	200	状态码
message	是	String	请求成功	返回提示消息
data	否	List	[{"vehicleNo":"鲁A12345","des":"操作失败"}]	操作失败的车牌号及失败原因，全部成功则为空

data 中字段说明：

参数	必须参数	参数类型	示例数据	说明
vehicleNo	是	String	鲁A12345	车牌号
des	是	String	操作失败	失败原因描述

4.7.4.6 车辆查询接口

接口名称：车辆查询接口

请求方式：POST

接口地址：/api/vehPool/myVehList

接口方法：MATURE_VEHICLE_CAPACITY_POOL

输入参数列表

请求参数	必须参数	参数类型	示例数据	说明
key	否	String	"123"	围栏编码（可模糊查询，不传默认查全部）
page	是	Int	1	当前页数
rows	是	Int	10	单页显示行数

输出参数列表

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

data 字段包含：

字段名	必须参数	参数类型	示例数据	说明
list	是	List	[]	结果列表
total	是	Int	10	总记录数
pageNum	是	Int	1	当前页码，从 1 开始计数
pageSize	是	Int	10	每页显示记录数
pages	是	Int	1	总页数

list 中每项字段说明：

字段名	必须参数	参数类型	示例数据	说明
vehNo	是	String	京 A12345	车牌号
plateColor	是	String	2	车牌颜色（见车牌颜色代码集）
createdTime	是	String	2022-12-31 10:34:21	创建时间，格式：`yyyy-MM-dd HH:mm:ss`

4.7.4.7 熟车围栏查询接口

接口名称：熟车围栏查询接口

请求方式：POST

接口地址：/api/vehPool/getFence

接口方法：MATURE_VEHICLE_CAPACITY_POOL

输入参数列表

请求参数	必须参数	参数类型	示例数据	说明
fenceCode	是	String	"123"	围栏编码

输出参数列表

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

data 中每项字段说明：

字段名	必须参数	参数类型	示例数据	说明
vehicleNo	是	String	京 A12345	车牌号
plateColor	是	String	2	车牌颜色（见车牌颜色代码集）
latitude	是	String	37.978845	纬度
longitude	是	String	114.879996	经度
direction	是	Double	15.0	车辆方向
vec1	是	Int	0	车辆定位仪速度
positionTime	是	Int	1733392392	定位时间（单位：秒）

4.7 熟车运力池服务#

4.7.1 服务使用场景#

4.7.2 产品功能说明#

4.7.3 业务规则#

4.7.4 API 对接说明#

4.7.4.1 围栏订阅接口#

输入参数列表#

list 中对象字段说明：#

输出参数列表#

4.7.4.2 围栏取消订阅接口#

输入参数列表#

输出参数列表#

4.7.4.3 围栏查询接口#

输入参数列表#

输出参数列表#

data 中包含字段：#

list 中每项字段说明：#

4.7.4.4 车辆增量订阅接口#

输入参数列表#

输出参数列表#

data 中每项字段说明：#

4.7.4.5 车辆取消订阅接口#

输入参数列表#

输出参数列表#

data 中字段说明：#

4.7.4.6 车辆查询接口#

输入参数列表#

输出参数列表#

data 字段包含：#

list 中每项字段说明：#

4.7.4.7 熟车围栏查询接口#

输入参数列表#

输出参数列表#

data 中每项字段说明：#

4.7 熟车运力池服务

4.7.1 服务使用场景

4.7.2 产品功能说明

4.7.3 业务规则

4.7.4 API 对接说明

4.7.4.1 围栏订阅接口

输入参数列表

list 中对象字段说明：

输出参数列表

4.7.4.2 围栏取消订阅接口

输入参数列表

输出参数列表

4.7.4.3 围栏查询接口

输入参数列表

输出参数列表

data 中包含字段：

list 中每项字段说明：

4.7.4.4 车辆增量订阅接口

输入参数列表

输出参数列表

data 中每项字段说明：

4.7.4.5 车辆取消订阅接口

输入参数列表

输出参数列表

data 中字段说明：

4.7.4.6 车辆查询接口

输入参数列表

输出参数列表

data 字段包含：

list 中每项字段说明：

4.7.4.7 熟车围栏查询接口

输入参数列表

输出参数列表

data 中每项字段说明：