ICS49.020 V04 中华人民共和国国家标准 GB/T39584—2020 导航电子地图应用开发中间件接口规范 Programming interface specification of middleware for developing navigation electronic mapapplication 2020-12-14发布 2021-07-01实施 国家市场监督管理总局 发布 国家标准化管理委员会 GB/T 39584—2020 目 次 前言 1 范围 2 规范性引用文件 3术语和定义 4 缩略语 5 接口类型和基本描述 5.1 概述 5.2 接口结构 5.3 接口分类 5.4 接口协议 6 服务器端中间件接口 6.1 公共数据类型 6.2 地图服务接口 6.3 空间数据服务接口 17 6.4 空间分析服务接口 37 6.5 信息查询服务接口· 44 6.6 路径规划服务接口· 47 6.7 用户服务接口 49 6.8 地址匹配服务接口 50 6.9 元数据服务接口 53 6.10 动态交通服务接口 54 6.11 室内定位与导航服务接口 58 6.12 第三方数据融合服务接口 62 6.13 扩展服务接口 7 客户端中间件接口 64 7.1 公共数据类型 7.2 地图显示接口 64 7.3 自定义标绘接口 73 7.4 信息查询接口 84 7.5 路线规划接口 95 7.6 路线引导接口 100 7.7 空间分析接口 109 7.8 动态交通信息接口 113 7.9 语音接口 117 7.10 事件监听对象接口 121 7.11 室内导航接口 127 1 GB/T39584—2020 7.12 系统工具接口 7.13扩展接口 133 接口验证 133 8.1 数据服务接口验证 133 8.2 数据加载验证 133 8.3 信息检索验证 133 8.4 路线规划验证 133 8.5 语音导航验证 133 8.6空间分析验证 134 附录A（规范性附录） 常用编码表 135 附录B（规范性附录） 服务器端中间件接口公共数据类型 144 附录C（规范性附录） 客户端中间件接口公共数据类型 151 附录D（规范性附录） 错误码 158 GB/T39584—2020 前言 本标准按照GB/T1.1—2009给出的规则起草 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。 本标准由中国卫星导航系统管理办公室提出。 本标准由全国北斗卫星导航标准化技术委员会（SAC/TC544)归口。 本标准起草单位：北京超图软件股份有限公司、中国卫星导航工程中心、中国航天标准化研究所、三 六零科技集团有限公司、北京智慧图科技有限责任公司、北京航天宏图信息技术股份有限公司 本标准主要起草人：钟耳顺、李少杰、刘莹、蔡文文、刘庆军、曹玉尧、马海波、杨海燕、饶庆云、张绍瑞 张楠、王维嘉 GB/T39584—2020 导航电子地图应用开发中间件接口规范 1范围 本标准规定了导航电子地图应用开发中间件的接口结构、接口分类、接口定义、接口协议及接口 验证。 本标准适用于导航电子地图应用开发中间件接口的设计与开发，也适用于导航应用软件对中间件 接口的调用。 2规范性引用文件 下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文 件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件 GB/T920公路路面等级与面层类型代码 GB/T2260中华人民共和国行政区划代码 GB/T11457—2006信息技术软件工程术语 GB/T17694地理信息术语 GB/T193922013车载卫星导航设备通用规范 GB/T28442一2012导航电子地图数据分类与编码 GB/T30320地理空间数据库访问接口 3术语和定义 GB/T11457—2006、GB/T17694、GB/T30320界定的以及下列术语和定义适用于本文件。 3.1 导航电子地图navigationelectronicmap 含有空间位置地理坐标，能够与空间定位系统结合，准确引导人或交通工具从出发地到达目的地的 电子地图或数据集。 [GB/T28442—2012，定义2.2] 3.2 中间件middleware 种类型的软件模块，它处在系统软件和应用软件之间，依赖系统软件的支持，又为应用软件提供 支持，以方便应用软件的开发。 [GB/T11457—2006，定义2.954] 3.3 导航电子地图应用开发中间件middlewarefordevelopingnavigationelectronicmapapplication 种位于导航电子地图数据和导航应用软件之间，为各类导航电子地图数据提供统一的接人方式， 为导航应用程序的开发提供开发环境与标准接口的中间件。 3.4 服务器端中间件 server-sidemiddleware 运行于服务器设备之上的导航电子地图中间件，提供地图发布、路线规划等服务开发接口，供客户 1 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：表述性状态转移（Representational StateTransfer) TMC：交通信息频道（TrafficMessageChannel) TTS：文本转换为语音（TextToSpeech） URI：统一资源标识符（UniformResourceIdentifier） WFS：网络要素服务（WebFeatureServices） WMS：网络地图服务（WebMapServices） XML：可扩展标记语言（eXtensibleMarkupLanguage） 5接口类型和基本描述 5.1概述 导航电子地图应用开发中间件包含服务器端中间件和客户端中间件两类。 服务器端中间件运行于服务器操作系统之上，以HTTP协议提供应用开发接口，供客户端中间件 或客户端应用程序调用。 客户端中间件运行于客户端操作系统之上，以本地调用方式提供应用开发接口，供客户端应用程序 调用。 5.2 接口结构 地图数据、中间件、中间件接口和应用程序之间的关系如图1所示。 2 GB/T39584—2020 导航应用程序 V <接口>》> <<接口>> 客户端中间件 服务器端中间件 客户端中间件接口 服务器端中间件接口 V 客户端地图数据 服务器端地图数据 图1导航电子地图应用开发中间件接口结构图 服务器端地图数据存储于服务器设备上，数据包含背景地图数据、检索数据、道路数据、引导数据 实时交通数据、地址匹配数据等。客户端应用程序或客户端中间件通过服务器端中间件接口，以在线的 方式访问服务器端地图数据。 客户端地图数据存储于客户端设备上，以离线方式存储于客户端设备本地，数据包含背景地图数 据、检索数据、道路数据、引导数据等。客户端应用程序通过客户端中间件接口，以离线方式访问客户端 地图数据。 5.3接口分类 5.3.1 服务器端中间件接口功能 服务器端中间件接口功能见表1。 表1服务器端中间件接口功能 序号 接口分类 功能描述 地图服务接口 对地图和图层进行访问与操作的接口 空间数据服务接口 2 对空间数据进行访问与操作的接口 空间分析服务接口 3 对数据集、几何对象进行空间分析的接口 信息查询服务接口 4 对空间数据进行查询的接口 5 路径规划服务接口 构成连接起点位置和终点位置的序列点或曲线的策略服务接口 6 用户管理服务接口 中间件连接用户管理的接口 7 地址匹配服务 地址信息匹配到相应的地理位置的接口 8 元数据服务接口 所有获取服务的列表和元信息的接口 动态交通服务接口 9 获取道路状况信息的接口 10 室内定位与导航接口 室内定位与路径计算相关的接口 11 第三方数据融合服务接口 第三方数据融合相关的服务接口 12 扩展服务接口 用于新增扩展服务的接口 3