江西省地名地址地图表达 服务与应用标准

ICS 07.040A 79DB 36江 西 省 地 方 标 准DB 36/ T XXXXXXX江西省地名地址地图表达 服务与应用标准Standards for service and application for map expression of names and address in Jiangxi Province（送审稿）XXXX - XX - XX 发布 XXXX - XX - XX 实施江 西 省 市 场 监 督 管 理 局 发 布DB36/T XXXXXXXI目 次前 言 .II1 范围 .12 规范性引用文件 .13 术语与定义 .14 地理编码服务 .24.1 概述 .24.2 服务类型 .25 地理编码服务接口 .35.1 接口设计原则 .35.2 地理编码服务接口 .3附录 A （规范性附录） 评分标准 8DB36/T XXXXXXXII前 言本规范按照GB/T 1.1-2009给出的规则起草。本规范由江西省测绘地理信息局提出并归口。本规范起草单位：江西省基础地理信息中心。本规范主要起草人：甘田红、廖明伟、廖明、万冉冉、曾丹、李婷、万敏、夏淑芳、王川、徐珂、熊宁薇、虞丽青、唐遂、赵青芳、刘馨、万佩璇、陈娟、顾华奇、杨树平、韩飞、黄建忠、袁武彬、林林。DB36/T XXXXXXX1江西省地名地址地图表达 服务与应用标准1 范围本标准规定了地名地址服务的类型、访问方式、访问接口。本标准适用于江西省地名地址地图表达中地名地址服务与应用公共服务平台建设。2 规范性引用文件下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T 23705-2009 数字城市地理信息公共平台地名/地址编码规则 IETF RFC 2616-1999 超文本传输协议-HTTP/1.1（Hypertext Transfer Protocol - HTTP/1.1） 3 术语与定义下列术语和定义适用于本文件。3.1 地理编码 geocoding指的是将地址或者地名信息建立空间坐标关系的过程。3.2 正向地理编码 forward geocoding正向地理编码服务是指将地址或者地名转换成点坐标的过程。3.3 单地理编码 single geocoding单地理编码匹配是指一次匹配一条地名/地址数据的正向地理编码。3.4 批量地理编码 bulk geocoding批量地理编码匹配是指一次匹配多条地名/地址数据的正向地理编码。3.5 反向地理编码 reverse geocoding反向地理编码服务是指将点坐标转换为一种可读的地址串的过程。DB36/T XXXXXXX24 地理编码服务4.1 概述地理编码服务是地名地址信息服务平台的核心，将成果地名地址数据库和地址匹配功能包装成服务的形式对外发布，供政府各部门、企事业单位和社会公众调用，是地名地址成果的新型运用方式。4.2 服务类型在线地理编码服务系统以地址匹配引擎为核心，提供正向地理编码、反向地理编码。4.2.1 正向地理编码服务正向地理编码服务是指将地址或者地名转换成点坐标的过程。该服务基于正向地理编码服务引擎实现。在进行地址匹配时，支持用户输入一个或者批量的地址描述信息，自动匹配分值最高的候选位置，输入的地址越准确，匹配的分值越高。地名地址数据主要分为行政区划、街巷（道路）、兴趣点、标志物、门牌号等类别；数据类型也不一样，包括点状、线状、面状3种类型；因此在设计地理编码服务引擎时，为了更好的达到地址匹配的效果，采用分引擎设计模式，针对不同的地名等级开发不同的地址匹配引擎，以便更好地进行地址匹配，见图1。图1 正向地理编码服务引擎分类正向地理编码服务引擎类型如下：地址引擎：主要用于实现兴趣点级别的地址匹配和定位功能；行政区划引擎：主要用于实现行政区划的匹配定位，即当用户输入行政区划的名称时，获取该行政区划所对应的空间范围图形信息；街巷（道路）引擎：主要用于实现街巷（道路）的匹配与定位功能；交叉路口引擎：主要用于实现街巷（道路）交叉路口的匹配定位功能，例如用户输入“钨都大道赞贤路” ，定位到两条道路的交叉口；门址引擎：主要用于实现门牌号的匹配定位功能。正向地理编码服务引擎门址引擎 交叉路口引擎街巷（道路）引擎行政区划引擎地址引擎DB36/T XXXXXXX3在实际使用中，用户只需输入地址串，无需选择通过哪个引擎来进行匹配，引擎的判断过程由系统自动来实现。4.2.2 反向地理编码服务通过反向地理编码，可以方便的从移动终端等设备上将地理坐标转换为易于理解的地址信息。该服务基于反向地理编码服务引擎实现。反向地理编码服务引擎包括3种子引擎：行政区划引擎、街巷（道路）引擎和地址引擎，如下：行政区划引擎：用户输入坐标位置，返回该位置所在的行政区划名；街巷（道路）引擎：用户输入坐标位置，返回该位置附近的街巷（道路）名；地址引擎：用户输入坐标位置，返回离该位置最近的地名的地址。5 地理编码服务接口5.1 接口设计原则中文地理编码服务引擎提供了单地理编码、批量地理编码，以及反向地理编码服务，并且为用户提供了标准的基于HTTP协议的REST服务接口，方便用户调用这些高效稳定的引擎服务，从而可以轻松实现跨平台应用地理编码服务。对于平台的WEB Services API设计，应该遵循以下原则：简单性，由于这是一个对于公共开放的Web服务，它的API的设计首先应当是简单的，要被大量用户接受，要获得比较好的应用，那么API必须简单，没有哪个复杂难用的API会得到广泛接受，所以针对目前的应用实况，API必须简单。 可扩展性，作为更新频率较高，开放性较强的Web服务，其API应当具有很好的向后扩展性，当应内部需求的改变或外部需求的改变的需要时，API将根据新的商业逻辑发生变化，此时不应当将API从根本上推翻重建，而应当具备增量式的可扩展的能力。 高效性，API应该在坚持简单性的前提下，兼顾高效性，当某些组合操作应用地非常频繁的时候，我们应当为这样的组合操作调用设计一个只需一次交互的单一入口调用，这样能够提升外部应用的效率，同时减轻Web服务的负载。 完备性，所谓完备性就是说整个API要覆盖所有需要对外公开的功能，这相对而言是最好实现的目标，只要设计阶段考虑得完备，就能达到完备性的要求。而且万一发现不完备的情况，修正起来也是相对容易的。5.2 地理编码服务接口5.2.1 单地理编码服务接口5.2.1.1 接口说明单个地理编码指，进行地理编码时，每次只输入一个位置描述以得到相对应的位置信息。通过单个地理编码可快速查找到各类位置，每个候选位置将含有匹配分值，输入地址越准确，匹配分值越高。用户可输入各种样式和格式表示的地址，其中包括行政区划，街道名称，街道交叉口、含有街道名称的门牌号等。5.2.1.2 使用协议单地理编码REST接口支持基于HTTP协议的POST和GET方法请求。DB36/T XXXXXXX45.2.1.3 请求参数说明请求参数说明见表1。表1 单地理编码请求参数说明请求参数 参数含义 是否必须 默认值 举例 描述queryStr 查询地址 是 无江西省赣州市章贡区水南镇客家大道162号中国银行单地址查询参数score 最少的得分 否 无 60查询结果地址的匹配度得分，此参数为一个临界值，得分值大于此参数则将查询结果返回，否则不返回。citycode 城市代码 否 无 360700 国家规范的行政区划代码f 服务返回结果格式 否 xml xml或 json数据返回形式，以 xml或 json格式返回5.2.1.4 返回参数说明返回参数说明见表2。表2 单地理编码返回参数说明返回参数 参数含义 数据类型 举例 说明status 状态信息 Booleantrue：正常false：异常查询数据的状态标示queryAddress 查询地址 String江西省赣州市章贡区水南镇客家大道 162号中国银行用户输入的查询信息count 返回结果数 String 1 name 名称 String 中国银行 score 得分 Double 100 id ID Long geotext WKT格式的几何数据 StringPOINT(114.91062000031286 25.843050000257335)geoType 几何数据类型 Int1：点要素2：线要素3：面要素返回数据几何类型fullAddress 完整地址 String江西省赣州市章贡区水南镇客家大道 162号中国银行latitude 纬度 double 114.91062000031286 longitude 经度 double 25.843050000257335 province 省名称 String 江西省 city 市名称 String 赣州市 result addresscounty 县名称 String 章贡区 DB36/T XXXXXXX5town 乡名称 String 水南镇 表2 （续）返回参数 参数含义 数据类型 举例 说明street 街巷（道路）名称 String 客家大道 street_suf 道路后缀 String 162号 community 小区名称 String communitySuf 小区后缀 String landmark 第一地标名称 String 中国银行 result addresssecondLandmark 第二地标名称 String 5.2.2 批量地理编码服务接口5.2.2.1 接口说明批量地理编码是指将一系列位置描述批量转换为地球表面上对应的位置的过程。批量地理编码时，每次传入多个位置描述。通过批量地理编码可快速查找到大量的位置，每条描述地址将自动匹配分值最高的候选位置。可搜索的位置类型与单一地理编码相同，用户可输入各种样式和格式表示的地址，其中包括行政区划，街道名称，街道交叉口、含有街道名称的门牌号等。5.2.2.2 使用协议批量地理编码REST接口支持基于HTTP协议的POST方法请求。5.2.2.3 请求参数说明请求参数说明见表3。表3 批量地理编码请求参数说明请求参数 参数含义 是否必须 默认值 举例 描述queryStrs 查询地址 是 无赣州市章贡区水南镇客家大道 162号中国银行, 赣州市章贡区南外街道办青年路 32号天天便利多个地址用分号隔开score 最少的得分 否 无f服务返回结果格式 否 xmlxmljson数据返回形式，默认以 xml格式返回5.2.2.4 返回参数说明返回参数说明见表4。表4 批量地理编码返回参数说明返回参数 参数含义 数据类型 举例 说明status 状态信息 Booleantrue：正常false：异常查询数据的状态标示name 名称 String 中国银行 results addressscore 得分 Double 100 DB36/T XXXXXXX6id ID Long 表4 （续）返回参数 参数含义 数据类型 举例 说明geotextWKT格式的几何数据 StringPOINT(114.91062000031286 25.843050000257335) geoType 几何数据类型 Int1：点要素2：线要素3：面要素返回数据几何类型fullAddress 完整地址 String江西省赣州市章贡区水南镇客家大道 162号中国银行latitude 纬度 double 114.91062000031286 longitude 经度 double 25.843050000257335 province 省名称 String 江西省 city 市名称 String 赣州市 county 县名称 String 章贡区 town 乡名称 String 水南镇 street 道路名称 String 客家大道 street_suf 道路后缀 String 162号 community 小区名称 String communitySuf 小区后缀 String landmark 第一地标名称 String 中国银行 results addresssecondLandmark 第二地标 String 5.2.3 反向地理编码服务接口5.2.3.1 接口说明反向地理编码是将点坐标转换为一种可读的地址或者地名的过程。反向地理编码时，通过给出坐标以确定所给坐标所在行政区划名，附近街道名，以及最近地名（兴趣点）。用户可选择地址精准度到行政区划，市或者兴趣点。通过反向地理编码，用户可从移动端，GPS端等将地理坐标转换为更易于理解的地址信息。5.2.3.2 使用协议反向地理编码REST接口支持基于HTTP协议的POST和GET方法请求。5.2.3.3 请求参数说明请求参数说明见表5。表5 反向地理编码请求参数说明请求参数 参数含义 是否必须 默认值 举例 描述distance 最远距离 否 500M以用户输入的点为圆心，distance 为半径查询周边最近的道路或地标，最大范围 5000米。longitude 经度 是 用户输入点的经度DB36/T XXXXXXX7latitude 纬度 是 用户输入点的纬度表5 （续）请求参数 参数含义 是否必须 默认值 举例 描述f服务返回结果格式 否 xmlxmljson数据返回形式，默认以 xml格式返回isGeom道路和区域是否返回空间几何字段否 true truefalse反向地理编码查询结果中的行政区划和道路是否返回空间坐标信息，结果较长，默认返回。5.2.3.4 返回参数说明返回参数说明见表6。表6 反向地理编码返回参数说明返回参数 参数含义 数据类型 举例 说明status 状态信息 Booleantrue：正常false：异常查询数据的状态标示count 返回结果数 String 100 批量匹配条数name 名称 String 水南镇fullAddress 标准地址 String江西省赣州市章贡区水南镇province 省名称 String 江西省city 市名称 String 赣州市county 县名称 String 章贡区regiontown 乡名称 String 水南镇name 名称 String 客家大道fullAddress 标准地址 String江西省赣州市章贡区水南镇客家大道province 省名称 String 江西省city 市名称 double 赣州市county 县名称 double 章贡区town 乡名称 String 水南镇streetdistance 请求点至道路最短距离 double 98.34name 地物名称 String 中国银行fullAddress 标准地址 String江西省赣州市章贡区水南镇客家大道 162号中国银行province 省名称 String 江西省city 市名称 String 赣州市county 县名称 String 章贡区town 乡名称 String 水南镇resultpoilongitude 经度 double 114.91062000031286DB36/T XXXXXXX8latitude 纬度 double 25.843050000257335distance 请求点至 POI最短距离 double 30.74DB36/T XXXXXXX9A A附 录 A（规范性附录）评分标准地理编码引擎将判定用户输入地址与标准地址库匹配程度，匹配度越高则得分越高。具体的评分标准见表A.1。表A.1 评分标准得分 地物评分描述 街巷（道路）评分描述 行政区评分描述精确到所在小区、地标或村，且用户输入地址所属县级行政区划无缺失精确到街巷（道路），用户输入行政区划级别无缺失精确到行政区划，用户输入行政区划级别无缺失90-100门牌号码相差 0-5个 精确到街巷（道路），用户输入包含市级或县级行政区划 匹配市级或县级行政区划精确到所在小区、地标或村，且用户输入的地址所属行政区划，如县、乡有缺失精确到街巷（道路），用户输入包含乡级行政区划精确到行政区划，用户输入行政区划级别缺失市级或县级行政区划80-90门牌号码相差 5-10个门牌号码相差 10-15个 精确到街巷（道路），用户输入只包含街巷（道路）名称 精确到乡级行政区划，用户输入只包含乡级行政区划70-80所属行政区划存在或部分缺失精确到道路 无 精确到村或社区，用户输入只包含村或社区60-70所属行政区划存在或部分缺失精确到乡级行政区划 无 无50-60 所属行政区划存在或部分缺失35 精确到县级行政区划 无 无20 精确到市级行政区划 无 无_