定位接口接入业务看板，应先约定一条位置在多长时间内可以作为当前信息使用，以及超时后怎样呈现。接口请求成功、地图正常显示，都不足以说明位置刚刚更新。企业集成负责人需要把时间含义、过期规则与断报验收写进联调要求，避免缓存坐标一直以实时位置的面貌留在屏幕上。
先分清位置产生和页面刷新的时间
建议联调时区分三个时间：位置采集时间、业务系统接收时间和页面展示时间。采集时间用于判断记录距今多久，接收时间用于排查传输积压，展示时间用于观察页面刷新。页面刚刷新，可能取到的仍是很早以前采集的位置，不能据此重置位置年龄。
维构蓝牙定位系统提供实时定位以及开放API、SDK，可供第三方业务系统集成。具体接口是否提供上述时间、各字段含义及时间单位，需要结合项目接口文档确认。若只能取得接收时间，应明确其判断边界，不能直接将其标注为采集时间；各端时钟也应约定统一基准。
过期阈值要对应看板上的业务决定
先列出使用者看到位置后会做什么，再确定允许的数据年龄。例如，资产分布浏览与现场人员调度，对更新及时性的要求可能不同。建议由业务负责人给出可接受的等待范围，再结合终端上报配置、网络条件和现场试测结果讨论阈值，不套用一个未经验证的统一秒数。
独立列出“尚无有效位置”和“已有位置但已过期”两种情形。前者没有可供参考的历史坐标，后者仍保留最后已知位置。若接口时间缺失或异常，也应约定如何降级展示，避免计算失败时默认认定为新数据。
图1 人员定位平台可视化展示
保留旧点位时，同时撤去当前含义
建议过期后显示“最后已知位置”，同时给出对应记录时间或距今时长，并采用文字配合视觉变化提示状态。只改变点位颜色，使用者可能忽略；直接删除点位，又可能失去排查线索。页面如何实现这些提示，需要按项目开发确认。
还要检查人数汇总、区域分布等派生结果。如果旧坐标仍被计入“当前区域人数”，单个点位上的过期提示就无法消除误读。建议在汇总处说明统计口径，单列位置过期对象，是否纳入计算由具体业务决定。
用停止上报测试检验时间规则
验收不能只看连续上报时点位是否移动。建议选择测试对象，记录最后一次有效采集时间，再按约定方式暂停测试数据上报，观察页面何时提示过期。期间持续刷新页面，确认刷新动作不会让旧位置重新变成有效位置。
随后补测延迟记录到达和数据恢复两种情况：迟到的旧记录不应仅因刚被接收就恢复为当前信息；恢复后应依据有效记录及约定规则更新状态。保留接口样本、时间记录和页面截图，才能核对过期判断是否贯穿接收、展示与统计环节。
欢迎与维构沟通业务看板的位置接入与验收需求。
