导航电子地图应用开发中间件接口规范

导航电子地图应用开发中间件接口规范

国家标准 GB/T39584一2020 导航电子地图应用开发中间件接口规范 speeifieationofmiddlewareforlevelopingnavigation interfaces Programmimg eleetroniemapapplieatiom 2020-12-14发布 2021-07-01实施 国家市场监督管理总局 发布 国家标涯花警理委员会国家标准
GB/39584一2020 目 次 前言 范围 规范性引用文件 2 术语和定义 3 缩略语 接口类型和基本描述 5.l概述 5.2接口结构 5.3接口分类 5.4接口协议 服务器端中间件接口 6.1公共数据类型 6.2地图服务接口 17 6.3空间数据服务接口 37 6.4空间分析服务接口 6.5信息查询服务接口 44 6.6路径规划服务接口 47 6.7用户服务接口 49 6.8地址匹配服务接口 50 6.9元数据服务接口 5S8 6.10动态交通服务接口 54 6.11室内定位与导航服务接口 58 6.12 第 三方数据融合服务接口 62 6.13扩展服务接口 64 客户端中间件接口 64 .1公共数据类型 64 72 地图显示接口 64 7.3 73 自定义标绘接口 7.4 信息查询接口 84 75 95 路线规划接口 7.6 100 路线引导接口 77 空间分析接口 109 7.8 动态交通信息接口 113 7.9语音接口 117 7.10事件监听对象接口 121 127 7.11室内导航接口
GB/T39584一2020 7.12系统工具接口 131 7.13扩展接口 133 8 接口验证 133 8.1数据服务接口验证 133 133 8.2数据加载验证 13 8.3信息检索验证 133 8.4路线规划验证 13 8.5语音导航验证 134 8.6空间分析验证 附录A规范性附录常用编码表 135 144 附录B(规范性附录服务器端中间件接口公共数据类型 151 附录C规范性附录)客户端中间件接口公共数据类型 158 附录D规范性附录错误码
GB/39584一2020 前 言 本标准按照GB/T1.1一2009给出的规则起草 请注意本文件的某些内容可能涉及专利 本文件的发布机构不承担识别这些专利的责任 本标准由卫星导航系统管理办公室提出 本标准由全国北斗卫星导航标准化技术委员会(SAC/TC544)归口 本标准起草单位:北京超图软件股份有限公司、卫星导航工程中心、航天标准化研究所、三 六零科技集团有限公司、北京智慧图科技有限责任公司,北京航天宏图信息技术股份有限公司 本标准主要起草人钟耳顺、李少杰、刘莹、蔡文文、刘庆军、曹玉尧、马海波、杨海燕、饶庆云、张绍瑞、 张楠、王维嘉
GB/39584一2020 导航电子地图应用开发中间件接口规范 范围 本标准规定了导航电子地图应用开发中间件的接口结构、接口分类、接口定义、接口协议及接口 验证 本标准适用于导航电子地图应用开发中间件接口的设计与开发,也适用于导航应用软件对中间件 接口的调用 规范性引用文件 下列文件对于本文件的应用是必不可少的 凡是注日期的引用文件,仅注日期的版本适用于本文 件 凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件 GB/T920公路路面等级与面层类型代码 行政区划代码 GB/T2260 信息技术软件工程术语 GB/T11457一2006 GB/T17694地理信息术语 GB/T193922013车载卫星导航设备通用规范 GB/T28442一2012导航电子地图数据分类与编码 GB/T30320地理空间数据库访问接口 术语和定义 GB/T11457一2006,GB/T17694,GB/T30320界定的以及下列术语和定义适用于本文件 3.1 导航电子地图navigationeleetromiemap 含有空间位置地理坐标,能够与空间定位系统结合,准确引导人或交通工具从出发地到达目的地的 电子地图或数据集 [GB/T28442一2012,定义2.2 3.2 中间件middleware -种类型的软件模块,它处在系统软件和应用软件之间,依赖系统软件的支持,又为应用软件提供 支持,以方便应用软件的开发 [GB/T11457一2006,定义2.954] 3.3 导航电子地图应用开发中间件nmiddlewarefordeveopingnavigationelectroniemapapplicatiom -种位于导航电子地图数据和导航应用软件之间,为各类导航电子地图数据提供统一的接人方式 为导航应用程序的开发提供开发环境与标准接口的中间件 3.4 服务器端中间件 -sidemidaleware server 运行于服务器设备之上的导航电子地图中间件,提供地图发布、路线规划等服务开发接口,供客户
GB/T39584一2020 端应用程序或客户端中间件调用 3.5 客户端中间件elient-sidemiddleware 运行于客户端设备之上的导航电子地图中间件,提供地图渲染、路线规划、定位及导航等本地程序 开发接口,供客户端应用程序调用 3.6 commodata 公共数据 可由两个或多个非嵌套的计算机程序模型非显式地作为参数在模块之间传送而能访问的数据 [GB/T11457一2006,定义242] 缩略语 下列缩略语适用于本文件 DCT:离散余弦变换(DiscreteCosineTransform EPSG:欧洲石油勘探组织(EuropeanPetroleumSurveyGroup) GNSS;全球导航卫星系统(GlobalNavigationSatelliteSystem) HHT'TP;超文本传输协议HyperTextTransferProtocol IDL:接口描述语言(InterfaceDescriptionLanguage JPEG:有损压缩图像格式(JointPhotographicExpertsGroupFormat JSON;脚本语言JavaSeript的对象表示法(JavaSeriptObjeetNotation IZW:串表压缩算法(lempel-Ziv-WelchEncoding PNG;可移植的网络图像格式(PortableNetworkGraphicFormat) P(OI:兴趣点PointofInterest REST:表述性状态转移(RepresentationalStateTransfer TMC;交通信息频道(TraffcMessageChanneD TTs;文本转换为语音(TextToSpeech URI;统一资源标识符(UniformResourceldentifier) wFs.网络要素服务(webFeatureServices) wMS;网络地图服务(webMapServices7 XML可扩展标记语言(eXtensibleMarkupl.anguage) S 接口类型和基本描述 5.1概述 导航电子地图应用开发中间件包含服务器端中间件和客户端中间件两类 服务器端中间件运行于服务器操作系统之上,以HTTP协议提供应用开发接口,供客户端中间件 或客户端应用程序调用 客户端中间件运行于客户端操作系统之上,以本地调用方式提供应用开发接口,供客户端应用程序 调用 5.2接口结构 地图数据、中间件、中间件接口和应用程序之间的关系如图1所示
GB/39584一2020 导航应用程序 <接口> <接口>7 1n ln 客户耀中间件 服务器端中间件 客户端中间件接口 服务器端中间件接口 客户端地图数据 服务器端地图数据 导航电子地图应用开发中间件接口结构图 服务器端地图数据存储于服务器设备上,数据包含背景地图数据、检索数据、道路数据、引导数据、 实时交通数据,地址匹配数据等 客户端应用程序或客户端中间件通过服务器端中间件接口,以在线的 方式访问服务器端地图数据 客户端地图数据存储于客户端设备上,以离线方式存储于客户端设备本地,数据包含背景地图数 据、检索数据、道路数据、引导数据等 客户端应用程序通过客户端中间件接口,以离线方式访问客户端 地图数据 5.3接口分类 5.3.1服务器端中间件接口功能 服务器端中间件接口功能见表l1 表1服务器端中间件接口功能 序号 接口分类 功能描述 地图服务接口 对地图和图层进行访间与操作的接口 空间数据服务接口 对空间数据进行访问与操作的接口 空间分析服务接口 对数据集、几何对象进行空间分析的接口 信息查询服务接口 对空间数据进行查询的接口 路径规划服务接口 构成连接起点位置和终点位置的序列点或曲线的策略服务接口 用户管理服务接口 中间件连接用户管理的接口 地址匹配服务 地址信息匹配到相应的地理位置的接口 元数据服务接口 所有获取服务的列表和元信息的接口 动态交通服务接口 获取道路状况信息的接口 1c 室内定位与导航接口 室内定位与路径计算相关的接口 1 第三方数据融合服务接口 第三方数据融合相关的服务接口 12 扩展服务接口 用于新增扩展服务的接口
GB/T39584一2020 5.3.2客户端中间件接口功能 客户端中间件接口功能见表2. 表2客户端中间件接口功能 序号 接口分类 功能描述 事件监听对象接口 中间件回调事件的接口,以消息驱动形式控制整个导航过程 地图渲染接口 导航电子地图渲染、控制相关的接口 自定义标绘接口 用户自定义标绘相关的接口 信息查询接口 首拼,关键字,周边等信息搜索相关的接口 路径规划接口 路径规划及结果信息获取相关的接口 路径引导接口 路径引导相关的接口 空间分析接口 缓冲区分析、叠加分析相关的空间分析接口 动态交通信息接口 实时交通获取、显示相关的接口 语音播报接口 语音合成功能相关的接口 1o 室内导航接口 室内定位.Po检索,室内路线规划与引导等相关的接口 11 系统工具 各个接口涉及的系统工具类 12 扩展接口 用于新增扩展服务的接口 5.4接口协议 5.4.1服务器端中间件接口协议 5.4.1.1ES！协议 接口应遵循REST软件协议,应基于标准HTTP网络传输协议,HTTP版本应为1.1及以上 接 口应通过URI进行唯一标识,应使用HTTP协议的标准方法实现对接口的操作 5.4.1.2请求格式 HTTP请求应以URI查询参数或请求体参数的方式进行参数传递 其中,只有POsT和PUT请 求既支持UR1查询参数,也支持请求体参数,其他HTTP请求只支持URI查询参数 URI查询参数 应位于URI中绝对路径的后面,以“?”开头,形式应为“参数名一参数值”,各个参数之间应用“&”符号 分割,不分先后顺序 请求体参数组织格式应与URI查询参数一致 HTTP请求见示例 示例:http://IP:PORT/CTX/services/components-rest/rest/sample.json?A=value-_a&.B一 alue_b,其中,A,B为参数名对应的参数值分别为value-a,value_b. 5.4.1.3响应格式 对接口HTTP请求做出响应,获得资源或操作结果的表述 表述应支持XMI和JsON两种格 式,XML格式见示例1,JsON格式见示例2,常用编码,应遵循附录A的相关要求 对于图片资源应支 持PNGJPEG等特有的表述格式
GB/39584一2020 示例1 ?xmlversion="l.0"encoding="UTF-8”standalone="no"? Ilist (ChildResource name>世界地图http:/ 9B%BE(/path supportedlMediaTypes) string)applieation/xml(/string string>text/xml/string tring)applieation/jsonGB/T39584一2020 "applieation/kml" "applieation/ifx application/flex applieation/isl "application/silverlight application/is" applieation/javascrip" ieation/html5” 2aOO application/smc applieation/supermapcloud" "StatieResource" resourceType" 5.4.1.4参数格式 参数类型,应遵循附录B相关要求,请求参数格式见表3 响应参数格式见表4 表3服务器端中间件接口请求参数格式 项目 描述 名称 请求参数名称 类型 请求参数类型 参数性质 是香必填 说明 请求参数所遵循的要求和描述性说明 表4服务器端中间件接口响应参数格式 项目 描述 序号 响应参数序号,根据参数类型层次说明 父元素名称 响应参数父元素名称 子元素名称 响应参数子元素名称 约束 元素的约束条件,见A.1 响应参数的数据类型 类型 长度 响应参数的允许长度 响应参数所遵循的要求和描述性说明 说明 5.4.2客户端中间件接口协议 5.4.2.1本地调用方式 客户端应用程序采用本地类库调用的方式调用客户端中间件接口,客户端中间件接口规范遵循本 地调用方式规范,参数及返回值类型,应遵循附录C相关要求
GB/39584一2020 5.4.2.2接口命名规范 接口名称应具有与接口功能相对应的含义,应采用描述接口功能的单词表示,单词应采用小写字 母 若接口名称由至少两个单词组成,则除第一个单词以外,其余单词的首字母宜大写 接口命名见示例 示例:vodsetlLayerlnfo(inl.ayerlnfolayerlnfo). 5.4.2.3参数定义规范 接口参数是可选项,应根据接口功能确定是否需要参数 若存在参数,则参数说明见表5 表5客户端中间件接口参数说明 示例 接口参数项目 描述 名称 接口参数名称 parameters 类型 接口参数类型 Parameter(sequence 说明 接口参数所遵循的要求和描述性说明 模块初始化参数,见c. 5.4.2.4返回值定义规范 接口返回值应为可选项,应根据接口功能确定是否需要返回值 若存在返回值,则应指明返回值类 型、取值及其表示的含义 返回值规范见示例 示例;返回值类型为boolean,取值为true或alse,表示添加成功或添加失败 服务器端中间件接口 6.1公共数据类型 服务器端中间件接口的公共数据类型见附录B 6.2地图服务接口 6.2.1功能描述 提供地图相关资源,并可以对地图进行访问与操作,一般应包括以下功能 获取地图列表,包括服务器上地图的名称、URI、资源类型等 a b 获取地图图片 获取地图的格网图片" c d 获取某幅地图的图层集合; e 获取某个图层的信息; 获取地图当前状态的基本信息,包括该地图的中心点、比例尺、地图显示范围、图片大小,地图 单位、,距离度量单位等 地图服务接口包括地图集合接口,地图接口,图像接口,图像瓦片接口,图层集合接口和图层接口.
GB/T39584一2020 6.2.2地图集合接口 6.2.2.1 概述 地图集合接口用于获取服务器上提供的所有地图集合信息,包括地图的名称,地图资源访问路径、 资源配置项ID资源类型等 6.2.2.2接口定义 root_uri>/maps[.(format) 支持方式HTTPGET 注;format>为响应格式,如;maps,json或maps.xml 6.2.2.3接口参数说明 请求参数见表6 表6地图集合接口请求参数 名称 类型 参数性质 说明 必填 用户密钥 key string 6.2.2.4接口响应结构 响应结构见表7 表7地图集合接口响应结构 序号 父元素名称 子元素名称 约束 类型 长度 说明 地图资源列表 list ChildResource 1.1 ChildResource name string 地图的名称 地图资鄙的访问路径 1.2 ChildResource path string resourceConfigID string l.3 ChildResource 资源配置项ID l.4 ChildResource resourceType string 资源类型,见B.16 1.5 ChildResource supportedMediaTypes string[ 支持的媒体表述类型 6.2.3地图接口 6.2.3.1 概述 地图接口是对地图进行操作的人口,用于获取该地图当前状态的基本信息,包括中心点,比例尺、地 图显示范围、图片大小,地图单位、距离度量单位、包含的图层包含的图片等,并可以对该地图进行修改 或删除,创建一个临时图层集,或创建一幅新地图 6.2.3.2 接口定义 map_uri)/mapNamel[(ormat7
GB/39584一2020 maps_uri)/maplndex[.GB/T39584一2020 表9续) 类型 长度 说明 序号 父元素名称 子元索名称 约束 地图显示裁剪的区域是否有效 1.l3ChildResource clipRegionEnabled boolean 1.l4ChildResource customEntireBounds Rectangle2D 自定义的地图全幅显示范围 自定义的地图全幅显示范围是 1.15ChildResource customEntireBoundsEnabled boolean 否有效 1.16ChildResource double 当前地图的旋转角度 angle 1.17 antialias ChildResource boolean 地图是否光滑显示 1.18ChildResource backgroundStyle Style 地图的背景风格 地图的坐标单位 coordUnit .19ChildResouree Unit 1.20ChildResource distanceUni Unit 地图的距离量度单位 1.21 ChildResource description 当前地图的描述信息 string l.22 ChildResouree dynamicProjeetion boolean 是否允许地图动态投影显示 1.23ChildResource markerAngleFixed 指定点状符号的角度是否固定 b0olean 文本最大可见尺寸,单位为像素 .24 ChildResource maxVisibleTextSize double 1l.25ChildResouree minVisibleTextSize double 文本最小可见尺寸,单位为像素 最大几何对象可见节点数,若超 1.26ChildResource maxVisibleVertex ong 过指定数值,则几何对象不显示 1.27 ChildResource 重叠时是否显示对象 boolean overlapDisplayed 是否绘制地图背景 1.28ChildResouree paintBackground boolean 1.29ChildResource extAngleFixed 文本角度是否固定 boolean CildResource text(OrientationFixed boolean 文本朝向是否固定 1.30 6.2.4图像接口 6.2.4.1 概述 图像接口用于获取地图中的一幅地图图片 6.2.4.2接口定义 map_un)/imagE[L(ormat7 支持方式HTTPGET 6.2.4.3接口参数说明 请求参数见表10. 10
GB/39584一2020 表10图像接口请求参数 名称 类型 参数性质 说明 string 必填 用户密钥 key 是否重定向,true表示将请求重定向到图片的真实地址,false表示响应体中是 选填 redirect boolean 图片的字节流,不进行重定向,默认值为false Point2D 必填 指定地图显示的中心点,见B,6 center sscale double 必填 指定地图显示的比例尺 选填 指定的显示视窗宽度(产生图片宽度),应与height一起使用,默认值为256 width long 选填 指定的显示视窗高度(产生图片高度),应与width一起使用,默认值为256 height long transparent 选填 地图图片是否透明,true表示透明,alse表示不透明,默认值为false boolean 6.2.4.4接口响应结构 响应结构见表11 其中,地图参数见表12,地图颜色模式见表13,校验方式见表14,图片返回格式 见表15 表11图像接口响应结构 序号 父元素名称 子元素名称 约束 类型 长度 说明 isr ChilaResource 图像列表 指向地图图片的UR1 .l ChildResource mageUrl string MapPa 地图参数,描述地图特征，见 ChildResource mapParam ,2 表12 rameter 表12地图参数 名称 类型 说明 angle 当前地图的旋转角度 double antialias 地图是否光滑显示 boolean backgroundStvle Stle 地图的背景风格 Rectangle2D 地图的全幅范围,见B.8 bounds cacheEnabled 是否使用缓存 b0olean Point2D 地图二维中心点坐标,见B.,6 cente 地图显示裁剪的区域,见B.9 clipRegion Geometry 地图显示裁剪区域是否有效 boolean clipRegionEnabled ccolorMode MapColorMode 地图颜色模式,见表13 coordlUnir Unit 地图的坐标单位枚举,见B,4 customEntireBounds Reetangle2D 自定义的地图全幅显示范围,见B8 customEntireBoundsEnabled boolean 自定义的地图全幅显示范围是否有效 1
GB/T39584一2020 表12(续) 名称 类型 说明 eustomParams string 用户自定义参数 当前地图的描述信息 description string istanceUnit Unit 地图的距离量度单位枚举,见B.4 dynamieProjeetion boolean 是否允许地图动态投影显示 List(Layer 地图中所有图层列表 layers markerAngleFixed boolean 指定点状符号的角度是否固定 地图的最大显示比例尺 axScale double rmaxVisibleTextSize double 文本的最大可见尺寸,单位为毫米(Gn mm 最大的儿何对象可见节点数,若超过指定数值,则该儿 maxVisibleVertex int 何对象不显示 double 地图的最小显示比例尺 minScale nminVisibleTextSixe double 文本的最小可见尺寸,单位为毫米Gn mm 目标地图的名称 string overlapDisplayed boolean 地图对象在同一范围内时是否重叠显示,默认值为false oerlapDisplayedOptions地图压盖过滤显示.overlapDisplayed为falsee时有效 overlapDisplayedOptions 是否绘制地图背景 boolean paintBackgroundl PricCoordSys 地图投影系统,见B.l prijCoordSys rectifyType RectifyType 校验方式,见表14 rreturmlmage boolean 地图图片是否立即返回,即是否要求服务器生成图片 returnType ReturnType 图片返回格式,见表15 地图的显示比例尺 scale double boolean 文本角度是否固定 lextAngleFixed textOrientationFixedl boolean 文本朝向是否固定 viewBounds Reetangle2D 视窗对应的地图范围,见B.8 Rectangle 视窗,见B.7 VIewer 返回地图的可见比例尺数组 visibleSeales double口 boolean 返回是否使用固定比例尺来显示地倒 visibleSealesEnabled 表13地图颜色模式 枚举类型 说明 BLACK_WHITE_REVERSE 黑白反色模式 BL.ACKwHITE 黑白模式 默认彩色模式,对应32位增强真彩色模式 DEFAU1T GRAY 灰度模式 ONLY_BLACK_wHITE_REVERSE 黑白反色,其他颜色不变 12
GB/39584一2020 表14校验方式 枚举类型 说明 BYCENTERANDMAPSCALE 以中心点和比例尺为准 BYVIEwBOUNDS 以视图范围为准 表15图片返回格式 枚举类型 说明 BINARY 只返回二进制内容 BUFFEREDIMAGE 直接返回缓冲图片 DEFAU1T 默认返回格式,返回URL地址 FILEURI 只返回文件地址 URL 只返回URL 地址 6.2.5图像瓦片接口 6.2.5.1 概述 图像瓦片接口用于获取由完整的地图图片以像素为单位按相同大小切割成而成的格网图片 6.2.5.2接口定义 map_uri)/ileimage[.(format门 支持方式HTTPGET 6.2.5.3接口参数说明 请求参数见表16 注:参数确定了格网的位置等信息 表16图像瓦片接口请求参数 类型 名称 参数性质 说明 必填 用户密钥 key string 是否重定向,true表示将请求重定向到图片的真实地址,false表示响应体中是 redireet boolean 选填 图片的字节流,不进行重定向,默认值为alse int 必填 格网在地图中的列号,从左向右递增,地图最左上角的格网,列号为0 格网在地图中的行号,从上向下递增,地图最左上角的格网,行号为0 int 必填 sscale double 必填 地图比例尺,如0,0001表示比例尺为1:10000 格网宽度,单位为像素,默认值为256 width int 选填 height int 选填 格网高度,单位为像素,默认值为256 格网图片是否透明,默认值为false transparent boolean 选填 13
GB/T39584一2020 6.2.5.4接口响应结构 响应结构见表17 表17图像瓦片接口响应结构 序号 父元素名称 类型 子元素名称 约束 长度 说明 list ChildResource 图像瓦片列表 指向地图图片的UR1 1. ChildResource mageUrl string ChildResource 地图参数,描述地图特征,见表12 l.2 mapParam MapParameter 6.2.6图层集合接口 6.2.6.1 概述 图层集合接口用于获取地图中的所有图层信息 6.2.6.2接口定义 mapur>/Ayers[,(fomat门 支持方式HTTPGET 6.2.6.3接口参数说明 请求参数见表18 表18图层集合接口请求参数 说明 名称 类型 参数性质 必填 用户密 key string 6.2.6.4接口响应结构 响应结构见表19 表19图层集合接口响应结构 序号 父元素名称 子元素名称 约束 类型 长度 说明 ChildResource layers资源类表 Tist 图层名称,不区分大小写,在图 1.l ChildResouree name string 层所在地图中唯一标识此图层 1.2 ChildResource double 图层范围 bounds 图层标题,默认为图层名称 1.3 ChildResouree caption string 1.4 ChildResource 图层描述信息 description string 1.5 ChildResource queryable boolean 图层中的对象是否可被查询 14
GB/39584一2020 表19(续) 序号 子元素名称 父元素名称 约束 类型 长度 说明 图层是否可见,若否,其他属性 ChildResource visible l.6 b0olean 设置无效 ChildResource LayerType 图层类型,见B.14 type 子图层集 .8 ChildResource sublayers LayersColleetion 图层最大可见比例尺,不可为 l.9 ChildResource maxSeale double 负,若地图当前显示比例尺大于 该值,图层不显示,默认值为 0 图层最小可见比例尺,不可为 负,若地图当前显示比例尺小于 minScale .l0ChildResource double 该值,图层不显示,默认值为0 几何对象的最小可见大小,单位 ChildResource 1.1 minVisileGeometrvSize doule 为像素 .12ChidResource opaqueRate 图层不透明度,取值为0100 long 1.l3ChildResource symbolScalable boolean 图层符号大小是否随图缩放 图层符号缩放基准比例尺,仅在 1.14 ChildResource symbolScale symbolSealable取值为true时 b0olean 有效 6.2.7 图层接口 6.2.7.1 概述 图层接口用于通过图层名称或图层索引号来获得构成地图的一个具体的图层数据 6.2.7.2接口定义 (layers_uri>/(layerName[.(format) layers_uri)/layerlndex[.(format>1 layers_uri)/layerlndex}/sublayers/sublayerlndex)[.(format)门 支持方式HTTPGET 6.2.7.3接口参数说明 请求参数见表20. 表20图层接口请求参数 名称 类型 参数性质 说明 必填 用户密钥 key string 6.2.7.4接口响应结构 响应结构见表21 15
GB/T39584一2020 表21图层接口响应结构 序号 父元素名称 子元素名称 约束 类型 长度 说明 list ChildResource 图层列表 图层名称,不区分大小写,在图 ChildResource name l.l string 层所在地图中唯一标识此图层 1.2 ChildResource double 图层范围 bounds 图层标题,默认与name一致 l.3 ChildResource caption string ChildResource 图层描述信息 ,4 description string 1.5 ChildResouree queryable boolean 图层中对象是否可被查询 图层是否可见.若否,其他属性 ChildResource isible 1.6 b0olean 设置无效 1. ChildResouree Type LayerType 图层类型,见B.l4 ChildResource Layer口 子图层集 .8 subLayers 图层最大可见比例尺,不可为 负,若地图当前显示比例尺大于 1.9 CildResource maxScale double V 该值,则图层不显示,默认值为0 图层最小可见比例尺,不可为 .10 ChildResource minScale double 负,若地图当前显示比例尺小于 该值,则图层不显示,默认值为0 几何对象的最小可见大小,单位 .lm ChildResource minVisible(GeometrySize double 为像素 1.12ChildResource opaqueRate 图层不透明度,取值为0~100 long symboISealable boolean 图层的符号大小是否随图缩放 .l3ChildResource 图层符号缩放基准比例尺,仅在 .14 ChildResouree symbolScale double symbolScalable取值为true时 有效 图层显示过滤条件,在数据库属 性数据上进行过滤 如图层属 性数据库存在smid字段,若过滤 .15ChildResource displayFilter string 条件为smid>20,则属性 smmid 值大于20的几何对象将显示在 地图窗口,其余对象不显示 存储制图表达信息字段,使相应 几何对象在地图窗口中显示时 .l6ChildResouree representationField string 采用其他表现方式,原来的儿何 对象不再显示 1.17 ChildResource style Style 矢量图层风格 16
GB/39584一2020 6.3空间数据服务接口 6.3.1功能描述 提供空间数据资源及属性,并可以对空间数据进行访问与操作,一般应包括以下功能 获取服务器提供的所有数据源信息,包括数据源名称、数据源描述、引擎类型、投影信息坐标 a 单位、距离单位等; b 修改数据源信息,如数据源描述、坐标单位、距离单位等; 获取数据源中的数据集信息,包括数据集名称,类型、范围、投影信息等 c d 创建一个新的数据集,包括点,线、面数据集; 修改数据集信息,如数据集描述信息、字符集、投影坐标系等 删除数据集; 获取一个数据集中要素信息集合,包括数据集中要素的个数、要素对应的几何对象的类型、各 g 个要素的URI等信息; 对要素进行添加、,删除、修改操作; h 获取一个要素的信息,包括属性字段名称列表属性字段值列表和要素对应的几何对象 i 一个要素,包括属性信息和空间信息; 修改- k 删除一个要素; 获取字段信息集合; m添加一个字段,仅支持在空数据集中进行字段添加 D对数据源中的数据进行查询,获取符合条件的要素集合 注查询方式包括ID模式、几何对象的缓冲区模式、缓冲区加属性过滤器模式、空间查询模式、空间查询加属性过 滤器的模式.,.sQL模式等 空间数据服务接口包括数据接口、数据源集合接口、数据源接口、数据集集合接口、数据集接口,要 素集合接口,要素接口、字段集合接口和要素结果集合接口 6.3.2数据接口 6.3.2.1 概述 数据接口是数据查询和操作的人口,用于提供数据源集合和数据查询功能的信息 6.3.2.2接口定义 root_uri>/data[.〈format)7 支持方式HTTPGET 6.3.2.3接口参数说明 请求参数见表22 表22数据接口请求参数 名称 类型 参数性质 说明 必填 用户密钥 key string 17
GB/T39584一2020 6.3.2.4接口响应结构 响应结构见表23. 表23数据接口响应结构 序号 父元素名称 子元素名称 约束 长度 说明 类型 ist ChildResource 数据资源列表 v ChildResource 资源名称 l.1 name string 1.2 ChildResource path string 资源访问路径 ChildResource ResourceConfiglD V 1.3 资源配置项ID string 资源类型枚举,见B16 l.4 ChildResource resourceType string ChildResouree supportedMediaTypes string[口 1.5 支持的媒体类型集合 6.3.3数据源集合接口 6.3.3.1概述 数据源集合接口用于获取服务器上的所有数据源的信息 6.3.3.2接口定义 data_uri>/datasourees[.(format) 支持方式HTTPGET 6.3.3.3接口参数 请求参数见表24 表24数据源集合接口请求参数 名称 类型 参数性质 说明 string 用户密钥 key 必填 6.3.3.4接口响应结构 响应结构见表25 表25数据源集合接口响应结构 序号 父元素名称 子元素名称 约束 类型 长度 说明 list ChildResource 数据源集合资源列表 T childReouree 数据源名称列表 datasourceNames LisK(strine 1. 1.2 ChildResouree datasourceCount 数据源集合中数据源的数目 Int ChildResource childUrilist List(string l.3 数据源访问的URI列表 18
GB/39584一2020 6.3.4数据源接口 6.3.4.1概述 数据源接口用于获取和修改服务器上的一个具体的数据源信息,也用于获取该数据源所包含的数 据集列表 数据源接口可获取的数据源信息包括;数据源名称、数据源描述、引擎类型、距离单位、坐标单位、投 影信息等 数据源接口可修改的数据源信息包括:数据源描述、坐标单位、距离单位等 6.3.4.2接口定义 /index/datasourcelndex[.(format)门 datasources_uri)/datasourceName[.(format力 datasources_uri/datasourcelndex}[.format力 支持方式HTTPGET、PUT 6.3.4.3GET方式接口参数说明 GET方式用于获取数据源信息,以及数据源所包含的数据集列表,请求参数见表26 表26数据源接口GE方式请求参数 名称 类型 参数性质 说明 必填 用户密钥 key string 6.3.4.4GE方式接口响应结构 响应结构见表27 其中,数据源信息见表28,数据源引擎类型见表29 表27数据源接口GET方式响应结构 序号 父元素名称 子元素名称 约束 类型 长度 说明 ChildResource 数据源资源列表 ist datasourcelnfo ChildResource Datasourcelnfo 数据源信息,见表28 . 子资源,即数据集集合资源的 ChildResource childUriList List(string URI列表 表28数据源信息 类型 说明 参数 coordUnit Unit 坐标单位枚举,见B,4 数据源描述 description string 距离单位枚举,见B.4 distanceUnit Unit 19
GB/T39584一2020 表28(续) 参数 类型 说明 数据源引擎类型,该字段只读,见表29 engineType EngineType 数据源的别名,用于在工作空间中唯一标识数据源,该字段只读 string 投影信息,见B prjCoordSys PijCoordSys 表29数据源引擎类型 说明 枚举类型 DB2 DB2数据库引擎 谷歌地图引擎 GO(0GLEMAPS MAGEPLUGINs 影像只读引擎 ISERVERREST REST地图服务引擎,该引擎为只读引擎,且不能创建 KINGBASE Kingbase数据库引擎,不支持多波段数据 天地图服务引擎,该引擎为只读引擎,且不能创建 MAPwORLD OGc oGC引擎,针对web数据源 ORAcLEPLUs Oracle数据库引擎 ORACLESPATIAL Oracle空间数据库引擎 P(O)sTGREsQL rsQL数据库引整 PostgreS SQLPLUS sQLServer数据库引擎 UDB 文件型数据库引擎 6.3.4.5PU方式接口参数说明 PU方式用于修改数据源信息,请求参数见表30 表30数据源接口PUT方式请求参数 名称 类型 参数性质 说明 key 必填 用户密钥 string description string 必填 数据源描述 coordUnit Unit 必填 坐标单位,见B4 必填 距离单位,见B4 Unit distanceUnit 6.3.4.6PU方式接口响应结构 响应结构见表31 20
GB/39584一2020 表31数据源接口U方式响应结构 说明 序号 父元素名称 子元素名称 约刺 类型 长度 lis ChildResource datasourcee资源列表 ChildResource .1 succeed boolean 数据源信息修改是否成功 出错信息,见D,操作成功无本字段 .2 ChildResource error HttpError 6.3.5数据集集合接口 6.3.5.1概述 数据集集合接口用于创建一个隶属于当前数据源的数据集合,包括点、线、面数据集 6.3.5.2接口定义 datasource_uri>/datasets[.(format) 支持方式HTTPGET,POsT 6.3.5.3GET方式接口参数说明 GET方式用于获取数据源中的所有数据集的信息,请求参数见表32 表32数据集集合接口GET方式请求参数 名称 类型 参数性质 说明 必填 用户密钥 key string 6.3.5.4GET方式接口响应结构 响应结构见表33 表33数据集集合接口GET方式响应结构 序号 约束 类型 长度 说明 父元素名称 子元素名称 数据集集合资源列表 isr ChilaResouree ChildResource datasetCount 数据源中数据集个数 int ChildResource 数据集名称列表 .2 datasetsName List(string 数据集访问路径即数据集URI childUriList 1.3 CildResource List(string 资源)列表 6.3.5.5OST方式接口参数说明 POST方式用于创建一个新数据集,包含两种情况 第一种,通过设置数据集名称和数据集类型来 创建新数据集,请求参数见表34,数据集类型见表35 第二种,通过复制数据集的方式创建新数据集， 请求参数见表36 21
GB/T39584一2020 表34数据集集合接口OS方式请求参数(一) 名称 类型 参数性质 说明 key string 必填 用户密钥 必填 datasetName string 数据集名称 datasetType datasetType 必填 数据集类型,见表35 表35数据集类型 枚举类型 说明 CAD 复合数据集 线数据集 LINE POINT 点数据集 REEGION 面数据集 纯属性数据集 TABULAR TExT 文本数据集 表36数据集集合接口POsr方式请求参数(二 名称 类型 参数性质 说明 必填 用户密钥 key string srcDatasourceName 必填 源数据源名称 string 必填 源数据集名称 srcDatasetName string destDatasetName string 必填 要创建的目标数据集名称 6.3.5.6oST方式接口响应结构 响应结构见表37 数据集集合接口OST方式响应结构 表37 序号 父元素名称 子元素名称 约束 类型 长度 说明 ChildResource list 数据集集合资源列表 1.1 ChildResource suceeed boolean 创建数据集是否成功 1.2 ChildResouree newResourceID 新创建的数据集资源ID string ChildResource 新创建的数据集资源UR 1.3 newResource.ocation string 出错信息,见附录D,创建成功无 ChildResource error HttpError 此参数 22
GB/39584一2020 6.3.6数据集接口 6.3.6.1 概述 数据集接口用于获取隶属于某个数据源的一个数据集的信息 6.3.6.2接口定义 O datasets_uri)>/name/datasetName)[.(for rmat datasets_uri>i /index/datasetlndex[.(format)7 /de datasetName)[.(format)门 GB/T39584一2020 表40(续) 类型 说明 名称 isReadOnly 数据集是否为只读 boolean pjCoordSys PrjCoordSys 数据集的投影信息,见B.l 表名,对数据库型数据鄙,指此数据集在数据库中所对 tabeName 应的数据表名称,对文本型数据源,指此数据集存储属 string 性的表名称 定义数据集的字符集,见表42,当数据集资源标识为欠 charset C'harset 量数据集时存在 是否使用文件形式的缓存,当数据集资源标识为矢量数 isFileCache boolean 据集时存在 像素分块的大小,当数据集资源标识为格网或影像数撕 blockSize ong 集时存在 数据的高度,当数据集资源标识为格网数据集或影像数 height long 据集时存在 数据的宽度,当数据集资源标识为格网数据集或影像数 width long 据集时存在 定义数据集的像素格式,见表43,当数据集资源标识为 pixelFormat PixelFormat 格网或影像数据集时存在 影像是否多波段影像,当数据集资源标识为影像数据集 isMuliBand boolean 时存在 影像数据颜色调色板,当数据集资源标识为影像数据集 Dalette Iist(iava.awt.color 时存在 表41数据集编码方式 枚举类型 说明 BYTE 单字节编码方式 DCT DCT编码方式 INTl6 双字节编码方式 INT24 三字节编码方式 INT32 四字节编码方式 1Zw LZw编码方式 NONE 无任何编码方式 PNG PNG编码方式,支持多种位深的图像 24
GB/39584一2020 表42数据集字符集类型 枚举类型 说明 ANs1 AsCII字符集 CHINESEBIG5 香港和台湾最常用的中文字符集 DEFAUL.T 扩展的AsCI字符集 GB18030 在大陆使用的中文字符集 UNICODE Unicode标准编码 UTF32 UTP3说线S上编 UTF8 UTF-8编码 WTINDOWS1252 英文常用编码 表43数据集像素格式 枚举类型 说明 BIT8 每个像元用8个比特,即1个字节表示 BITl6 每个像元用16个比特,即2个字节表示 BT32 每个像元用32个比特,即4个字节表示 BIT64 每个像元用64个比特,即8个字节表示 RGB 每个像元用24个比特,即3个字节表示 RGBA 每个像元用32个比特,即4个字节表示 SINGLE 每个像元用4个字节表示 DoUBLE 每个像元用8个字节表示 UBIT1 每个像元用1个比特表示 UB1T4 每个像元用4个比特表示 UBIT8 每个像元用8个比特,即1个字节表示 UBT16 每个像元用16个比特,即2个字节表示 UBIT32 每个像元用32个比特,即4个字节来表示 6.3.6.5PUT方式接口参数说明 UT方式用于创建数据集或修改数据集信息 分为两种情况 第一种,数据集资源不存在,对一 个新的URI发送PUT请求,表示创建数据集,请求参数见表44 第二种,数据集资源存在,对其执行 PUT请求,表示修改数据集信息,请求参数见表45 25
GB/T39584一2020 表44数据集接口PU方式创建数据集请求参数 名称 类型 参数性质 说明 必填 用户密钥 key string 必填 数据集名称 datasetName string datasetType datasetType 必填 数据集类型枚举,见表35 表45数据集接口PU方式修改数据集请求参数 名称 类型 参数性质 说明 lkey 必填 用户密钥 string 必填 数据集描述信息 deseription string pjCoordSys PrjCoordSys 选填 投影坐标系,见B1 选填 矢量数据集的字符集 charset enumm palette List(Color 选填 数据集类型为矢量数据集时传递此参数,空值表示编码方式不变 noValue double 选填 影像数据的颜色调色板 6.3.6.6PU方式接口响应结构 响应结构见表46 表46数据集接口PUT方式响应结构 序号 父元素名称 子元素名称 约束 类型 长度 说明 ist ChildResource 数据集资源列表 ChildResource 操作是否成功 .l succee(d boolean 新创建的数据集资源URI,若执行修改 ChildResource l.2 string newResourcelocation 操作,则无本字段 ChildResource 出错信息,见附录D,创建成功无本字段 1.3 error HttpError 6.3.6.7DELE:E方式接口参数说明 DELETE方式用于删除数据集,请求参数见表47 表47数据集接口DELEIE方式请求参数 名称 参数性质 说明 类型 必填 用户密钥 key string 6.3.6.8DELETE方式接口参数说明 响应结构见表48 26

导航电子地图应用开发中间件接口规范GB/T39584-2020

导航电子地图的应用越来越广泛，涉及到许多不同的应用场景和硬件平台。而要实现这些应用之间的良好协作和互通，则需要中间件接口的规范。

GB/T39584-2020标准针对导航电子地图应用开发中间件接口进行了规范。该标准主要从以下几个方面进行了规定：

• 应用程序接口（API）的定义和规范
• 数据格式的统一要求
• 中间件接口的高可用性和扩展性要求
• 性能指标的要求

其中，对于应用程序接口的定义和规范，GB/T39584-2020标准明确了各种接口的名称、参数、返回值以及错误码等详细信息。这样可以保证不同系统之间的接口调用能够正确无误地进行。

在数据格式方面，该标准规定了导航电子地图应用开发中必须采用统一的数据格式，以确保数据能够被各个系统正确解析和处理。

此外，该标准还要求中间件接口具有高可用性和扩展性。也就是说，在系统出现故障或需要升级扩展时，中间件接口应该能够自动感知并进行无缝切换或升级扩展。

最后，该标准还规定了性能指标的要求，例如接口响应时间、数据传输速率等等。这些指标有助于评估各个系统的性能表现，并进行性能优化。

总之，GB/T39584-2020标准为导航电子地图应用开发中间件接口的规范提供了标准与指导，有利于不同系统之间的良好协作与兼容，推动导航电子地图应用的发展。

导航电子地图应用开发中间件接口规范的相关资料

和导航电子地图应用开发中间件接口规范类似的标准