package com.ycl.web;
|
|
import com.alibaba.fastjson2.JSONObject;
|
import com.ycl.config.HKFeignConfig;
|
import com.ycl.platform.domain.param.HK.*;
|
import org.springframework.cloud.openfeign.FeignClient;
|
import org.springframework.stereotype.Component;
|
import org.springframework.web.bind.annotation.GetMapping;
|
import org.springframework.web.bind.annotation.PostMapping;
|
|
/**
|
* @author gonghl
|
* @since 2024/7/1 下午 4:01
|
*/
|
|
@Component
|
@FeignClient(name = "HKClient", url = "${request.haiKangDomain}", configuration = HKFeignConfig.class)
|
public interface HKClient {
|
|
/**
|
* 按区域统计经纬度异常设备或卡口
|
* 1、根据组织区域每10分钟汇总采集设备/卡口经纬度异常数量。
|
* 2、异常包括：
|
* (1)精度过低：经纬度小数点后不足6位。
|
* (2)经纬度缺失：经度或纬度存在缺失
|
* (3)不在辖区：经纬度超出所属行政区划范围
|
* 3、当日数据更新频率为每10分钟一次。历史数据保留一个月，每日凌晨生成昨日一整天区域汇总结果。
|
* @param param 请求参数
|
* @return 按区域统计经纬度异常设备或卡口
|
*/
|
@PostMapping("/dqd/service/rs/v1/device/coordinateExpInfo/query")
|
JSONObject coordinateByArea(CoordinateByAreaParam param);
|
|
/**
|
* 按区域统计编码异常设备或卡口
|
* 1、根据组织区域每10分钟统计采集设备和卡口国标编码异常量。
|
* 2、异常包括：
|
* (1)前6位不符合标准：国标编码前六位与组织编号前六位比较
|
* (2)11-13位符合标准：根据现场实际情况在idad数据配置界面配置所得,可通过指标配置信息接口获取配置参数
|
* (3)编码长度不是20位
|
* 3、当日数据更新频率为每10分钟一次。历史数据保留一个月，每日凌晨生成昨日一整天区域汇总结果。
|
* @param param 请求参数
|
* @return 按区域统计编码异常设备或卡口
|
*/
|
@PostMapping("/dqd/service/rs/v1/device/gbCodeExpInfo/query")
|
JSONObject codeByArea(CodeByAreaParam param);
|
|
/**
|
* 按区域统计人脸数据监测指标项
|
* 1、根据区域每10分钟汇总区域内以下监测结果：
|
* (1)设备活跃性：无抓拍、抓拍过少、抓拍突降。
|
* (2)时钟准确性：时钟准确率、不准确量、设备合格率等。
|
* (3)上传及时性：上传及时率、延迟各区间数据量、设备合格率。
|
* (4)大图可用性：大图可用量、访问异常量、标注异常量、大小图不一致量。
|
* (5)图片合格性：人脸唯一量、不唯一量等。
|
* (6)图片有效性：建模失败量、低评分量等。
|
* (7)图片关联性：未上报设备数、未上报抓拍量。
|
* (8)数据唯一性：不唯一数据、不唯一数据量。
|
* 2、可查询近30天内的数据异常情况。
|
* 3、今日数据更新频率为每10分钟一次。历史数据保留一个月，每日凌晨生成昨日一整天区域汇总结果。
|
*
|
* 注：今日数据变化较大，因而今日抓拍异常统计情况仅供参考。数据突降结论无法给出。故，数据突降异常是只针对截止历史的数据异常监测。
|
* @param param 请求参数
|
* @return 按区域统计人脸数据监测指标项
|
*/
|
@PostMapping("/dqd/service/rs/v2/data/faceDetect/query")
|
JSONObject faceDetectByArea(FaceDetectParam param);
|
|
/**
|
* 按区域统计车辆数据监测指标项
|
* 1、根据区域每10分钟汇总区域内以下监测结果：
|
* (1)设备活跃性：无抓拍、抓拍过少、抓拍突降的卡口/设备情况。
|
* (2)时钟准确性：车辆数据时钟准确率、卡口/设备合格率等。
|
* (3)上传及时性：车辆数据上传及时率、卡口/设备合格率等。
|
* (4)大图可用性：车辆背景大图可用率、不可用量等。
|
* (5)车牌合规性：车牌未识别量、车牌识别率低和昼夜识别突变卡口/采集设备数量灯。
|
* (6)数据准确性：车辆数据主要属性一致量、重要属性一致量。
|
* (7)数据完整性：下级上传的车辆数据，六项属性不完整量、两项属性不完整量。
|
* (8)数据关联性：未上报设备数、未上报抓拍量。
|
* (9)数据唯一性：车辆数据不唯一数据、不唯一数据量。
|
* 2、可查询近30天内的数据异常情况。
|
* 3、今日数据更新频率为每10分钟一次。历史数据保留一个月，每日凌晨生成昨日一整天区域汇总结果。
|
*
|
* 注：今日数据变化较大，因而今日抓拍异常统计情况仅供参考。数据突降结论无法给出。故，数据突降异常是只针对截止历史的数据异常监测。
|
* @param param 请求参数
|
* @return 按区域统计车辆数据监测指标项
|
*/
|
@PostMapping("/dqd/service/rs/v2/data/passDetect/query")
|
JSONObject carDetectByArea(CarDetectParam param);
|
|
/**
|
* 采集设备属性监测结果
|
* 1、每10分钟同步质量计算服务的资源数据，进行采集设备属性异常监测。
|
* 2、主要包含：采集设备基本信息以及经纬度、国标编码和时间差监测结果。可根据组织、经纬度和国标编码监测结果进行过滤。
|
* @param param 请求参数
|
* @return 采集设备属性监测结果
|
*/
|
@PostMapping("/dqd/service/rs/v1/device/cameraExpDetailInfo/query")
|
JSONObject monitorDetail(MonitoringDetailParam param);
|
|
/**
|
* 卡口属性监测结果
|
* 1、每10分钟同步质量计算服务的资源数据，进行卡口属性异常监测。
|
* 2、主要包含：卡口基本信息以及经纬度、国标编码监测结果。可根据组织、经纬度和国标编码监测结果进行过滤。
|
* @param param 请求参数
|
* @return 卡口属性监测结果
|
*/
|
@PostMapping("/dqd/service/rs/v1/device/crossExpDetailInfo/query")
|
JSONObject crossDetail(CrossDetailParam param);
|
|
/**
|
* 抓拍数据量监测结果
|
* 1、每10分钟统计今日各点位人脸数量，对数据量进行监测。
|
* 2、每10分钟统计今日各卡口过车数量，对过车量进行监测.
|
* 3、人脸数据量监测结果主要包括：正常、无抓拍、抓拍过少、抓拍突降
|
* (1)无抓拍：点位人脸数据量为0
|
* (2)抓拍过少：点位人脸数据量少于某一数据量（配置）。可通过接口2.3.2 指标配置信息查询（返回参数：lowFaceCriteria）获取配置
|
* (3)抓拍突降：（平均抓拍量-当天抓拍数据量）/平均抓拍量>=某一比例（配置）。可通过接口3.2 指标配置信息查询（返回参数：faceDropCriteriaPercent）获取配置
|
* 4.卡口/设备过车量监测结果主要包括：正常、无抓拍、抓拍过少、抓拍突降
|
* (1)无抓拍：卡口过车数据量为0
|
* (2)抓拍过少：卡口过车数据量少于某一数据量（配置）。可通过接口2.3.2 指标配置信息查询（返回参数：lowVelCriteria）获取配置
|
* (3)抓拍突降：（平均抓拍量-当天抓拍数据量）/平均抓拍量>=某一比例（配置）。可通过接口3.2 指标配置信息查询（返回参数：velDropCriteriaPercent）获取配置
|
* 5、数据每小时更新，只支持昨日和今日的查询。
|
*
|
* 注：今日数据每10分钟变化较大，因而今日抓拍异常统计情况仅供参考。数据突降与持续无数据天数定论无法给出。故，数据突降异常和持续无数据天数是只针对历史的数据异常监测。
|
* @param param 请求参数
|
* @return 抓拍数据量监测结果
|
*/
|
@PostMapping("/dqd/service/rs/v1/data/snapCountDetail/query")
|
JSONObject SnapshotDataMonitor(SnapshotDataMonitorParam param);
|
|
/**
|
* 抓拍数据时延监测结果
|
* 1、每10分钟统计今日各点位人脸数量和延迟倒挂数据量，对时效性进行监测。
|
* 2、每10分钟统计今日各卡口/设备过车数量和延迟倒挂数据量，对过车时效性进行监测.
|
* 3、判断数据延迟倒挂依据：
|
* (1)延迟：数据接收时间-抓拍时间 >13s（配置）。可通过接口3.2 指标配置信息查询（返回参数：faceDelayCriteria 和velDelayCriteria ）获取配置
|
* (2)倒挂：抓拍时间-数据接收时间>5s（配置）。可通过接口3.2 指标配置信息查询（返回参数：faceHangCriteria和velHangCriteria）获取配置
|
* 4、数据每小时更新，只支持昨日和今日的查询。
|
*
|
* 注：今日数据每10分钟变化较大，因而今日抓拍异常统计情况仅供参考。
|
* @param param 请求参数
|
* @return 抓拍数据时延监测结果
|
*/
|
@PostMapping("/dqd/service/rs/v1/data/snapAgingDetail/query")
|
JSONObject SnapshotDelayMonitor(SnapshotDelayMonitorParam param);
|
|
/**
|
* 图片访问监测结果
|
* 1、每10分钟统计今日各点位人脸数据中图片抽检访问情况。
|
* 2、每10分钟统计今日各卡口/设备过车数据中图片抽检访问情况。
|
* 3、数据每10分钟更新，支持近一个月数据结果的查询。今日数据变化较大，因而今日抓拍异常统计情况仅供参考
|
* @param param 请求参数
|
* @return 图片访问监测结果
|
*/
|
@PostMapping("/dqd/service/rs/v1/data/picAccessDetail/query")
|
JSONObject PicAccessMonitor(PicAccessParam param);
|
|
/**
|
* 属性识别准确监测结果
|
* 1、每10分钟统计今日各卡口/设备过车数据属性识别准确性结果。
|
* 2、只支持近一个月的历史监测结果查询。
|
* @param param 请求参数
|
* @return 属性识别准确监测结果
|
*/
|
@PostMapping("/dqd/service/rs/v1/data/attributeRecognition/query")
|
JSONObject AttrRecognitionMonitor(AttrRecognitionParam param);
|
|
/**
|
* 数据完整性监测结果
|
* 1、 每10分钟统计今日各卡口/设备过车数据中：
|
* (1)数据不完整数量及对应各属性字段不完整的数量。
|
* (2)对于主要属性会另外单独统计不完整量。
|
* 2、 抓拍数据完整：车辆卡口设备抓拍车辆数据包含符合GA/T 1400.3标准的车牌号码、车牌颜色、车辆类型、车辆品牌、车身颜色、车辆型号属性字段。其中，主要属性包括：车牌号码、车牌颜
|
* 3、今日数据每10分钟更新，支持近一个月的属性识别监测结果查询。
|
* 注：今日数据实时在变，10分钟更新一次的结果仅供参考。
|
* @param param 请求参数
|
* @return 数据完整性监测结果
|
*/
|
@PostMapping("/dqd/service/rs/v1/data/attributeIntegrity/query")
|
JSONObject DataIntegrityMonitoring(DataIntegrityMonitoringParam param);
|
|
/**
|
* 人脸设备全检指标监测结果
|
* 1、汇总人脸设备活跃性、数据及时性、时钟准确性、图片有效性、人脸唯一性全检指标监测结果
|
* 2、只支持近一个月的监测结果查询。
|
* 注：今日数据每10分钟变化较大，因而今日抓拍异常统计情况仅供参考。
|
* @param param 请求参数
|
* @return 人脸设备全检指标监测结果
|
*/
|
@PostMapping("/dqd/service/rs/v2/data/faceFullAmount/query")
|
JSONObject FaceDeviceInspection(FaceDeviceInspectionParam param);
|
|
/**
|
* 人脸设备抽检指标监测结果
|
* 1、汇总人脸设备大图可用性、图片合格性抽检指标监测结果
|
* 2、只支持近一个月的监测结果查询。
|
* 注：今日数据每10分钟变化较大，因而今日抓拍异常统计情况仅供参考。
|
* @param param 请求参数
|
* @return 人脸设备抽检指标监测结果
|
*/
|
@PostMapping("/dqd/service/rs/v2/data/faceSampleAmount/query")
|
JSONObject FaceDeviceSampling(FaceDeviceSamplingParam param);
|
|
/**
|
* 车辆设备全检指标监测结果
|
* 1、汇总车辆设备活跃性、数据及时性、时钟准确性、数据完整性、数据唯一性全检指标监测结果
|
* 2、只支持近一个月的监测结果查询。
|
* 注：今日数据每10分钟变化较大，因而今日抓拍异常统计情况仅供参考。
|
* @param param 请求参数
|
* @return 车辆设备全检指标监测结果
|
*/
|
@PostMapping("/dqd/service/rs/v2/data/vehFullAmount/query")
|
JSONObject VehicleDeviceInspection(VehicleDeviceInspectionParam param);
|
|
/**
|
* 车辆设备抽检指标监测结果
|
* 1、汇总车辆设备大图可用性、数据准确性抽检指标监测结果
|
* 2、只支持近一个月的监测结果查询。
|
* 注：今日数据每10分钟变化较大，因而今日抓拍异常统计情况仅供参考。
|
* @param param 请求参数
|
* @return 车辆设备抽检指标监测结果
|
*/
|
@PostMapping("/dqd/service/rs/v2/data/vehSampleAmount/query")
|
JSONObject VehicleDeviceSampling(VehicleDeviceSamplingParam param);
|
|
/**
|
* 关注监测资源查询
|
* 1、根据需求可在idad配置各区域关注点位或卡口信息。Idad对这批点位或卡口进行异常监测。此接口可查询关注的资源信息。
|
* @param param 请求参数
|
* @return 关注监测资源查询
|
*/
|
@PostMapping("/dqd/service/rs/v1/alarm/monitorResource/query")
|
JSONObject monitorResource(MonitorResourceParam param);
|
|
/**
|
* 指标配置信息查询
|
* 查询各类数据异常标准。例如：抓拍数据量低于多少认为数据量过少
|
* @return 指标配置信息查询
|
*/
|
@GetMapping("/dqd/service/rs/v1/statistics/criteria/query")
|
JSONObject Criteria();
|
|
/**
|
* 组织树查询
|
* 支持国标组织树和业务组织树信息查询。
|
* @return 组织树查询
|
*/
|
@PostMapping("/dqd/service/rs/v1/orgInfo/standard/query")
|
JSONObject OrganizationTree(OrganizationTreeParam param);
|
}
|
