先校验用户名，获取加密参数，将密码执行rsa加密后，再进行登录验证，方可进行定位服务、 务以及扩展服务的操作，并且后续调用的接口不再需要传递用户参数，将自动识别登录用户。

表1用户验证详细参数表

DB23/T26372020

屋面标准规范范本表2设备验证详细参数表

位置坐标数据是多模式协同定位服务接口提供的核心服务内容，各种终端结构数据最后基于该标准 坐标数据结构（终端实时位置数据），基于该标准数据结构，用户能根据不同的应用场景开发各种位置 服务延伸应用，如图表2。

当结束服务调用时，执行服务注销操作。

当服务调用时，通用返回结果为JSON数据格式，具体格式见附录A，详细记录了服务调用返回 执行结果。

告，用于向客户应用程序和使用者声明请求无效的原因

DB23/T26372020

主要包括后台下行命令请求消息队列接口和信息网关上行信息推送消息队列接口两部分，作为命今 执行获取消息反馈的通道。

本标准规定位置服务平台采用以下服务操作实现获取基本位置与定位相关服务，并在名称与含义上 保持一致，接口统一访问http://<主机>：<端口>/webAppInterface/命令名称。 终端管理（myDevices）操作：获取用户所管辖内所有终端基本信息。 终端参数（params）操作：获取特定终端参数列表。 终端定位服务（realTimeInfo）操作：实时请求终端最新位置。 历史回放（historyBLInfo）操作：用于查询某时段的终端轨迹点集合的历史位置信息

终端管理类（myDevices）操作用于查询及变更终端基本信息相关参数。

端管理类（myDevices）的请求参数如表5所示

表5请求URL的参数

DB23/T26372020

图3myDevices接口

终端参数类（params）操作的目的是查询及变更用户管理的车载、手持、北斗等定位终端或者 信息，返回用户对应终端及权限

终端参数类（params）的请求参数如表6所示。

表6params请求URL的参数

终端参数类（params）操作的请求有 据请求的参数返回一个响应，根据请习 回终端详细信息，请求响应的服务接口如图4所示， 其JSON数据结构的示例见附录B.2。

图4params接口

DB23/T26372020

终端定位类（realTimeInfo）操作实现实时请求终端最新位置，获取多种终端设备明码经纬度地理 坐标位置信息、时间、速度、方向等实时信息

定位类（realTimelnfo）操作的请求参数如表7所

表7realTimelnfo请求URL的参数

终端定位类（realTimeInfo）操作的请求有效时， 报务器应根据请求的参数返回一个响应，否则就 返回一个服务异常。请求响应的服务接口如图5所示，逻辑结构如图6，返回该用户所属所有终端的实 时位置信息。其JSON数据结构的示例见附录B.3。

图5realTimeInfo接口

DB23/T26372020

历史回放（historyBLInfo）操作用于查询终端历史位置信息，获取某时段的终端轨迹点集合

史回放（historyBLInfo）的请求参数如表8所示

表8historyBLInfo请求URL的参数

回放（historyBLInfo）操作的请求有效时，服务器应根据请求的参数返回一个响应，返回请求 内终端所有的运动轨迹点集合。请求响应的服务接口如图7所示，逻辑结构如图8，返回该用 有终端的实时位置信息。其JSON数据结构的示例见附录B.4。

DB23/T26372020

7historyBLInfo接口

DB23/T26372020

报警命令中超速报警setOverSpeed，区域报警setAreaCircular，涵盖设置区域报警（圆形、矩形和多 边形)，查询区域报警，删除区域报警等，此处以超速报警和圆形区域报警为例，

报警命令的请求参数如表10、11、12所示

表10setOverSpeed请求URL的参数

表11setAreaCircular请求URL的参数

DB23/T26372020

表12deleteAreaCircular请求URL的参数

报警命令操作的请求有效时，服务器应根据请求的参数返回请求成功响应，终端将记录超 报警约束，报警信息随终端定位基本信息返回。请求响应的服务接口如图9所示，其JSON数 示例见附录B.5。

定时监控指令（setLocationTimeSpan）操作用于设置终端上报位置时间间隔

图9setOverSpeed响应

定时监控指令（setLocationTimeSpan）的请求参数如表13所示。

DB23/T26372020

表13setLocationTimeSpan请求URL的参数

定时监控指令（setLocationTimeSpan）操作的请求有效时，服务器应根据请求的参数返回请求 应。请求响应的服务接口如图10所示

图10定时监控指令服务

终端拍照命令（takePhoto）用于对车载设备下发摄像头工作命令，车载设备接收命令后自动拍 拍摄的图片。

白照命令（takePhoto）的请求参数如表14所示。

表14takePhoto请求URL的参数

终端拍照命令（takePhoto）操作请求有效时，服务器应根据请求的参数返回请求成功响应，请求 服务接口如图11所示。

图11拍照命令下发上传服务接口

指令服务反馈信息采用activeMQ作为消息中间件来推送实时信息，使用方式为用户登录系统后访 问http://<主机><端口>/webPush/keepTopicHeart,获取主题名称，然后连接到指定的activeMQ即可，等 待实时数据推送过来，同时，需要设置定时程序维持activeMQ主题

指令服务反馈操作请求有效时，服务器应根据请求的参数返回请求成功响应，服务响应反 示

表16指令服务反馈操作结果

DB23/T26372020

指令服务反馈信息采用activeMQ作为消息中间件来推送实时信息，为保证等待实时数据推送获取， 需要设置定时程序维持activeMQ主题，即每隔一段时间访问一次http:/<主机><端口 >/webPush/keepTopicHeart接口，访问间隔时间不超过20分钟，此消息为维持通道不被自动清理。

8. 6. 2 请求

表17指令反馈维持请求URL的参数

指令反馈维持操作请求有效时，服务器应根据请求的参数返回请求成功响应，响应返回结果 据结构示例见附录B.7。

平台可根据用户需求，扩展该标准服务接口，包括平台功能接口、综合统计接口和其他终端扩 接口。

DB23/T26372020

附录A （规范性附录） 服务接口部分返回字段说明 A.1服务接口部分返回字段说明见表A.1。 表A.1规定了所有服务接口返回数据的属性结构，返回数据限于包含表中所有属性项，并具备不同 字段类型。

表A.1服务接口响应返回数据属性结构

形位公差标准DB23/T26372020

（资料性附录） 定位服务接口返回数据结构

DB23/T26372020

DB23/T26372020

钢结构施工组织设计历史报警（historyWarn）操作返回数据结构如下

DB23/T26372020