GB/T 39584-2020.Programming interface specification of middleware for developing navigation electronic map application.
1范围
GB/T 39584规定了导航电子地图应用开发中间件的接口结构、接口分类、接口定义、接口协议及接口验证。
GB/T 39584适用于导航电子地图应用开发中间件接口的设计与开发,也适用于导航应用软件对中间件接口的调用。
2规范性引用文件
下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件,仅注日期的版本适用于本文件。凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。
GB/T 920公路路面等级与面层类型代码
GB/T 2260中华 人民共和国行政区划代码
GB/T 11457-2006信息技术软件工程术语
GB/T 17694地理信息术语
GB/T 19392-2013车载 卫星导航设备通用规范
GB/T 28442-2012导航电子地图数据分类与编码
GB/T 30320地理空间数据库访问接口
3术语和定义
GB/T 11457-2006、GB/T 17694、GB/T 30320界定的以及下列术语和定义适用于本文件。
3.1
导航电子地图 navigation electronic map
含有空间位置地理坐标,能够与空间定位系统结合,准确引导人或交通工具从出发地到达目的地的电子地图或数据集。
[GB/T 28442-2012,定义 2.2]
3.2
中间件 middleware
一种类型的软件模块,它处在系统软件和应用软件之间，依赖系统软件的支持,又为应用软件提供支持,以方便应用软件的开发。
[GB/T 11457-2006,定 义2.954]

