D B 2 3/T 2 6 3 7 2 0 2 0DB23I C S 0 7.0 4 0A 7 5黑 龙 江 省 地 方 标 准D B 2 3/T 2 6 3 7 2 0 2 02 0 2 0 0 6 0 8 发 布 2 0 2 0 0 7 0 7 实 施黑 龙 江 省 市 场 监 督 管 理 局黑 龙 江 省 测 绘 地 理 信 息 局联 合 发 布位 置 服 务 平 台 多 模 式 协 同 定 位 服 务 接 口技 术 规 范L o c a t i o n S e r v i c e P l a t f o r m M u l t i-M o d e C o o p e r a t i v e P o s i t i o n i n gS e r v i c e I n t e r f a c e t e c h n i c a l s p e c i f i c a t i o nD B 2 3/T 2 6 3 7 2 0 2 0I目 次前 言.I1 范 围.12 规 范 性 引 用 文 件.13 术 语 和 定 义.14 总 则.25 符 号、缩 略 语 和 U M L 标 记.36 基 本 服 务 元 素.47 定 位 服 务 操 作.68 指 令 服 务 操 作.69 扩 展 服 务 操 作.6附 录 A(规 范 性 附 录)服 务 接 口 部 分 返 回 字 段 说 明.错 误！未 定 义 书 签。附 录 B(资 料 性 附 录)服 务 接 口 返 回 数 据 结 构.1 6参 考 文 献.2 3D B 2 3/T 2 6 3 7 2 0 2 0I前 言本 标 准 按 照 G B/T 1.1-2 0 0 9 编 写 的 规 则 起 草。本 标 准 由 黑 龙 江 省 测 绘 地 理 信 息 局 提 出。本 标 准 由 黑 龙 江 省 测 绘 地 理 信 息 局 标 准 化 技 术 委 员 会 归 口。本 标 准 起 草 单 位：自 然 资 源 部 黑 龙 江 基 础 地 理 信 息 中 心。本 标 准 主 要 起 草 人：周 振 发、林 富 明、张 庆 全、刘 禹 鑫、周 源、王 洪 昌、刘 恒 飞、李 冰、古 一 鸣、王 芳、李 梅、朱 晓 东。D B 2 3/T 2 6 3 7 2 0 2 01位 置 服 务 平 台 多 模 式 协 同 定 位 服 务 接 口 技 术 规 范1 范 围本 标 准 规 定 了 位 置 服 务 平 台 多 模 式 协 同 定 位 服 务 接 口 的 适 用 范 围、一 致 性 要 求、规 范 性 引 用 文 件、术 语 和 定 义、符 号、缩 略 语 和 U M L 标 记、建 设 原 则、基 本 服 务 要 素 和 定 位 指 令 服 务 操 作。本 标 准 适 用 于 行 业 领 域 位 置 服 务 多 模 式 协 同 定 位 的 管 理、研 究、开 发 及 应 用。2 规 范 性 引 用 文 件下 列 文 件 对 本 文 件 的 应 用 是 必 不 可 少 的。凡 是 注 日 期 的 引 用 文 件，仅 注 日 期 的 版 本 使 用 于 本 文 件。凡 是 不 注 日 期 的 引 用 文 件，其 最 新 版 本（包 括 所 有 的 修 改 单 元）适 用 于 本 文 件。G B/T 1 6 8 3 1-2 0 1 3 基 于 坐 标 的 地 理 点 位 置 标 准 表 示 法G B/T 3 0 2 8 8-2 0 1 3 卫 星 导 航 定 位 坐 标 系 统G B/T 7 4 0 8-2 0 0 5 数 据 元 和 交 换 格 式 信 息 交 换 日 期 和 时 间 表 示 法J T/T 8 0 8-2 0 1 9 道 路 运 输 车 辆 卫 星 定 位 系 统 终 端 通 讯 协 议 及 数 据 格 式J T/T 7 9 4-2 0 1 9 道 路 运 输 车 辆 卫 星 定 位 系 统 车 载 终 端 技 术 要 求J T/T 7 9 6-2 0 1 1 道 路 运 输 车 辆 卫 星 定 位 系 统 平 台 技 术 要 求W 3 C X M L 可 扩 展 标 记 语 言 1.0（第 五 版），W 3 C 推 荐（2 0 0 8）3 术 语 和 定 义下 列 术 语 和 定 义 适 用 于 本 文 件。3.1位 置 服 务根 据 特 定 需 求，采 用 卫 星 定 位 技 术 获 取 的 用 户 终 端 的 位 置 信 息，通 过 移 动 通 信 网 络，在 电 子 地 图 服务 的 可 视 化 支 持 下 提 供 给 用 户 本 人 或 他 人 以 及 通 信 系 统，实 现 定 位、导 航、查 询、识 别 和 事 件 检 查 等 与空 间 位 置 相 关 的 增 值 服 务。3.2定 位 模 式采 用 一 定 的 定 位 设 备 和 定 位 技 术 组 合 进 行 定 位 的 方 式。3.3协 同 定 位采 用 不 同 定 位 模 式 实 现 室 内 外 空 间 的 定 位 服 务。注：多 种 定 位 技 术 与 方 法 相 互 协 调 完 成 的 定 位 服 务。D B 2 3/T 2 6 3 7 2 0 2 023.4定 位 区 域能 提 供 稳 定 的 定 位 服 务 与 流 畅 的 信 息 交 互 的 空 间 区 域。3.5接 口 用 户应 用 位 置 服 务 多 模 式 协 同 定 位 服 务 接 口 的 开 发 人 员。3.6定 位 终 端定 位 终 端 是 位 置 服 务 平 台 的 定 位 数 据 来 源 设 备，包 括 G P S/北 斗 车 载 终 端、手 持 定 位 终 端，具 备 定 位功 能 的 手 机、无 线 对 讲 机 等。注：本 处 车 载 终 端 一 般 要 求 符 合 交 通 部 J T/T 7 9 4-2 0 1 9，终 端 与 平 台 间 的 数 据 格 式 符 合 J T/T 8 0 8-2 0 1 9道 路 运 输 车 辆 卫 星 定 位 系 统 终 端 通 讯 协 议 及 数 据 格 式(兼 容 J T/T 8 0 8-2 0 1 3）J T/T 7 9 6-2 0 1 1 3.5 车 载 终 端 3.7网 络 通 讯 协 议连 接 不 同 操 作 系 统 和 不 同 硬 件 体 系 结 构 的 互 联 网 络 提 供 通 信 支 持，是 一 种 网 络 通 用 语 言。4 总 则4.1 一 致 性任 何 声 称 与 本 标 准 相 一 致 的 定 位 服 务 的 实 现 或 产 品 都 应 满 足 本 标 准 规 定 的 接 口 服 务 操 作 和 相 应 数据 结 构 的 全 部 要 求。4.2 实 用 性接 口 功 能 跨 平 台 使 用，具 备 实 用、简 洁 的 特 点。4.3 扩 展 性平 台 具 备 对 架 构、容 量、通 信 和 处 理 能 力 等 方 面 进 行 接 口 扩 充 和 升 级 的 特 点。4.4 开 放 性与 相 关 技 术 标 准 相 统 一，传 输 协 议 具 备 通 用 性 与 一 致 性 的 要 求。4.5 先 进 性接 口 具 备 功 能、采 用 技 术、实 现 方 法、可 延 续 性 等 方 面 技 术 的 先 进 性。D B 2 3/T 2 6 3 7 2 0 2 035 符 号、缩 略 语 和 U M L 标 记5.1 缩 略 语下 列 缩 略 语 适 用 于 本 文 件。O G C 开 放 地 理 空 间 信 息 联 盟（O p e n G e o s p a t i a l C o n s o r t i u m）C G C S 2 0 0 0 2 0 0 0 国 家 大 地 坐 标 系（C h i n a G e o d e t i c C o o r d i n a t e S y s t e m 2 0 0 0）G B/T 3 0 2 8 8-2 0 1 3,缩略语 3.2 C R S 坐 标 参 照 系（C o o r d i n a t e R e f e r e n c e S y s t e m)G N S S 全 球 导 航 卫 星 系 统（G l o b a l N a v i g a t i o n S a t e l l i t e S y s t e m）G S M 全 球 移 动 通 信 系 统（G l o b a l S y s t e m f o r M o b i l e C o m m u n i c a t i o n s）X M L 可 扩 展 标 记 语 言（E x t e n s i b l e M a r k u p L a n g u a g e）W 3 C X M L 可扩展标记语言 1.0 5.2 U M L 标 记在 本 标 准 中，采 用 统 一 建 模 语 言（U M L）描 述 室 内 外 多 模 式 协 同 定 位 的 概 念 模 型 和 服 务 接 口。基 本的 数 据 类 型 和 图 表 在 I S O/T S 1 9 1 0 3:2 0 0 5 中 以 及 I S O/I E C 1 9 5 0 1 中 说 明。在 本 标 准 中，采 用 下 列 U M L 类 的 构 造 型：a)()一 组 没 有 标 识（独 立 存 在 且 可 能 存 在 边 缘 效 应）值 的 描 述 符。数据 类 型 包 括 基 本 的 预 定 类 型。D a t a T y p e 是 一 个 具 有 少 量 操 作 或 没有 操 作 的 类，其 主 要 目 的 是 保 持 其 他 类 的 抽 象 状 态。b)()一 个 灵 活 的 枚 举，用 于 描 述 一 个 开 放 列 表。如 果 完 全 知 道 该 表 的元 素 的 值，则 应 使 用 枚 举；如 果 只 知 道 该 表 元 素 的 可 能 值，则 应使 用 代 码 表。c)()不 能 直 接 实 例 化 的 类（或 其 他 类 元）。该 类 的 U M L 标 记 用 斜 体 表 示其 名 称。d)()命 名 的 操 作 集，描 述 元 素 的 行 为。e)()逻 辑 上 相 关 组 分 的 群 集，包 括 子 包。f)()一 组 抽 象 的 属 性 和 关 联。抽 象 意 味 着 其 规 范 不 一 定 应 作 为 实 例 变量 体 实 现。在 本 标 准 中，U M L 标 记 的 主 要 元 素 如 图 1 所 示。D B 2 3/T 2 6 3 7 2 0 2 04图 1 U M L 标 记6 基 本 服 务 元 素6.1 概 述本 条 规 定 了 服 务 接 口 中 独 立 于 特 定 服 务 必 选 操 作 的 通 用 部 分，操 作 流 程 如 下 图 2 所 示。图 2 操 作 流 程 图6.2 用 户 验 证先 校 验 用 户 名，获 取 加 密 参 数，将 密 码 执 行 r s a 加 密 后，再 进 行 登 录 验 证，方 可 进 行 定 位 服 务、指令 服 务 以 及 扩 展 服 务 的 操 作，并 且 后 续 调 用 的 接 口 不 再 需 要 传 递 用 户 参 数，将 自 动 识 别 登 录 用 户。表 1 用 户 验 证 详 细 参 数 表参数 名 是否 必须 值u s e r n a m e 是 用户名，例如：t e s t u s e r 1p a s s w o r d 是 R S A 加密后的密码密文，很长一串字符串。r e t u r n t e x t 是 固定为 t r u eD B 2 3/T 2 6 3 7 2 0 2 056.3 设 备 验 证通 过 提 供 专 用 接 口 执 行 设 备 传 回 数 据 接 收 入 口 校 验，用 来 验 证 隶 属 于 该 平 台 的 设 备，校 验 成 功 后 放行 否 则 为 无 效 数 据。如 图 表 1。表 2 设 备 验 证 详 细 参 数 表参数 名 是否 必须 值d e v i c e i d 是 终端设备识别码i n f o g a t e n a m e 是 信息网关名6.4 位 置 坐 标位 置 坐 标 数 据 是 多 模 式 协 同 定 位 服 务 接 口 提 供 的 核 心 服 务 内 容，各 种 终 端 结 构 数 据 最 后 基 于 该 标 准坐 标 数 据 结 构（终 端 实 时 位 置 数 据），基 于 该 标 准 数 据 结 构，用 户 能 根 据 不 同 的 应 用 场 景 开 发 各 种 位 置服 务 延 伸 应 用，如 图 表 2。表 3 定 位 数 据 结 构名称 字段 类型 必选 性 含义单位l a t d o u b l e 必选 纬度 度l o n d o u b l e 必选 经度 度a l t d o u b l e 可选 高程 米s p e e d d o u b l e 可选 速度 米每秒o r i e n t a t i o n d o u b l e 可选 方向 度l o c a t i o n t i m e s t r i n g 必选 定位时间 Y Y Y Y M M D D T h h m m s s坐 标 数 据 中 的 l a t、l o n 和 a l t 应 符 合 基 于 坐 标 的 地 理 点 位 置 标 准 表 示 法（G B/T 1 6 8 3 1-2 0 1 3）对地 理 点 位 置 的 规 定。其 中，高 程 单 位 为 米，速 度 单 位 是 米 每 秒，方 位 角 是 以 真 北 方 向 TN 为 参 考 基 准，范 围 在 0-3 6 0。定 位 时 间 以 采 用 U T C 作 为 参 照 基 准，其 格 式 表 示 为 符 合 G B/T 7 4 0 8-2 0 0 5 数 据 元 和 交换 格 式 信 息 交 换 日 期 和 时 间 表 示 法 的 字 符 串，为 Y Y Y Y M M D D T h h m m s s。6.5 服 务 注 销当 结 束 服 务 调 用 时，执 行 服 务 注 销 操 作。6.6 服 务 响 应当 服 务 调 用 时，通 用 返 回 结 果 为 J S O N 数 据 格 式，具 体 格 式 见 附 录 A，详 细 记 录 了 服 务 调 用 返 回 状 态与 执 行 结 果。6.7 服 务 异 常当 接 收 到 不 符 合 本 标 准 的 无 效 请 求 时，或 定 位 服 务 计 算 出 现 问 题 时，定 位 服 务 器 应 发 布 服 务 异 常 报D B 2 3/T 2 6 3 7 2 0 2 06告，用 于 向 客 户 应 用 程 序 和 使 用 者 声 明 请 求 无 效 的 原 因。6.8 消 息 通 道主 要 包 括 后 台 下 行 命 令 请 求 消 息 队 列 接 口 和 信 息 网 关 上 行 信 息 推 送 消 息 队 列 接 口 两 部 分，作 为 命 令执 行 获 取 消 息 反 馈 的 通 道。7 定 位 服 务 操 作7.1 概 述本 标 准 规 定 位 置 服 务 平 台 采 用 以 下 服 务 操 作 实 现 获 取 基 本 位 置 与 定 位 相 关 服 务，并 在 名 称 与 含 义 上保 持 一 致，接 口 统 一 访 问 h t t p:/:/w e b A p p I n t e r f a c e/命 令 名 称。终 端 管 理（m y D e v i c e s）操 作：获 取 用 户 所 管 辖 内 所 有 终 端 基 本 信 息。终 端 参 数（p a r a m s）操 作：获 取 特 定 终 端 参 数 列 表。终 端 定 位 服 务（r e a l T i m e I n f o）操 作：实 时 请 求 终 端 最 新 位 置。历 史 回 放（h i s t o r y B L I n f o）操 作：用 于 查 询 某 时 段 的 终 端 轨 迹 点 集 合 的 历 史 位 置 信 息。表 4 定 位 服 务 操 作操作 名称 操作 含义 可选 性m y D e v i c e s 终端管理 必选r e a l T i m e I n f o 终端定位服务 必选p a r a m s 终端信息 可选h s i t o r y B L P o i n t H a n d l e r 历史回放 可选7.2 终 端 管 理7.2.1 描 述终 端 管 理 类（m y D e v i c e s）操 作 用 于 查 询 及 变 更 终 端 基 本 信 息 相 关 参 数。7.2.2 请 求终 端 管 理 类（m y D e v i c e s）的 请 求 参 数 如 表 5 所 示。表 5 请 求 U R L 的 参 数请求 参数 可选 性 含义 描述 及要求d e v i c e t y p e 否 终端类别(支持车载、手持等多种终端类别)指定终端类别。形如：l b s _ d e v _ v e h i c l e，不填写则获取所辖全部终端D B 2 3/T 2 6 3 7 2 0 2 077.2.3 响 应终 端 管 理 类（m y D e v i c e s）操 作 的 请 求 有 效 时，服 务 器 应 根 据 请 求 的 参 数 返 回 一 个 响 应，根 据 请 求类 型 返 回 终 端 详 细 信 息，请 求 响 应 的 服 务 接 口 如 图 3 所 示，其 J S O N 数 据 结 构 的 示 例 见 附 录 B.2。图 3 m y D e v i c e s 接 口7.3 终 端 参 数7.3.1 描 述终 端 参 数 类（p a r a m s）操 作 的 目 的 是 查 询 及 变 更 用 户 管 理 的 车 载、手 持、北 斗 等 定 位 终 端 或 者 权 限等 信 息，返 回 用 户 对 应 终 端 及 权 限。7.3.2 请 求终 端 参 数 类（p a r a m s）的 请 求 参 数 如 表 6 所 示。表 6 p a r a m s 请 求 U R L 的 参 数请求 参数 可选 性 含义 描述 与要求d e v i c e i d 必选 终端 I D7.3.3 响 应终 端 参 数 类（p a r a m s）操 作 的 请 求 有 效 时，服 务 器 应 根 据 请 求 的 参 数 返 回 一 个 响 应，根 据 请 求 类 型返 回 终 端 详 细 信 息，请 求 响 应 的 服 务 接 口 如 图 4 所 示，其 J S O N 数 据 结 构 的 示 例 见 附 录 B.2。图 4 p a r a m s 接 口D B 2 3/T 2 6 3 7 2 0 2 087.4 终 端 定 位7.4.1 描 述终 端 定 位 类（r e a l T i m e I n f o）操 作 实 现 实 时 请 求 终 端 最 新 位 置，获 取 多 种 终 端 设 备 明 码 经 纬 度 地 理坐 标 位 置 信 息、时 间、速 度、方 向 等 实 时 信 息。7.4.2 请 求终 端 定 位 类（r e a l T i m e I n f o）操 作 的 请 求 参 数 如 表 7 所 示。表 7 r e a l T i m e I n f o 请 求 U R L 的 参 数请求 参数 可选 性 含义 描 述 及 要 求d e v i c e i d s 可选 终端标识指定终端的识别码，多个时以英文逗号隔开。形如：1 3 8 1 2 3 4 5 6 7 8,1 5 8 1 2 3 4 5 6 7 8，不填写则获取所辖全部终端i s a l l 必选 是否刷新是否强制刷新，填写 t r u e 时，不管终端最新位置是否发生变化均强制获取最后一条实时数据，不填写或者填写 f a l s e 时，只返回发生变化的终端实时数据。7.4.3 响 应终 端 定 位 类（r e a l T i m e I n f o）操 作 的 请 求 有 效 时，服 务 器 应 根 据 请 求 的 参 数 返 回 一 个 响 应，否 则 就返 回 一 个 服 务 异 常。请 求 响 应 的 服 务 接 口 如 图 5 所 示，逻 辑 结 构 如 图 6，返 回 该 用 户 所 属 所 有 终 端 的 实时 位 置 信 息。其 J S O N 数 据 结 构 的 示 例 见 附 录 B.3。图 5 r e a l T i m e I n f o 接 口D B 2 3/T 2 6 3 7 2 0 2 09图 6 逻 辑 结 构7.5 历 史 回 放7.5.1 描 述历 史 回 放（h i s t o r y B L I n f o）操 作 用 于 查 询 终 端 历 史 位 置 信 息，获 取 某 时 段 的 终 端 轨 迹 点 集 合。7.5.2 请 求历 史 回 放（h i s t o r y B L I n f o）的 请 求 参 数 如 表 8 所 示。表 8 h i s t o r y B L I n f o 请 求 U R L 的 参 数请求 参数 可选 性 含义描述 及要求d e v i c e i d 必选 终端设备的识别码s t a r t t i m e 必选 开始时间 查询起始时间e n d t i m e 可选 结束时间不填则默认以当前时间为结束时间7.5.3 响 应历 史 回 放（h i s t o r y B L I n f o）操 作 的 请 求 有 效 时，服 务 器 应 根 据 请 求 的 参 数 返 回 一 个 响 应，返 回 请 求查 询 时 间 内 终 端 所 有 的 运 动 轨 迹 点 集 合。请 求 响 应 的 服 务 接 口 如 图 7 所 示，逻 辑 结 构 如 图 8，返 回 该 用户 所 属 所 有 终 端 的 实 时 位 置 信 息。其 J S O N 数 据 结 构 的 示 例 见 附 录 B.4。D B 2 3/T 2 6 3 7 2 0 2 01 0图 7 h i s t o r y B L I n f o 接 口图 8 响 应 逻 辑 图8 指 令 服 务 操 作8.1 概 述本 标 准 规 定 位 置 服 务 平 台 采 用 以 下 服 务 操 作 实 现 与 终 端 交 互 相 应 指 令（指 令 符 合 国 家 部 标 标 准 协议，并 具 备 扩 展 能 力），并 在 名 称 与 含 义 上 保 持 一 致，接 口 统 一 访 问 h t t p:/:/j t t 8 0 8 c o m m a n d/命 令 名 称；通 过 指 令 服 务 反 馈 和 指 令 反 馈 维 持 回 去 指 令 服 务 执 行 的 状 态。报 警 命 令（超 速 报 警 s e t O v e r S p e e d，区 域 报 警 s e t A r e a C i r c u l a r，报 警 操 作 用 于 超 速 和 区 域 等 报 警 命令 发 送 及 取 消。定 时 监 控 命 令（s e t L o c a t i o n T i m e S p a n）操 作 用 于 控 制 定 位 终 端 设 备 上 报 位 置 的 时 间 频 率。拍 照 命 令（t a k e P h o t o）操 作 用 于 对 车 载 设 备 下 发 摄 像 头 工 作 命 令 和 传 输 终 端 上 传 的 拍 摄 图 片。表 9 指 令 服 务 操 作操作 名称 可选 性 含义 描述 及要求S p e e d C o m m a n d H a n d l e rs e t A r e a R e c t a n g l eC a n c e l C o m m a n d H a n d l e可选 报警命令 见 8.2s e t L o c a t i o n T i m e S p a n 可选 定时监控命令 见 8.3t a k e P h o t o 可选 拍照命令与上传 见 8.4D B 2 3/T 2 6 3 7 2 0 2 01 18.2 报 警 命 令8.2.1 描 述报 警 命 令 中 超 速 报 警 s e t O v e r S p e e d，区 域 报 警 s e t A r e a C i r c u l a r，涵 盖 设 置 区 域 报 警(圆 形、矩 形 和 多边 形)，查 询 区 域 报 警，删 除 区 域 报 警 等，此 处 以 超 速 报 警 和 圆 形 区 域 报 警 为 例。8.2.2 请 求报 警 命 令 的 请 求 参 数 如 表 1 0、1 1、1 2 所 示。表 1 0 s e t O v e r S p e e d 请 求 U R L 的 参 数请求 参数 可选 性 含义 描述 及要求d e v i c e i d 必选 终端 I D 填写终端 I Dh i g h s p e e d 必选 限速值 最高限速，单位 k m/ho v e r s p e e d d u r a t i o n 必选 持续时间 超速持续时间，单位秒表 1 1 s e t A r e a C i r c u l a r 请 求 U R L 的 参 数请求 参数 含义 可选 性 描述 及要求d e v i c e i d 必选 填写终端 I Du s e t i m e 可选是 否 根 据 时间进行限制0：否，1：是，默认 0s t a r t t i m e 如果 U s e T i m e 为 1 则必填格式Y Y Y Y-M M-D Dh h:m m:s s设置区域或者路线报警时，消息协议支持周期时间范围，如要限制每天的 8:3 0-1 8:0 0，起始/结束时间设为：0 0-0 0-0 0-0 8-3 0-0 0/0 0-0 0-0 0-1 8-0 0-0 0，其他以此类推e n d t i m e 如果 U s e T i m e 为 1 则必填格式Y Y Y Y-M M-D Dh h:m m:s sl i m i t s p e e d 可选 是否限速 0 否，1：是，默认 0h i g h e s t s p e e d 如果 L i m i t S p e e d 为 1 则必填 最高限速 单位 K M/Ho v e r s p e e d d u r a t i o n 如果 L i m i t S p e e d 为必填超 速 持 续 多长 时 间 认 定为超速单位秒D B 2 3/T 2 6 3 7 2 0 2 01 2i n a l e r m 可选进 入 区 域 报警0 否，1：是，默认 0o u t a l e r m 必选离 开 区 域 报警0 否，1：是，默认 1c e n t e r p o i n t l a t 必选 圆心纬度 3 8.1 2 3 4 5 6，精确到小数点后 6 位c e n t e r p o i n t l n g 必选 圆心经度 如 1 2 6.1 2 3 4 5 6，精确到小数点后 6 位r a d i u s 是 半径 单位：米表 1 2 d e l e t e A r e a C i r c u l a r 请 求 U R L 的 参 数请求 参数 可选 性 含义 描述 及要求d e v i c e i d 必选 填写终端 I Da r e a i d l i s t 必选 区域 I D删除多个时以逗号分隔，例如:0,1,2,3。如为空则删除所有区域。不超过1 2 5 个，多于1 2 5 个建议用多条消息8.2.3 响 应报 警 命 令 操 作 的 请 求 有 效 时，服 务 器 应 根 据 请 求 的 参 数 返 回 请 求 成 功 响 应，终 端 将 记 录 超 速、区 域报 警 约 束，报 警 信 息 随 终 端 定 位 基 本 信 息 返 回。请 求 响 应 的 服 务 接 口 如 图 9 所 示，其 J S O N 数 据 结 构 的示 例 见 附 录 B.5。图 9 s e t O v e r S p e e d 响 应8.3 定 时 监 控 指 令8.3.1 描 述定 时 监 控 指 令（s e t L o c a t i o n T i m e S p a n）操 作 用 于 设 置 终 端 上 报 位 置 时 间 间 隔。8.3.2 请 求D B 2 3/T 2 6 3 7 2 0 2 01 3定 时 监 控 指 令（s e t L o c a t i o n T i m e S p a n）的 请 求 参 数 如 表 1 3 所 示。表 1 3 s e t L o c a t i o n T i m e S p a n 请 求 U R L 的 参 数请求 参数 可选 性 含义 描述 及要求d e v i c e i d 是 终端 I D 填写终端 I Dl o c a t i o n t i m e s p a n 是 时间间隔 上点时间间隔，单位秒8.3.3 响 应定 时 监 控 指 令（s e t L o c a t i o n T i m e S p a n）操 作 的 请 求 有 效 时，服 务 器 应 根 据 请 求 的 参 数 返 回 请 求 成 功响 应。请 求 响 应 的 服 务 接 口 如 图 1 0 所 示。图 1 0 定 时 监 控 指 令 服 务 接 口8.4 拍 照 命 令8.4.1 描 述终 端 拍 照 命 令（t a k e P h o t o）用 于 对 车 载 设 备 下 发 摄 像 头 工 作 命 令，车 载 设 备 接 收 命 令 后 自 动 拍 照 上传 拍 摄 的 图 片。8.4.2 请 求终 端 拍 照 命 令（t a k e P h o t o）的 请 求 参 数 如 表 1 4 所 示。表 1 4 t a k e P h o t o 请 求 U R L 的 参 数请求 参数 可选 性 含义描述 及要求d e v i c e i d 必选 终端 I D 填写终端 I Dr e s o l u t i o n 可选 分辨率1:3 2 0*2 4 0；2:6 4 0*4 8 0；3:8 0 0*6 0 0；4:1 0 2 4*7 6 8;J T/T 8 0 8 2 0 1 9 不填写则默认 2，但不能填写其他值q u a l i t y 可选 照片质量1：低质量；2：中质量；3：高质量；不填写则默认 2，但不能填写其他值D B 2 3/T 2 6 3 7 2 0 2 01 4c h a n n e l 可选 摄像头通道 1 5，不填则默认 1，但不能填写其他值8.4.3 响 应终 端 拍 照 命 令（t a k e P h o t o）操 作 请 求 有 效 时，服 务 器 应 根 据 请 求 的 参 数 返 回 请 求 成 功 响 应，请 求 响应 的 服 务 接 口 如 图 1 1 所 示。图 1 1 拍 照 命 令 下 发 上 传 服 务 接 口8.5 指 令 服 务 反 馈8.5.1 描 述指 令 服 务 反 馈 信 息 采 用 a c t i v e M Q 作 为 消 息 中 间 件 来 推 送 实 时 信 息，使 用 方 式 为 用 户 登 录 系 统 后 访问 h t t p:/:/w e b P u s h/k e e p T o p i c H e a r t,获 取 主 题 名 称，然 后 连 接 到 指 定 的 a c t i v e M Q 即 可，等待 实 时 数 据 推 送 过 来，同 时，需 要 设 置 定 时 程 序 维 持 a c t i v e M Q 主 题。8.5.2 请 求表 1 5 M Q 连 接 参 数请求 参数 可选 性 含义描述 及要求u r l 必选 M q 服务地址 h t t p:/*.*.*.*:*u s e r n a m e必选用户名 M q 推送主题的用户名p a s s w o r d必选密码 M q 实时推送主题用户名对应的密码8.5.3 响 应指 令 服 务 反 馈 操 作 请 求 有 效 时，服 务 器 应 根 据 请 求 的 参 数 返 回 请 求 成 功 响 应，服 务 响 应 反 馈 如 表 所示。表 1 6 指 令 服 务 反 馈 操 作 结 果参数 名称 数据 类型 描述 及要求D a t a T y p e s t r i n g 描述此消息的数据类型，此处固定为 E x e c u t i o n S t a t u s 字符D B 2 3/T 2 6 3 7 2 0 2 01 5d e v i c e I d s t r i n g 终端唯一 I D。d e t e c t i o n T i m e s t r i n g 事件触发时间。S t a t u s s t r i n g 命令执行状态：e r r o r-失败,s u c c e s s-成功D a t a S t r i n g/j s o ns u c c e s s 成功时，关联的数据信息，里程时为单字符，参数查询时为 J S O N 对象。D e s c r i p t i o n s t r i n g e r r o r 失败时，描述具体失败原因或者关联信息。C m d T y p e D e s c r i p t i o n s t r i n g 下行命令类型描述，可用于给前端描述指令。p a c k I d i n t指令流水号：仅 8 0 8 协议才有，当流水号为 0 时，此指令一定不是后台接口所发。C m d T y p e s t r i n g 下行命令类型。8.6 指 令 反 馈 维 持8.6.1 描 述指 令 服 务 反 馈 信 息 采 用 a c t i v e M Q 作 为 消 息 中 间 件 来 推 送 实 时 信 息，为 保 证 等 待 实 时 数 据 推 送 获 取，需 要 设 置 定 时 程 序 维 持 a c t i v e M Q 主 题，即 每 隔 一 段 时 间 访 问 一 次 h t t p:/:/w e b P u s h/k e e p T o p i c H e a r t 接 口，访 问 间 隔 时 间 不 超 过 2 0 分 钟，此 消 息 为 维 持 通 道 不 被 自 动 清 理。8.6.2 请 求表 1 7 指 令 反 馈 维 持 请 求 U R L 的 参 数请求 参数 可选 性 含义描述 及要求空 此处直接访问接口 经过用户验证直接访问即可8.6.3 响 应指 令 反 馈 维 持 操 作 请 求 有 效 时，服 务 器 应 根 据 请 求 的 参 数 返 回 请 求 成 功 响 应，响 应 返 回 结 果 J S O N数 据 结 构 示 例 见 附 录 B.7。9 扩 展 服 务 操 作平 台 可 根 据 用 户 需 求，扩 展 该 标 准 服 务 接 口，包 括 平 台 功 能 接 口、综 合 统 计 接 口 和 其 他 终 端 扩 展 协议 接 口。D B 2 3/T 2 6 3 7 2 0 2 01 6附 录 A（规 范 性 附 录）服 务 接 口 部 分 返 回 字 段 说 明A.1 服 务 接 口 部 分 返 回 字 段 说 明 见 表 A.1。表 A.1 规 定 了 所 有 服 务 接 口 返 回 数 据 的 属 性 结 构，返 回 数 据 限 于 包 含 表 中 所 有 属 性 项，并 具 备 不 同字 段 类 型。表 A.1 服 务 接 口 响 应 返 回 数 据 属 性 结 构返回 值字段 字段 类型 字段 说明c o d e t e x t（错误的/正常的）代码d a t a t e x t（正常的）返回结果d e s c r i p t i o n t e x t（错误的）描述信息s t a t u