轻车车联网网关 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定位失败，建议开车移动到信号较好的位置。