1、DB 23/T 2637 2020DB23ICS 07.040A75黑 龙 江 省 地 方 标 准DB 23/T 2637 2020 2020 06 08发 布 2020 07 07实 施黑 龙 江 省 市 场 监 督 管 理 局黑 龙 江 省 测 绘 地 理 信 息 局 联 合 发 布 位 置 服 务 平 台 多 模 式 协 同 定 位 服 务 接 口技 术 规 范Location Service Platform Multi-Mode Cooperative PositioningService Interface technical specification DB 23/T 2637
2、2020 I 目 次前 言 .I1 范 围 .12 规 范 性 引 用 文 件 .13 术 语 和 定 义 .14 总 则 .25 符 号 、 缩 略 语 和 UML 标 记 .36 基 本 服 务 元 素 .47 定 位 服 务 操 作 .6 8 指 令 服 务 操 作 .69 扩 展 服 务 操 作 .6附 录 A(规 范 性 附 录 )服 务 接 口 部 分 返 回 字 段 说 明 .错 误 ！ 未 定 义 书 签 。附 录 B(资 料 性 附 录 )服 务 接 口 返 回 数 据 结 构 .16参 考 文 献 .23 DB 23/T 2637 2020 I 前 言本 标 准 按 照 G
3、B/T 1.1-2009 编 写 的 规 则 起 草 。本 标 准 由 黑 龙 江 省 测 绘 地 理 信 息 局 提 出 。本 标 准 由 黑 龙 江 省 测 绘 地 理 信 息 局 标 准 化 技 术 委 员 会 归 口 。本 标 准 起 草 单 位 ： 自 然 资 源 部 黑 龙 江 基 础 地 理 信 息 中 心 。本 标 准 主 要 起 草 人 ： 周 振 发 、 林 富 明 、 张 庆 全 、 刘 禹 鑫 、 周 源 、 王 洪 昌 、 刘 恒 飞 、 李 冰 、 古 一 鸣 、王 芳 、 李 梅 、 朱 晓 东 。 DB 23/T 2637 2020 1 位 置 服 务 平 台
4、多 模 式 协 同 定 位 服 务 接 口 技 术 规 范1 范 围本 标 准 规 定 了 位 置 服 务 平 台 多 模 式 协 同 定 位 服 务 接 口 的 适 用 范 围 、 一 致 性 要 求 、 规 范 性 引 用 文 件 、术 语 和 定 义 、 符 号 、 缩 略 语 和 UML标 记 、 建 设 原 则 、 基 本 服 务 要 素 和 定 位 指 令 服 务 操 作 。本 标 准 适 用 于 行 业 领 域 位 置 服 务 多 模 式 协 同 定 位 的 管 理 、 研 究 、 开 发 及 应 用 。2 规 范 性 引 用 文 件下 列 文 件 对 本 文 件 的 应 用 是
5、 必 不 可 少 的 。 凡 是 注 日 期 的 引 用 文 件 ， 仅 注 日 期 的 版 本 使 用 于 本 文 件 。凡 是 不 注 日 期 的 引 用 文 件 ， 其 最 新 版 本 （ 包 括 所 有 的 修 改 单 元 ） 适 用 于 本 文 件 。 GB/T 16831-2013 基 于 坐 标 的 地 理 点 位 置 标 准 表 示 法GB/T 30288-2013 卫 星 导 航 定 位 坐 标 系 统GB/T 7408-2005 数 据 元 和 交 换 格 式 信 息 交 换 日 期 和 时 间 表 示 法JT/T 808-2019 道 路 运 输 车 辆 卫 星 定 位
6、系 统 终 端 通 讯 协 议 及 数 据 格 式JT/T 794-2019 道 路 运 输 车 辆 卫 星 定 位 系 统 车 载 终 端 技 术 要 求JT/T 796-2011 道 路 运 输 车 辆 卫 星 定 位 系 统 平 台 技 术 要 求W3C XML 可 扩 展 标 记 语 言 1.0（ 第 五 版 ） ， W3C推 荐 （ 2008）3 术 语 和 定 义下 列 术 语 和 定 义 适 用 于 本 文 件 。3.1 位 置 服 务根 据 特 定 需 求 ， 采 用 卫 星 定 位 技 术 获 取 的 用 户 终 端 的 位 置 信 息 ， 通 过 移 动 通 信 网 络 ，
7、 在 电 子 地 图 服务 的 可 视 化 支 持 下 提 供 给 用 户 本 人 或 他 人 以 及 通 信 系 统 ， 实 现 定 位 、 导 航 、 查 询 、 识 别 和 事 件 检 查 等 与空 间 位 置 相 关 的 增 值 服 务 。3.2 定 位 模 式采 用 一 定 的 定 位 设 备 和 定 位 技 术 组 合 进 行 定 位 的 方 式 。3.3 协 同 定 位 采 用 不 同 定 位 模 式 实 现 室 内 外 空 间 的 定 位 服 务 。注 ： 多 种 定 位 技 术 与 方 法 相 互 协 调 完 成 的 定 位 服 务 。 DB 23/T 2637 2020 2
8、 3.4 定 位 区 域能 提 供 稳 定 的 定 位 服 务 与 流 畅 的 信 息 交 互 的 空 间 区 域 。3.5 接 口 用 户应 用 位 置 服 务 多 模 式 协 同 定 位 服 务 接 口 的 开 发 人 员 。3.6 定 位 终 端定 位 终 端 是 位 置 服 务 平 台 的 定 位 数 据 来 源 设 备 ， 包 括 GPS/北 斗 车 载 终 端 、 手 持 定 位 终 端 ， 具 备 定 位 功 能 的 手 机 、 无 线 对 讲 机 等 。注 ： 本 处 车 载 终 端 一 般 要 求 符 合 交 通 部 JT/T794-2019， 终 端 与 平 台 间 的 数
9、 据 格 式 符 合 JT/T808-2019道 路 运 输 车 辆 卫 星 定 位 系 统 终 端 通 讯 协 议 及 数 据 格 式 (兼 容 JT/T 808-2013）JT/T 796-2011 3.5 车 载 终 端 3.7 网 络 通 讯 协 议连 接 不 同 操 作 系 统 和 不 同 硬 件 体 系 结 构 的 互 联 网 络 提 供 通 信 支 持 ， 是 一 种 网 络 通 用 语 言 。4 总 则4.1 一 致 性 任 何 声 称 与 本 标 准 相 一 致 的 定 位 服 务 的 实 现 或 产 品 都 应 满 足 本 标 准 规 定 的 接 口 服 务 操 作 和 相
10、 应 数据 结 构 的 全 部 要 求 。4.2 实 用 性接 口 功 能 跨 平 台 使 用 ， 具 备 实 用 、 简 洁 的 特 点 。4.3 扩 展 性平 台 具 备 对 架 构 、 容 量 、 通 信 和 处 理 能 力 等 方 面 进 行 接 口 扩 充 和 升 级 的 特 点 。4.4 开 放 性与 相 关 技 术 标 准 相 统 一 ， 传 输 协 议 具 备 通 用 性 与 一 致 性 的 要 求 。4.5 先 进 性 接 口 具 备 功 能 、 采 用 技 术 、 实 现 方 法 、 可 延 续 性 等 方 面 技 术 的 先 进 性 。 DB 23/T 2637 2020
11、 3 5 符 号 、 缩 略 语 和 UML 标 记5.1 缩 略 语下 列 缩 略 语 适 用 于 本 文 件 。OGC 开 放 地 理 空 间 信 息 联 盟 （ Open Geospatial Consortium）CGCS2000 2000 国 家 大 地 坐 标 系 （ China Geodetic Coordinate System 2000）GB/T 30288-2013,缩 略 语 3.2CRS 坐 标 参 照 系 （ Coordinate Reference System)GNSS 全 球 导 航 卫 星 系 统 （ Global Navigation Satellite S
12、ystem）GSM 全 球 移 动 通 信 系 统 （ Global System for Mobile Communications）XML 可 扩 展 标 记 语 言 （ Extensible Markup Language） W3C XML 可 扩 展 标 记 语 言 1.05.2 UML标 记 在 本 标 准 中 ， 采 用 统 一 建 模 语 言 （ UML） 描 述 室 内 外 多 模 式 协 同 定 位 的 概 念 模 型 和 服 务 接 口 。 基 本的 数 据 类 型 和 图 表 在 ISO/TS 19103:2005中 以 及 ISO/IEC 19501中 说 明 。在 本
13、 标 准 中 ， 采 用 下 列 UML类 的 构 造 型 ：a) () 一 组 没 有 标 识 （ 独 立 存 在 且 可 能 存 在 边 缘 效 应 ） 值 的 描 述 符 。 数据 类 型 包 括 基 本 的 预 定 类 型 。 DataType是 一 个 具 有 少 量 操 作 或 没有 操 作 的 类 ， 其 主 要 目 的 是 保 持 其 他 类 的 抽 象 状 态 。b) () 一 个 灵 活 的 枚 举 ， 用 于 描 述 一 个 开 放 列 表 。 如 果 完 全 知 道 该 表 的元 素 的 值 ， 则 应 使 用 枚 举 ； 如 果 只 知 道 该 表 元 素 的 可 能
14、 值 ， 则 应使 用 代 码 表 。c) () 不 能 直 接 实 例 化 的 类 （ 或 其 他 类 元 ） 。 该 类 的 UML标 记 用 斜 体 表 示其 名 称 。d) () 命 名 的 操 作 集 ， 描 述 元 素 的 行 为 。 e) () 逻 辑 上 相 关 组 分 的 群 集 ， 包 括 子 包 。f) () 一 组 抽 象 的 属 性 和 关 联 。 抽 象 意 味 着 其 规 范 不 一 定 应 作 为 实 例 变量 体 实 现 。在 本 标 准 中 ， UML 标 记 的 主 要 元 素 如 图 1 所 示 。 DB 23/T 2637 2020 4 图 1 UML
15、 标 记6 基 本 服 务 元 素6.1 概 述本 条 规 定 了 服 务 接 口 中 独 立 于 特 定 服 务 必 选 操 作 的 通 用 部 分 ， 操 作 流 程 如 下 图 2 所 示 。 图 2 操 作 流 程 图6.2 用 户 验 证先 校 验 用 户 名 ， 获 取 加 密 参 数 ， 将 密 码 执 行 rsa 加 密 后 ， 再 进 行 登 录 验 证 ， 方 可 进 行 定 位 服 务 、 指令 服 务 以 及 扩 展 服 务 的 操 作 ， 并 且 后 续 调 用 的 接 口 不 再 需 要 传 递 用 户 参 数 ， 将 自 动 识 别 登 录 用 户 。表 1 用
16、户 验 证 详 细 参 数 表参 数 名 是 否 必 须 值username 是 用 户 名 ， 例 如 ： testuser1password 是 RSA 加 密 后 的 密 码 密 文 ， 很 长 一 串 字 符 串 。 returntext 是 固 定 为 true DB 23/T 2637 2020 5 6.3 设 备 验 证通 过 提 供 专 用 接 口 执 行 设 备 传 回 数 据 接 收 入 口 校 验 ， 用 来 验 证 隶 属 于 该 平 台 的 设 备 ， 校 验 成 功 后 放行 否 则 为 无 效 数 据 。 如 图 表 1。 表 2 设 备 验 证 详 细 参 数
17、表参 数 名 是 否 必 须 值deviceid 是 终 端 设 备 识 别 码infogatename 是 信 息 网 关 名6.4 位 置 坐 标 位 置 坐 标 数 据 是 多 模 式 协 同 定 位 服 务 接 口 提 供 的 核 心 服 务 内 容 ， 各 种 终 端 结 构 数 据 最 后 基 于 该 标 准坐 标 数 据 结 构 （ 终 端 实 时 位 置 数 据 ） ， 基 于 该 标 准 数 据 结 构 ， 用 户 能 根 据 不 同 的 应 用 场 景 开 发 各 种 位 置服 务 延 伸 应 用 ， 如 图 表 2。 表 3 定 位 数 据 结 构名 称 字 段 类 型
18、必 选 性 含 义 单 位lat double 必 选 纬 度 度lon double 必 选 经 度 度alt double 可 选 高 程 米 speed double 可 选 速 度 米 每 秒orientation double 可 选 方 向 度locationtime string 必 选 定 位 时 间 YYYYMMDDThhmmss坐 标 数 据 中 的 lat、 lon 和 alt 应 符 合 基 于 坐 标 的 地 理 点 位 置 标 准 表 示 法 （ GB/T 16831-2013） 对地 理 点 位 置 的 规 定 。 其 中 ， 高 程 单 位 为 米 ， 速 度
19、单 位 是 米 每 秒 ， 方 位 角 是 以 真 北 方 向 TN 为 参 考 基 准 ，范 围 在 0-360。 定 位 时 间 以 采 用 UTC 作 为 参 照 基 准 ， 其 格 式 表 示 为 符 合 GB/T 7408-2005 数 据 元 和 交换 格 式 信 息 交 换 日 期 和 时 间 表 示 法 的 字 符 串 ， 为 YYYYMMDDThhmmss。6.5 服 务 注 销当 结 束 服 务 调 用 时 ， 执 行 服 务 注 销 操 作 。 6.6 服 务 响 应当 服 务 调 用 时 ， 通 用 返 回 结 果 为 JSON数 据 格 式 ， 具 体 格 式 见 附
20、 录 A， 详 细 记 录 了 服 务 调 用 返 回 状 态与 执 行 结 果 。6.7 服 务 异 常当 接 收 到 不 符 合 本 标 准 的 无 效 请 求 时 ， 或 定 位 服 务 计 算 出 现 问 题 时 ， 定 位 服 务 器 应 发 布 服 务 异 常 报 DB 23/T 2637 2020 6 告 ， 用 于 向 客 户 应 用 程 序 和 使 用 者 声 明 请 求 无 效 的 原 因 。6.8 消 息 通 道主 要 包 括 后 台 下 行 命 令 请 求 消 息 队 列 接 口 和 信 息 网 关 上 行 信 息 推 送 消 息 队 列 接 口 两 部 分 ， 作 为
21、 命 令执 行 获 取 消 息 反 馈 的 通 道 。7 定 位 服 务 操 作7.1 概 述本 标 准 规 定 位 置 服 务 平 台 采 用 以 下 服 务 操 作 实 现 获 取 基 本 位 置 与 定 位 相 关 服 务 ， 并 在 名 称 与 含 义 上保 持 一 致 ， 接 口 统 一 访 问 http:/:/webAppInterface/命 令 名 称 。 终 端 管 理 （ myDevices） 操 作 ： 获 取 用 户 所 管 辖 内 所 有 终 端 基 本 信 息 。终 端 参 数 （ params） 操 作 ： 获 取 特 定 终 端 参 数 列 表 。终 端 定 位
22、 服 务 （ realTimeInfo） 操 作 ： 实 时 请 求 终 端 最 新 位 置 。历 史 回 放 （ historyBLInfo） 操 作 ： 用 于 查 询 某 时 段 的 终 端 轨 迹 点 集 合 的 历 史 位 置 信 息 。表 4 定 位 服 务 操 作操 作 名 称 操 作 含 义 可 选 性myDevices 终 端 管 理 必 选realTimeInfo 终 端 定 位 服 务 必 选params 终 端 信 息 可 选 hsitoryBLPointHandler 历 史 回 放 可 选7.2 终 端 管 理7.2.1 描 述终 端 管 理 类 （ myDevic
23、es） 操 作 用 于 查 询 及 变 更 终 端 基 本 信 息 相 关 参 数 。7.2.2 请 求终 端 管 理 类 （ myDevices） 的 请 求 参 数 如 表 5 所 示 。表 5 请 求 URL的 参 数 请 求 参 数 可 选 性 含 义 描 述 及 要 求devicetype 否 终 端 类 别 (支 持 车 载 、 手 持 等 多 种 终 端 类 别 ) 指 定 终 端 类 别 。形 如 ： lbs_dev_vehicle， 不 填 写 则 获 取 所 辖 全部 终 端 DB 23/T 2637 2020 7 7.2.3 响 应终 端 管 理 类 （ myDevice
24、s） 操 作 的 请 求 有 效 时 ， 服 务 器 应 根 据 请 求 的 参 数 返 回 一 个 响 应 ， 根 据 请 求类 型 返 回 终 端 详 细 信 息 ， 请 求 响 应 的 服 务 接 口 如 图 3 所 示 ， 其 JSON 数 据 结 构 的 示 例 见 附 录 B.2。 图 3 myDevices 接 口7.3 终 端 参 数7.3.1 描 述终 端 参 数 类 （ params） 操 作 的 目 的 是 查 询 及 变 更 用 户 管 理 的 车 载 、 手 持 、 北 斗 等 定 位 终 端 或 者 权 限等 信 息 ， 返 回 用 户 对 应 终 端 及 权 限
25、。7.3.2 请 求终 端 参 数 类 （ params） 的 请 求 参 数 如 表 6 所 示 。表 6 params 请 求 URL 的 参 数 请 求 参 数 可 选 性 含 义 描 述 与 要 求deviceid 必 选 终 端 ID7.3.3 响 应终 端 参 数 类 （ params） 操 作 的 请 求 有 效 时 ， 服 务 器 应 根 据 请 求 的 参 数 返 回 一 个 响 应 ， 根 据 请 求 类 型返 回 终 端 详 细 信 息 ， 请 求 响 应 的 服 务 接 口 如 图 4 所 示 ， 其 JSON 数 据 结 构 的 示 例 见 附 录 B.2。 图 4
26、params 接 口 DB 23/T 2637 2020 8 7.4 终 端 定 位7.4.1 描 述终 端 定 位 类 （ realTimeInfo） 操 作 实 现 实 时 请 求 终 端 最 新 位 置 ， 获 取 多 种 终 端 设 备 明 码 经 纬 度 地 理坐 标 位 置 信 息 、 时 间 、 速 度 、 方 向 等 实 时 信 息 。7.4.2 请 求终 端 定 位 类 （ realTimeInfo） 操 作 的 请 求 参 数 如 表 7 所 示 。表 7 realTimeInfo请 求 URL的 参 数请 求 参 数 可 选 性 含 义 描 述 及 要 求 devicei
27、ds 可 选 终 端 标 识 指 定 终 端 的 识 别 码 ， 多 个 时 以 英 文 逗 号 隔 开 。形 如 ： 13812345678,15812345678， 不 填 写 则 获 取 所 辖 全 部 终 端isall 必 选 是 否 刷 新 是 否 强 制 刷 新 ， 填 写 true时 ， 不 管 终 端 最 新 位 置 是 否 发 生 变 化 均 强 制获 取 最 后 一 条 实 时 数 据 ， 不 填 写 或 者 填 写 false时 ， 只 返 回 发 生 变 化的 终 端 实 时 数 据 。7.4.3 响 应终 端 定 位 类 （ realTimeInfo） 操 作 的 请
28、 求 有 效 时 ， 服 务 器 应 根 据 请 求 的 参 数 返 回 一 个 响 应 ， 否 则 就返 回 一 个 服 务 异 常 。 请 求 响 应 的 服 务 接 口 如 图 5 所 示 ， 逻 辑 结 构 如 图 6， 返 回 该 用 户 所 属 所 有 终 端 的 实时 位 置 信 息 。 其 JSON 数 据 结 构 的 示 例 见 附 录 B.3。 图 5 realTimeInfo 接 口 DB 23/T 2637 2020 9 图 6 逻 辑 结 构7.5 历 史 回 放7.5.1 描 述历 史 回 放 （ historyBLInfo） 操 作 用 于 查 询 终 端 历 史
29、 位 置 信 息 ， 获 取 某 时 段 的 终 端 轨 迹 点 集 合 。7.5.2 请 求历 史 回 放 （ historyBLInfo） 的 请 求 参 数 如 表 8 所 示 。表 8 historyBLInfo请 求 URL的 参 数 请 求 参 数 可 选 性 含 义 描 述 及 要 求deviceid 必 选 终 端 设 备 的 识 别 码starttime 必 选 开 始 时 间 查 询 起 始 时 间endtime 可 选 结 束 时 间 不 填 则 默 认 以 当 前 时 间为 结 束 时 间7.5.3 响 应历 史 回 放 （ historyBLInfo） 操 作 的 请
30、 求 有 效 时 ， 服 务 器 应 根 据 请 求 的 参 数 返 回 一 个 响 应 ， 返 回 请 求查 询 时 间 内 终 端 所 有 的 运 动 轨 迹 点 集 合 。 请 求 响 应 的 服 务 接 口 如 图 7 所 示 ， 逻 辑 结 构 如 图 8， 返 回 该 用户 所 属 所 有 终 端 的 实 时 位 置 信 息 。 其 JSON 数 据 结 构 的 示 例 见 附 录 B.4。 DB 23/T 2637 2020 1 0 图 7 historyBLInfo接 口 图 8 响 应 逻 辑 图8 指 令 服 务 操 作8.1 概 述本 标 准 规 定 位 置 服 务 平
31、台 采 用 以 下 服 务 操 作 实 现 与 终 端 交 互 相 应 指 令 （ 指 令 符 合 国 家 部 标 标 准 协议 ， 并 具 备 扩 展 能 力 ） ， 并 在 名 称 与 含 义 上 保 持 一 致 ， 接 口 统 一 访 问 http:/:/jtt808command/命 令 名 称 ； 通 过 指 令 服 务 反 馈 和 指 令 反 馈 维 持 回 去 指 令 服 务 执 行 的 状 态 。报 警 命 令 （ 超 速 报 警 setOverSpeed， 区 域 报 警 setAreaCircular， 报 警 操 作 用 于 超 速 和 区 域 等 报 警 命令 发 送
32、及 取 消 。定 时 监 控 命 令 （ setLocationTimeSpan） 操 作 用 于 控 制 定 位 终 端 设 备 上 报 位 置 的 时 间 频 率 。拍 照 命 令 （ takePhoto） 操 作 用 于 对 车 载 设 备 下 发 摄 像 头 工 作 命 令 和 传 输 终 端 上 传 的 拍 摄 图 片 。 表 9 指 令 服 务 操 作操 作 名 称 可 选 性 含 义 描 述 及 要 求SpeedCommandHandlersetAreaRectangleCancelCommandHandle 可 选 报 警 命 令 见 8.2setLocationTimeSpa
33、n 可 选 定 时 监 控 命 令 见 8.3takePhoto 可 选 拍 照 命 令 与 上 传 见 8.4 DB 23/T 2637 2020 1 1 8.2 报 警 命 令8.2.1 描 述报 警 命 令 中 超 速 报 警 setOverSpeed， 区 域 报 警 setAreaCircular， 涵 盖 设 置 区 域 报 警 (圆 形 、 矩 形 和 多边 形 )， 查 询 区 域 报 警 ， 删 除 区 域 报 警 等 ， 此 处 以 超 速 报 警 和 圆 形 区 域 报 警 为 例 。8.2.2 请 求报 警 命 令 的 请 求 参 数 如 表 10、 11、 12 所
34、示 。表 10 setOverSpeed请 求 URL的 参 数请 求 参 数 可 选 性 含 义 描 述 及 要 求 deviceid 必 选 终 端 ID 填 写 终 端 IDhighspeed 必 选 限 速 值 最 高 限 速 ， 单 位 km/hoverspeedduration 必 选 持 续 时 间 超 速 持 续 时 间 ， 单 位 秒表 11 setAreaCircular 请 求 URL 的 参 数请 求 参 数 含 义 可 选 性 描 述 及 要 求deviceid 必 选 填 写 终 端 IDusetime 可 选 是 否 根 据 时 间 进 行 限 制 0： 否 ，
35、1： 是 ， 默 认 0starttime 如 果 UseTime为 1则 必 填 格 式YYYY-MM-DDhh:mm:ss 设 置 区 域 或 者 路 线 报 警 时 ， 消 息 协 议 支 持 周期 时 间 范 围 ， 如 要 限 制 每 天 的 8:30-18:00，起 始 /结 束 时 间 设 为 ：00-00-00-08-30-00/00-00-00-18-00-00，其 他 以 此 类 推endtime 如 果 UseTime为 1则 必 填 格 式YYYY-MM-DD hh:mm:sslimitspeed 可 选 是 否 限 速 0否 ， 1： 是 ， 默 认 0highest
36、speed 如 果 LimitSpeed为 1则 必 填 最 高 限 速 单 位 KM/Hoverspeedduration 如 果 LimitSpeed为 必 填 超 速 持 续 多长 时 间 认 定为 超 速 单 位 秒 DB 23/T 2637 2020 1 2 inalerm 可 选 进 入 区 域 报警 0否 ， 1： 是 ， 默 认 0outalerm 必 选 离 开 区 域 报警 0否 ， 1： 是 ， 默 认 1centerpointlat 必 选 圆 心 纬 度 38.123456， 精 确 到 小 数 点 后 6位centerpointlng 必 选 圆 心 经 度 如 1
37、26.123456， 精 确 到 小 数 点 后 6位radius 是 半 径 单 位 ： 米表 12 deleteAreaCircular请 求 URL的 参 数 请 求 参 数 可 选 性 含 义 描 述 及 要 求deviceid 必 选 填 写 终 端 IDareaidlist 必 选 区 域 ID 删 除 多 个 时 以 逗 号 分 隔 ， 例 如 :0,1,2,3。 如 为 空则 删 除 所 有 区 域 。 不 超 过 125 个 ， 多 于 125个 建 议用 多 条 消 息8.2.3 响 应报 警 命 令 操 作 的 请 求 有 效 时 ， 服 务 器 应 根 据 请 求 的
38、参 数 返 回 请 求 成 功 响 应 ， 终 端 将 记 录 超 速 、 区 域报 警 约 束 ， 报 警 信 息 随 终 端 定 位 基 本 信 息 返 回 。 请 求 响 应 的 服 务 接 口 如 图 9 所 示 ， 其 JSON 数 据 结 构 的示 例 见 附 录 B.5。 图 9 setOverSpeed 响 应8.3 定 时 监 控 指 令8.3.1 描 述定 时 监 控 指 令 （ setLocationTimeSpan） 操 作 用 于 设 置 终 端 上 报 位 置 时 间 间 隔 。8.3.2 请 求 DB 23/T 2637 2020 1 3 定 时 监 控 指 令
39、（ setLocationTimeSpan） 的 请 求 参 数 如 表 13 所 示 。表 13 setLocationTimeSpan请 求 URL的 参 数请 求 参 数 可 选 性 含 义 描 述 及 要 求deviceid 是 终 端 ID 填 写 终 端 IDlocationtimespan 是 时 间 间 隔 上 点 时 间 间 隔 ， 单 位 秒8.3.3 响 应定 时 监 控 指 令 （ setLocationTimeSpan） 操 作 的 请 求 有 效 时 ， 服 务 器 应 根 据 请 求 的 参 数 返 回 请 求 成 功响 应 。 请 求 响 应 的 服 务 接 口
40、 如 图 10 所 示 。 图 10 定 时 监 控 指 令 服 务 接 口8.4 拍 照 命 令8.4.1 描 述终 端 拍 照 命 令 （ takePhoto） 用 于 对 车 载 设 备 下 发 摄 像 头 工 作 命 令 ， 车 载 设 备 接 收 命 令 后 自 动 拍 照 上传 拍 摄 的 图 片 。8.4.2 请 求终 端 拍 照 命 令 （ takePhoto） 的 请 求 参 数 如 表 14 所 示 。表 14 takePhoto 请 求 URL 的 参 数 请 求 参 数 可 选 性 含 义 描 述 及 要 求deviceid 必 选 终 端 ID 填 写 终 端 IDr
41、esolution 可 选 分 辨 率 1:320*240； 2:640*480；3:800*600； 4:1024*768;JT/T 808 2019不 填 写 则 默 认 2， 但 不 能 填 写 其 他 值quality 可 选 照 片 质 量 1： 低 质 量 ； 2： 中 质 量 ；3： 高 质 量 ；不 填 写 则 默 认 2， 但 不 能 填 写 其 他 值 DB 23/T 2637 2020 1 4 channel 可 选 摄 像 头 通 道 1 5， 不 填 则 默 认 1， 但 不 能 填 写 其 他 值8.4.3 响 应终 端 拍 照 命 令 （ takePhoto） 操
42、 作 请 求 有 效 时 ， 服 务 器 应 根 据 请 求 的 参 数 返 回 请 求 成 功 响 应 ， 请 求 响应 的 服 务 接 口 如 图 11 所 示 。 图 11 拍 照 命 令 下 发 上 传 服 务 接 口8.5 指 令 服 务 反 馈8.5.1 描 述指 令 服 务 反 馈 信 息 采 用 activeMQ 作 为 消 息 中 间 件 来 推 送 实 时 信 息 ， 使 用 方 式 为 用 户 登 录 系 统 后 访问 http:/:/webPush/keepTopicHeart,获 取 主 题 名 称 ， 然 后 连 接 到 指 定 的 activeMQ 即 可 ， 等
43、待 实 时 数 据 推 送 过 来 ， 同 时 ， 需 要 设 置 定 时 程 序 维 持 activeMQ 主 题 。8.5.2 请 求 表 15 MQ连 接 参 数 请 求 参 数 可 选 性 含 义 描 述 及 要 求url 必 选 Mq服 务 地 址 http:/*.*.*.*:*username 必 选 用 户 名 Mq推 送 主 题 的 用 户 名password 必 选 密 码 Mq实 时 推 送 主 题 用 户 名 对 应 的 密 码8.5.3 响 应指 令 服 务 反 馈 操 作 请 求 有 效 时 ， 服 务 器 应 根 据 请 求 的 参 数 返 回 请 求 成 功 响 应 ， 服 务 响 应 反 馈 如 表 所示 。 表 16 指 令 服 务 反 馈 操 作 结 果 参 数 名 称 数 据 类 型 描 述 及 要 求DataType string 描 述 此 消 息 的 数 据 类 型 ， 此 处 固 定 为 ExecutionStatus 字 符 DB 23/T 2637 2020 1 5 deviceId string 终 端 唯 一 ID。detectionTime string 事 件 触 发 时 间 。Status string 命 令 执 行 状 态 ： error-失 败 , success-成 功Data Strin
