admin 管理员组

文章数量: 1184232


2024年1月11日发(作者:polyfit在matlab的返回值)

基于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 应用接口 API interface

系统留给应用程序的一个调用接口,应用程序通过调用系统的 API 而使系统去执行应用程序的命令(动作),API介于应用层和服务层。

4 位置服务应用接口基本要求

4.1 总体要求

在北斗数据中心的位置服务系统与应用之间通过API进行位置数据交换,要求应用层和服务层之间的通信数据交换格式使用JSON格式,示意图参见图1。通信传输的JSON数据默认全部采用小写字母。超过2个参数的请求,使用JSON字符流的方式提交请求。数据交换时要发送请求,并返回结果代1

T/ZKJXX ××××—××××

码和消息内容。

图 1 JSON格式交换接口示意图

4.2请求失败

请求失败时按表1返回代码和消息内容。

表1 请求失败

条目 说明(描述及要求)

code 1

message

“错误信息”

4.3请求成功

请求成功时按表2返回代码和消息内容,消息内容默认为空。

表2 请求成功

条目 说明(描述及要求)

code 0

message “”

4.4时间信息

使用 Unix时间戳格式(10位整形数字),精确到秒。时间范围格式,分为starttime{10位整形数字}和endtime{10位整形数字}。

4.5空间坐标

空间坐标格式为GeoJSON 格式。

5 位置服务应用接口

5.1 获取单位编制信息

获取单位编制信息分为获取所有单位、根据deptid获取指定单位和获取所有下属单位编制信息三种情况。输入参数见表3。

表3 获取单位编制信息输入参数

2


本文标签: 格式 信息 获取 文件 接口