ICS 35.020 A 90 T/ZKJXX 00001—2019 基于JSON格式的北斗位置数据交换接口 规范 Specification of Beidou location data exchange interface based on JSON format 2019-12-04发布 2019-12-04实施 中关村空间信息产业技术联盟 发布 全国团体标准信息平台 全国团体标准信息平台 T/ZKJXX 00001—2019 I 目 次 前言 ................................ ................................ ................ II 1 范围 ................................ ................................ .............. 1 2 规范性引用文件 ................................ ................................ .... 1 3 术语和定义 ................................ ................................ ........ 1 3.1 基于位置服务 Location Based Service；LBS ................................ ... 1 3.2 JSON JavaScript Object Notation ................................ ............ 1 3.3 GeoJSON Geoemtry JavaScript Object Notation ............................... 1 3.4 时间格式 Time format ................................ ........................ 1 3.5 应用接口 API interface ................................ ...................... 1 4 位置服务应用接口基本要求 ................................ .......................... 2 4.1 总体要求 ................................ ................................ ...... 2 4.2 请求失败 ................................ ................................ ...... 2 4.3 请求成功 ................................ ................................ ...... 2 4.4 时间信息 ................................ ................................ ...... 2 4.5 空间坐标 ................................ ................................ ...... 2 5 位置服务应用接口 ................................ ................................ .. 3 5.1 获取单位编制信息 ................................ .............................. 3 5.2 获取单位分组信息 ................................ .............................. 3 5.3 查询北斗用户终端位置数据 ................................ ...................... 4 5.4 查询用户最新位置数据 ................................ .......................... 5 5.5 查询所有用户最新位置数据 ................................ ...................... 5 5.6 查询北斗用户终端机器信息 ................................ ...................... 6 5.7 获取报警区域数据 ................................ .............................. 7 5.8 获取报警信息 ................................ ................................ .. 7 5.9 获取区域最后一次报警信息 ................................ ...................... 8 5.10 获取报文信息 ................................ ................................ . 8 参考文献 ................................ ................................ ............ 10 全国团体标准信息平台 T/ZKJXX 00001—2019 II 前 言 本标准按照 GB/T 1.1 —2009给出的规则起草。 本标准由中关村空间信息产业技术联盟提出并归口。 本标准起草单位：北京博 阳世通信息技术有限公司、北京合众思壮科技股份有限公司、北京超图软 件股份有限公司。 本标准主要起草人：官明霖、王伟、索荣瑶、李士国、卢伟、陈应东。 全国团体标准信息平台 T/ZKJXX 00001—2019 1 基于JSON格式的北斗位置数据交换接口规范 1 范围 本标准规定了北斗数据中心与北斗位置服务应用接口基本要求和通信协议。 本标准适用于北斗数据应用服务的位置信息数据交换接口。 2 规范性引用文件 下列文件对于本文件的应用是必不可少的。 凡是注日期的引用文件， 仅注日期的版本适用于本文件。 凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。 BD 110001 —2015 北斗卫星导航术语 GA/T 1481.6 —2018 北斗 /全球卫星导航系统公安应用 第6部分：定位信息通信协议及数据格式 3 术语和定义 下列术语和定义适用于本文件。 3.1 基于位置服务 Location Based Service ；LBS 基于卫星导航或其它手段获取时空信息，向用户提供与位置相关联的服务。 3.2 JSON JavaScript Object Notation 一种轻量级的数据交换格式 ，是基于ECMAScript 的一个子集。 3.3 GeoJSON Geoemtry JavaScript Object Notation 一种对各种地理数据结构进行编码 的格式， 基于 JavaScript对象表示法的地理空间信息数据交换格 式。 注1：GeoJSON 对象可以表示几何、特征或者特征集合。 注2：GeoJSON 支持点、线、面、多点、多线、多面和几何集合。 注3：GeoJSON 里的特征包含一个几何对象和其他属性，特征集合表示一系列特征。 3.4 时间格式 Time format 一种时间表示方式，定义为从格林威治时间 1970年01月01日08时00分00秒起至现在的总秒数。 注：本标准定义的时间格式为 Unix时间戳格式（ 10位整形数字），精确到秒。 3.5 全国团体标准信息平台 T/ZKJXX 00001—2019 2 应用接口 API interface 系统留给应用程序的一个调用接口， 应用程序通过调用系统的 API 而使系统去执行应用程序的命令 （动作） ，API介于应用层和服务层。 4 位置服务应用接口基本要求 4.1 总体要求 在北斗数据中心的位置服务系统与应用之间通过 API进行位置数据交换，要求应用层和服务层之间 的通信数据交换格式 使用JSON格式，示意图参见图 1。通信传输的JSON数据默认全部采用小写字母。超 过2个参数的请求，使用 JSON字符流的方式提交请求。数据交换时要发送请求，并返回结果代码和消息 内容。 图1 JSON格式交换接口示意图 4.2 请求失败 请求失败时按表 1返回代码和消息内容。 表1 请求失败 条目 说明（描述及要求） code 1 message “错误信息 ” 4.3 请求成功