CMSV6帮助文档
/
901 DOCS · 225 VIDEOSEN

TTX协议人数统计(客流统计)

作者 谢周轩更新 2026-08-12 11:33:50文档 ID 2395约 2,208 字 · 阅读 5 分钟查看原文 ↗

1、功能说明

TTX协议人数统计方案(客流统计)

2、协议说明

  1. 设备通过透传接口发送给服务器
  2. 透传类型为:2
  3. 透传数据类型为StatisticsPeople_S,如下定义
const int MAX_POPLE_DEVCNT = 4;     //总统计的门数 0-前面 1-后面 2-中门 3-保留

typedef struct _tagStatisticsPeople
{
    int     nUpPeople[MAX_POPLE_DEVCNT];    //上车人数, 小于0表示无效
    int     unDownPeople[MAX_POPLE_DEVCNT]; //下车人数, 小于0表示无效
    int     nJingDu;                        //经度    4字节 整数部分    9999999 = 9.999999 
    int     nWeiDu;                         //纬度    4字节 整数部分    9999999 = 9.999999
    char    cPatch;                         //0-实时 1-补传
    unsigned char ucYear;       //年(2000+ucYear) 范围(0-64)
    unsigned char ucMonth;      //月(1-12)   范围(0-16)
    unsigned char ucDay;        //日(1-31)  范围(0-32)
    unsigned char ucHour;       //时(0-23)   范围(0-32)
    unsigned char ucMinute;     //分(0-59)  范围(0-64)
    unsigned char ucSecond;     //秒(0-59)  范围(0-64)
    unsigned char ucCurPeopleValid; //当前车上人数字段是否有效(设备统计的) 0-无效 1-有效[新增]
    unsigned char ucCurPeople;  //当前车上人数[新增]
    char    szReserver[23];                 //保留32->25 25->23
}StatisticsPeople_S, *LPStatisticsPeople_S;

3、注意事项

上下车人数统计不叠加,数据增量上报,增加“车上乘客数”字段。
- 7.25/7.26服务器需替换附件libgpstran_statisticspeople.dll

4、报表查询

  • 客流明细表

  • 报表字段说明

前门上车人数:nUpPeople[0]参数上报
前门下车人数:unDownPeople[0]参数上报
后门上车人数:nUpPeople[1]参数上报
后门下车人数:unDownPeople[1]参数上报
中门上车人数:nUpPeople[2]参数上报
中门下车人数:unDownPeople[2]参数上报
车上乘客数:ucCurPeople参数上报,ucCurPeopleValid置1时有效。
人员增量:新上车人数(所有门相加) 减去 新下车人数(所有门相加)

5、历史接口说明【已弃用】

  1. 设备通过透传接口发送给服务器
  2. 透传类型为:2
  3. 透传数据类型为StatisticsPeople_S,如下定义
const int MAX_POPLE_DEVCNT = 4;     //总统计的门数 0-前面 1-后面 2-中门 3-保留

typedef struct _tagStatisticsPeople
{
    int     nUpPeople[MAX_POPLE_DEVCNT];    //上车人数, 小于0表示无效
    int     unDownPeople[MAX_POPLE_DEVCNT]; //下车人数, 小于0表示无效
    int     nJingDu;                        //经度    4字节 整数部分    9999999 = 9.999999 
    int     nWeiDu;                         //纬度    4字节 整数部分    9999999 = 9.999999
    char    cPatch;                         //0-实时 1-补传
    unsigned char ucYear;       //年(2000+ucYear) 范围(0-64)
    unsigned char ucMonth;      //月(1-12)   范围(0-16)
    unsigned char ucDay;        //日(1-31)  范围(0-32)
    unsigned char ucHour;       //时(0-23)   范围(0-32)
    unsigned char ucMinute;     //分(0-59)  范围(0-64)
    unsigned char ucSecond;     //秒(0-59)  范围(0-64)
    char    szReserver[25];                 //保留32->25
}StatisticsPeople_S, *LPStatisticsPeople_S;

注意事项:以上方案容易导致“车上乘客数”统计出现误差,不推荐使用

  • 车上乘客数统计规则:
    1.启动时,从dev_status取人数数据
    2.当上报数据时,统计单次总上车人数和总下车人数
    3.取缓存的人数,判断人数,无缓存时,人员增量=新上车人数-新下车人数,当前车上人数=人员增量
    4.当新上车人数或新下车人数,小于缓存值时,人员增量=新上车人数-新下车人数,当前车上人数=人员增量
    5.不满足条件时,人员增量=(新上车人数-旧上车人数)-(新下车人数-旧下车人数),当前车上人数=旧当前人数+人员增量
    6.当计算的当前车上人数小于0时,会设置为0

注:如上报人数为补传数据,车上乘客数统计也会有误差。

数据来源 help.cmsv8.com
901 篇文档 · 225 个视频 · docs.alwaycare.com