ICS49.020
中华人民共和国国家标准
GB/T39584—2020
导航电子地图应用开发中间件接口规范Programming interface specification of middleware for developing navigationelectronicmapapplication
2020-12-14发布
国家市场监督管理总局
国家标准化管理委员会
2021-07-01实施
规范性引用文件
术语和定义
缩略语
接口类型和基本描述
接口结构
接口分类
接口协议
服务器端中间件接口
公共数据类型
地图服务接口
空间数据服务接口
空间分析服务接口
信息查询服务接口
路径规划服务接口
用户服务接口
地址匹配服务接口
元数据服务接口
动态交通服务接口
室内定位与导航服务接口
第三方数据融合服务接口
扩展服务接口
客户端中间件接口
公共数据类型
地图显示接口
自定义标绘接口
信息查询接口
路线规划接口：
路线引导接口
空间分析接口www.bzxz.net
动态交通信息接口
语音接口
事件监听对象接口
室内导航接口
GB/T39584—2020
GB/T39584—2020
系统工具接口
扩展接口
8接口验证
数据服务接口验证
数据加载验证
信息检索验证
路线规划验证
语音导航验证
空间分析验证
附录A（规范性附录）
附录B（规范性附录）
附录C（规范性附录）
附录D（规范性附录）
常用编码表
服务器端中间件接口公共数据类型客户端中间件接口公共数据类型错误码
本标准按照GB/T1.1—2009给出的规则起草。GB/T39584—2020
请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。本标准由中国卫星导航系统管理办公室提出本标准由全国北斗卫星导航标准化技术委员会（SAC/TC544)归口。本标准起草单位：北京超图软件股份有限公司、中国卫星导航工程中心、中国航天标准化研究所、三六零科技集团有限公司、北京智慧图科技有限责任公司、北京航天宏图信息技术股份有限公司。本标准主要起草人：钟耳顺、李少杰、刘莹、蔡文文、刘庆军、曹玉尧、马海波、杨海燕、饶庆云、张绍瑞、张楠、主维嘉。
1范围
导航电子地图应用开发中间件接口规范GB/T39584—2020
本标准规定了导航电子地图应用开发中间件的接口结构、接口分类、接口定义、接口协议及接口验证。
本标准适用于导航电子地图应用开发中间件接口的设计与开发，也适用于导航应用软件对中间件接口的调用。
2规范性引用文件
下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T920公路路面等级与面层类型代码GB/T2260
中华人民共和国行政区划代码
GB/T11457—2006信息技术软件工程术语GB/T17694
地理信息术语
GB/T19392—2
2013车载卫星导航设备通用规范GB/T28442—2012导航电子地图数据分类与编码GB/T30320
3术语和定义
地理空间数据库访问接口
GB/T11457一2006、GB/T17694、GB/T30320界定的以及下列术语和定义适用于本文件。3.1
navigation electronic map
导航电子地图
含有空间位置地理坐标，能够与空间定位系统结合，准确引导人或交通工具从出发地到达目的地的电子地图或数据集。
［GB/T28442—2012.定义2.2]
中间件middleware
种类型的软件模块，它处在系统软件和应用软件之间，依赖系统软件的支持，又为应用软件提供支持，以方便应用软件的开发。[GB/T11457—2006，定义2.954］3.3
导航电子地图应用开发中间件middlewarefordevelopingnavigationelectronicmapapplication一种位于导航电子地图数据和导航应用软件之间，为各类导航电子地图数据提供统一的接入方式，为导航应用程序的开发提供开发环境与标准接口的中间件。3.4
服务器端中间件
server-sidemiddleware
运行于服务器设备之上的导航电子地图中间件，提供地图发布、路线规划等服务开发接口，供客户GB/T39584—2020
端应用程序或客户端中间件调用3.5
客户端中间件
client-sidemiddleware
运行于客户端设备之上的导航电子地图中间件，提供地图染、路线规划、定位及导航等本地程序开发接口，供客户端应用程序调用。3.6
公共数据
commondata
可由两个或多个非嵌套的计算机程序模型非显式地作为参数在模块之间传送而能访间的数据［GB/T11457—2006，定义242]
4缩略语
下列缩略语适用于本文件。
DCT：离散余弦变换（DiscreteCosineTransform）EPSG：欧洲石油勘探组织（EuropeanPetroleumSurveyGroup）GNSS：全球导航卫星系统（GlobalNavigationSatelliteSystem）HTTP：超文本传输协议（HyperTextTransferProtocol）IDL：接口描述语言（InterfaceDescriptionLanguage）JPEG：有损压缩图像格式（JointPhotographicExpertsGroupFormat）JSON：脚本语言JavaScript的对象表示法（JavaScriptObjectNotation）LZW：串表压缩算法（Lempel-Ziv-WelchEncoding）PNG：可移植的网络图像格式（PortableNetworkGraphicFormat）POI兴趣点(Pointof Interest)
REST：表述性状态转移（RepresentationalStateTransfer）TMC：交通信息频道（TrafficMessageChannel）TTS：文本转换为语音（TextToSpeech）URI.统一资源标识符（UniformResourceIdentifier）WFS：网络要素服务（WebFeatureServices）WMS：网络地图服务（WebMapServices）XML：可扩展标记语言（eXtensibleMarkupLanguage）5接口类型和基本描述
5.1概述
导航电子地图应用开发中间件包含服务器端中间件和客户端中间件两类，服务器端中间件运行于服务器操作系统之上，以HTTP协议提供应用开发接口，供客户端中间件或客户端应用程序调用。
客户端中间件运行于客户端操作系统之上，以本地调用方式提供应用开发接口，供客户端应用程序调用。
接口结构
地图数据、中间件、中间件接口和应用程序之间的关系如图1所示。2
客户端中问件
《接口》》
客户端中间件接口
客竭地图数册
导航应用程序
<<接口>>
服务翠端中间件接口
服务器端地图数据
导航电子地图应用开发中间件接口结构图图1
GB/T39584—2020
服务器端中问件
服务器端地图数据存储于服务器设备上，数据包含背景地图数据、检索数据、道路数据、引导数据、实时交通数据、地址匹配数据等。客户端应用程序或客户端中间件通过服务器端中间件接口，以在线的方式访问服务器端地图数据。
客户端地图数据存储于客户端设备上，以离线方式存储于客户端设备本地，数据包含背景地图数据、检索数据、道路数据、引导数据等。客户端应用程序通过客户端中间件接口，以离线方式访问客户端地图数据。
5.3接口分类
服务器端中间件接口功能
服务器端中间件接口功能见表1
服务器端中间件接口功能
接口分类
地图服务接口
空间数据服务接口
空间分析服务接口
信息查询服务接口
路径规划服务接口
用户管理服务接口
地址匹配服务
元数据服务接口
动态交通服务接口
室内定位与导航接口
第三方数据融合服务接口
扩展服务接口
功能描述
对地图和图层进行访问与操作的接口对空间数据进行访问与操作的接口对数据集、几何对象进行空间分析的接口对空间数据进行查询的接口
构成连接起点位置和终点位置的序列点或曲线的策略服务接口中间件连接用户管理的接口
地址信息匹配到相应的地理位置的接口所有获取服务的列表和元信息的接口获取道路状况信息的接口
室内定位与路径计算相关的接口第三方数据融合相关的服务接口用于新增扩展服务的接口
GB/T39584—2020
5.3.2客户端中间件接口功能
客户端中间件接口功能见表2。
接口分类
事件监听对象接口
地图染接口
自定义标绘接口
信息查询接口
路径规划接口
路径引导接口
空间分析接口
动态交通信息接口
语音播报接口
室内导航接口
系统工具
扩展接口
接口协议
服务器端中间件接口协议
REST协议
表2客户端中间件接口功能
功能描述
中间件回调事件的接口，以消息驱动形式控制整个导航过程导航电子地图染、控制相关的接口用户自定义标绘相关的接口
首拼、关键字、周边等信息搜索相关的接口路径规划及结果信息获取相关的接口路径引导相关的接口
缓冲区分析、叠加分析相关的空间分析接口实时交通获取、显示相关的接口语音合成功能相关的接口
室内定位、POI检索、室内路线规划与引导等相关的接口各个接口涉及的系统工具类
用于新增扩展服务的接口
接口应遵循REST软件协议，应基于标准HTTP网络传输协议，HTTP版本应为1.1及以上。接口应通过URI进行唯一标识，应使用HTTP协议的标准方法实现对接口的操作。5.4.1.2
请求格式
HTTP请求应以URI查询参数或请求体参数的方式进行参数传递。其中，只有POST和PUT请求既支持URI查询参数，也支持请求体参数，其他HTTP请求只支持URI查询参数。URI查询参数应位于URI中绝对路径的后面，以“?”开头，形式应为“参数名=参数值”，各个参数之间应用“&”符号分割，不分先后顺序。请求体参数组织格式应与URI查询参数一致。HTTP请求见示例。
示例：http：//IP：PORT/CTX/services/components-rest/rest/sample.json?A=value_a&B=value_b，其中，A、B为参数名，对应的参数值分别为value_a、value_b。5.4.1.3
响应格式
对接口HTTP请求做出响应，获得资源或操作结果的表述。表述应支持XML和JSON两种格式，XML格式见示例1，JSON格式见示例2，常用缩码，应遵循附录A的相关要求。对于图片资源应支持PNGJPEG等特有的表述格式
示例1：
(ChildResource)
《name）世界地图(path>http://IP:PORT/CTX/services/map-world/rest/maps/%E4%B8%96%E7%95%8C%E5%9C%B0%E5%9B%BE(/path)
(supportedMediaTypes）
(string)application/xml(/string)(string)text/xml(string)application/json《string)application/jsonp(/string）application/x-java-serialized-object(/string)(string)application/ajax(/string)(string)application/kmlapplication/ijsapplication/javascriptapplication/html5示例2：
\resourceConfigID\:\map\,\name\；\城市地图\
\path\：\http://IP:PORT/CTX/services/map-changchun/rest/maps/%E9%95%BF%E6%98%A5%E5%B8%82%E5%8C%BA%E5%9B%BE\\supportedMediaTypes\:
\application/xml\,
\text/xml\,
\application/json\,
\application/rjson\,
\text/html\.
\application/jsonp\
\application/xjava serialized-object\,\application/ajax\,
GB/T39584—2020
\application/kml\
\application/ifx\,
\application/flex\,
\application/isl\,
\application/silverlight\，\application/ijs\
\application/javascript\
\application/html5\
\application/sme\,
\application/supermapcloud”J.
\resourceType\：\StaticResource\1
参数格式
参数类型，应遵循附录B相关要求，请求参数格式见表3。响应参数格式见表4。表3
服务器端中间件接口请求参数格式项目
参数性质
父元素名称
子元素名称
客户端中间件接口协议
本地调用方式
请求参数名称
请求参数类型
是否必填
请求参数所遵循的要求和描述性说明4服务器端中间件接口响应参数格式表4
响应参数序号、根据参数类型层次说明响应参数父元素名称
响应参数子元素名称
元素的约束条件，见A.1
响应参数的数据类型
响应参数的允许长度
响应参数所遵循的要求和描述性说明客户端应用程序采用本地类库调用的方式调用客户端中间件接口，客户端中间件接口规范遵循本地调用方式规范，参数及返回值类型，应遵循附录C相关要求6
接口命名规范
GB/T39584—2020
接口名称应具有与接口功能相对应的含义，应采用描述接口功能的单词表示，单词应采用小写字母。若接口名称由至少两个单词组成，则除第一个单词以外，其余单词的首字母宜大写。接口命名见示例。
示例：void setLayerlnfoinLayerlnfo layerlnfo)。3参数定义规范
接口参数是可选项，应根据接口功能确定是否需要参数。若存在参数，则参数说明见表5表5客户端中间件接口参数说明
接口参数项目
返回值定义规范
接口参数名称
接口参数类型
接口参数所遵循的要求和描述性说明parameters
Parameter(sequence)
模块初始化参数，见C.1
接口返回值应为可选项，应根据接口功能确定是否需要返回值。若存在返回值，则应指明返回值类型、取值及其表示的含义。
返回值规范见示例。
示例：返回值类型为boolean.取值为true或false，表示添加成功或添加失败服务器端中间件接口
6.1公共数据类型
服务器端中间件接口的公共数据类型见附录B。6.2地图服务接口
功能描述
提供地图相关资源，并可以对地图进行访问与操作，一般应包括以下功能：a）
获取地图列表，包括服务器上地图的名称、URI、资源类型等：b）
获取地图图片：
获取地图的格网图片；
获取某幅地图的图层集合；
获取某个图层的信息；
获取地图当前状态的基本信息，包括该地图的中心点、比例尺、地图显示范围、图片大小、地图f
单位、距离度量单位等
地图服务接口包括地图集合接口、地图接口、图像接口、图像瓦片接口、图层集合接口和图层接口。t
GB/T39584—2020
6.2.2地图集合接口
6.2.2.1概述
地图集合接口用干获取服务器上提供的所有地图集合信息，包括地图的名称、地图资源访问路径资源配置项ID、资源类型等。
接口定义
(root_uri>/maps[.支持方式HTTPGET。
注：请求参数见表6。
表6地图集合接口请求参数
接口响应结构
响应结构见表7
父元素名称
ChildResource
ChildResource
ChildResource
ChildResource
ChildResource
地图接口
6.2.3.1概述
string
参数性质
地图集合接口响应结构
子元素名称
ChildResource
resourceConfigID
resourceType
supportedMediaTypes
string
string
string
string
string]
用户密钥
地图资源列表
地图的名称
地图资源的访问路径
资源配置项ID
资源类型，见B.16
支持的媒体表述类型
地图接口是对地图进行操作的人口，用于获取该地图当前状态的基本信息，包括中心点、比例尺、地图显示范围、图片大小、地图单位、距离度量单位、包含的图层、包含的图片等，并可以对该地图进行修改或删除创建一个临时图层集，或创建一幅新地图6.2.3.2接口定义
(maps_uri)/(mapName)[.(format)]8
小提示：此标准内容仅展示完整标准里的部分截取内容，若需要完整标准请到上方自行免费下载完整标准文档。