轻车车联网网关 bartender

不仅仅是TCP/UDP网关。基于Spring Boot 2.x技术，将硬件接口的复杂对接转化为简单易用的接口和消息推送方式，具备设备管理、数据分析和消息推送等多种能力，可广泛应用于各种车辆监管场景和应用平台。

bartender作为本网关的接口服务，能够为车辆联网监管和部标标准的实现提供强有力的支持，助力车辆监管的智能化和规范化。

bartender接口说明文档

文档

软件架构

产品线路图

系统配置要求

支持设备类型

支持报警类型

名词说明

使用说明

1. API鉴权

初次使用时我们会提供调用终端的鉴权信息client_id和client_secret，调用鉴权接口可获取凭证access_token，之后便可开始使用其他业务API接口。 

鉴权接口 POST /oauth/token

此接口返回的token_type和access_token使用' '（空格）连接后，在请求header中携带调用业务接口。

请求参数

成功返回示例

{
  "access_token": "this_is_an_example_access_token",
  "token_type": "bearer",
  "expires_in": 40528,
  "scope": "all",
  "jti": "483fb3cf-e63b-415d-93bd-bdd4f12a8213"
}

返回结果

返回数据结构

2. 设备接入与消息接收

系统搭建完成后，若使用第三方硬件，需将硬件配置到对应协议的TCP(UDP)上线端口，若使用我司设备，可联系客服配置。 如图所示，首先添加设备以确保设备上线，若需接收设备实时定位和告警，需开启事件推送。

设备-添加接口 GET /devices/syn

支持相同型号批量添加，使用默认参数，可绕过鉴权。

请求参数

返回结果

设备-批量启停推送接口 GET /devices/batch

若设备导入时没有指定启用状态，则默认启用，不需要批量启用。若导入时指定设备初始状态为停用，则需要使用该接口控制，停用时，不推送定位状态、事件信息。

请求参数

返回结果

3. 验证设备上线

设备位置-运维查看设备位置状态接口 GET /opt/location

运维使用查询设备最新定位状态，当设备号不存在时提示“设备号不存在”

请求参数

成功返回示例

{
  "code": 200,
  "data": {
    "categoryNo": "DO90",
    "categoryNoShort": "DO90",
    "createTime": "2022-07-27 05:12:00",
    "deviceNum": "868120250375836",
    "direction": 28,
    "directionName": "东北",
    "gpsTime": "2022-07-26 16:14:49",
    "isMoving": 0,
    "latBd": 29.116056,
    "latGc": 29.109734,
    "lngBd": 119.654767,
    "lngGc": 119.648356,
    "locMode": 9,
    "satCount": 15,
    "speed": 0,
    "startTimeMovingStop": "2022-06-23 07:45:53",
    "startTimeOnOffLine": "2022-07-27 05:12:00",
    "wifiFlag": 1
  },
  "message": "",
  "success": true
}

返回结果

返回数据结构

常见问题

设备在线总数和各端口在线数

可根据各端口实时在线数量粗略判断端口健康状态，当某端口车辆较少或当前时间大部分车辆在停车状态，则不足以判断端口健康情况。可参考以下SQL query查询在线数量。

SELECT COUNT(p.ALM_OFFLINE = 0 AND (p.ISSLEEPING=0 OR p.ISSLEEPING IS NULL) OR NULL) AS '在线总数' 
FROM dd_new.position p;

SELECT p.TAG as '端口',
COUNT(p.ALM_OFFLINE = 0 AND (p.ISSLEEPING=0 OR p.ISSLEEPING IS NULL) OR NULL) AS '在线数',
COUNT(*) AS '累计上线数量',
MAX(p.CREATE_TIME) AS '最新服务时间',
NOW() AS '当前时间',
IF(TIMESTAMPDIFF(SECOND,MAX(p.CREATE_TIME),NOW()) <= SECOND(3), '正常', 
IF(COUNT(p.ALM_OFFLINE = 0 AND (p.ISSLEEPING=0 OR p.ISSLEEPING IS NULL) OR NULL) < 100, '设备较少', '异常')) AS '端口健康' -- 该阈值需根据活跃车辆数进行调整
FROM dd_new.position p
GROUP BY p.TAG
ORDER BY MAX(p.CREATE_TIME);

设备不上线问题

定位更新回调接收不到该设备数据，或超过30分钟没有新数据。

运维建议：

1. 确认设备是否已通电，车辆正常行驶。
2. 与网络运营商确认物联网卡为可用状态。
3. 避免将车辆置于地下停车场等信号差的位置，参看设备说明书，根据指示灯判断，确认网络信号良好，GPS信号良好。

设备定位不准问题

车辆于地图定位与实际位置有偏差。

运维建议：

1. 确认车辆正常行驶，否则可能导致设备断电。
2. 确认定位更新回调接收该设备数据正常，若无更新，怀疑存在设备不上线问题。
3. 若回调数据中定位标识AV=V，说明设备搜索不到卫星信号，GPS定位失败，建议开车移动到信号较好的位置。