DB36∕T 1233-2020 地名地址地理编码服务规范.pdf

ICS 07.040 A 79 DB36 江西省地方标准 DB36/T 12332020 地名地址地理编码服务规范 Geocode service specification for geographical name and address 2020 - 04 - 07 发布 2020 - 10 - 01 实施 江西省市场监督管理局 发 布 DB36/ T2020 I 目 次 前 言 . II 1 范围 . 1 2 规范性引用文件 . 1 3 术语与定义 . 1 4 地理编码接口 . 2 4.1 接口类型 . 2 4.2 使用协议 . 2 4.3 评分标准 . 2 4.4 接口说明 . 3 DB36/T 12332020 II 前 言 本标准按照GB/T 1.1-2009给出的规则起草。 本标准由江西省测绘地理信息标准化技术委员会(JX/TC024)提出。 本标准由江西省自然资源厅归口。 本标准起草单位：江西省基础地理信息中心。 本标准主要起草人：甘田红、廖明伟、廖明、万冉冉、曾丹、李婷、万敏、夏淑芳、王川、徐珂、熊宁薇、虞丽青、唐遂、赵青芳、刘馨、万佩璇、钟滨、廖永皓、陈娟、顾华奇、杨树平、韩飞、黄建忠、袁武彬、林林。 DB36/ T2020 1 地名地址地理编码服务规范 1 范围 本标准规定了地理编码服务的类型、访问方式、访问接口。 本标准适用于江西省地名地址地图表达与服务中地名地址数据成果和地址匹配功能包装成服务的形式对外发布使用。 2 规范性引用文件 下列文件对于本文件的应用是必不可少的。 凡是注日期的引用文件， 仅所注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。 DB36/T 1231 地名地址数据规范 DB36/T 1232 地名地址数据处理技术规范 3 术语与定义 下列术语和定义适用于本文件。 3.1 地理编码 geocoding 将地址或者地名信息建立空间坐标关系的过程。 3.2 正向地理编码 forward geocoding 将地址或者地名转换成点坐标的过程。 3.3 反向地理编码 reverse geocoding 将点坐标转换为一种可读的地址串的过程。 3.4 单地理编码 single geocoding 一次匹配一条地名/地址数据的正向地理编码。 3.5 批量地理编码 bulk geocoding 一次匹配多条地名/地址数据的正向地理编码。 DB36/T 12332020 2 3.6 地理编码服务引擎 geocoding service engine 基于地名地址数据库建立， 用于实现空间定位和空间信息整合。 通过地名地址匹配服务可以将各类包含地址或位置描述信息的大数据转换为带有空间坐标位置的数据，以实现数据的空间化。 3.7 正向地理编码服务引擎 forward geocoding service engine 基于中文地名分词技术，依照中文地址规则，将中文地名描述、地址描述、人们习惯使用的不完整地址和不规范地址，提取关键词并转换为地球表面上相应位置，并给出评分。通常输入的地址越准确，匹配的分值越高。还可以依据地名属性中的别名、简称、曾用名等实现精确匹配地址别名和地址要素别名。 3.8 反向地理编码服务引擎 reverse geocoding service engine 将点坐标转换为一种可读的地址串的过程， 通过反向地名地址匹配， 可以方便的将地理坐标转换为更易于理解的地址信息。通过反向地理编码服务引擎，可以输入经纬度坐标信息、匹配距离等参数，将空间坐标转换为地址数据，并在地图上展示。根据用户输入的X、Y坐标值，实现逆向查询，得到该坐标所在的行政区划、所处街道以及最匹配的标准地址信息。 4 地理编码接口 4.1 接口类型 地理编码服务接口包括正向地理编码服务接口和反向地理编码服务接口， 其中正向地理编码服务接口包括单地理编码服务接口和批量地理编码服务接口。 4.2 使用协议 REST接口支持基于HTTP协议的POST和GET方法请求。 4.3 评分标准 地理编码引擎将判定用户输入地址与标准地址库，按照DB36/T 1231和DB36/T 1232的规定进行匹配程度，匹配度越高则得分越高。具体的评分标准见表1。 表1 评分标准 得分 地物评分描述 街巷（道路）评分描述 行政区评分描述 精确到所在小区、地标或村，且用户输入地址所属县级行政区划无缺失 精确到街巷（道路），用户输入行政区划级别无缺失 精确到行政区划，用户输入行政区划级别无缺失 90-100 门牌号码相差 05 个 精确到街巷（道路），用户输入包含市级或县级行政区划 匹配市级或县级行政区划 DB36/ T2020 3 表1 （续） 得分 地物评分描述 街巷（道路）评分描述 行政区评分描述 精确到所在小区、地标或村，且用户输入的地址所属行政区划，如县、乡有缺失 精确到街巷（道路），用户输入包含乡级行政区划 精确到行政区划，用户输入行政区划级别缺失市级或县级行政区划 80-90 门牌号码相差 510 个 门牌号码相差 1015 个 精确到街巷（道路），用户输入只包含街巷（道路）名称 精确到乡级行政区划，用户输入只包含乡级行政区划 70-80 所属行政区划存在或部分缺失 精确到道路 无 精确到村或社区，用户输入只包含村或社区 60-70 所属行政区划存在或部分缺失 精确到乡级行政区划 无 无 50-60 所属行政区划存在或部分缺失 35 精确到县级行政区划 无 无 20 精确到市级行政区划 无 无 4.4 接口说明 4.4.1 单地理编码服务接口 4.4.1.1 请求参数 请求参数说明见表2。 表2 单地理编码请求参数说明 请求参数 参数含义 是否必须 默认值 举例 描述 queryStr 查询地址 是 无 江西省赣州市章贡区水南镇客家大道162 号中国银行 单地址查询参数 score 最少的得分 否 无 60 查询结果地址的匹配度得分，此参数为一个临界值，得分值大于此参数则将查询结果返回，否则不返回。 citycode 城市代码 否 无 360700 国家规范的行政区划代码 f 服务返回结果格式 否 xml xml 或 json 数据返回形式， 以 xml 或 json 格式返回 4.4.1.2 返回参数 返回参数说明见表3。 表3 单地理编码返回参数说明 返回参数 参数含义 数据类型 举例 说明 status 状态信息 布尔型 true：正常 false：异常 查询数据的状态标示 DB36/T 12332020 4 表3 单地理编码返回参数说明（续） 返回参数 参数含义 数据类型 举例 说明 queryAddress 查询地址 字符型 江西省赣州市章贡区水南镇客家大道 162 号中国银行 用户输入的查询信息 count 返回结果数 字符型 1 name 名称 字符型 中国银行 score 得分 单精度型 100 id ID 长整型 geotext WKT 格式的几何数据 字符型 POINT(114.91062000031286 25.843050000257335) geoType 几何数据类型 整型 1：点要素 2：线要素 3：面要素 返回数据几何类型 fullAddress 完整地址 字符型 江西省赣州市章贡区水南镇客家大道 162 号中国银行 latitude 纬度 双精度型 114.91062000031286 longitude 经度 双精度型 25.843050000257335 province 省名称 字符型 江西省 city 市名称 字符型 赣州市 county 县名称 字符型 章贡区 town 乡名称 字符型 水南镇 street 街巷（道路）名称 字符型 客家大道 street_suf 道路后缀 字符型 162 号 community 小区名称 字符型 communitySuf 小区后缀 字符型 landmark 第一地标名称 字符型 中国银行 result address secondLandmark 第二地标名称 字符型 4.4.2 批量地理编码服务接口 4.4.2.1 请求参数 请求参数说明见表4。 表4 批量地理编码请求参数说明 请求参数 参数含义 是否必须 默认值 举例 描述 queryStrs 查询地址 是 无 赣州市章贡区水南镇客家大道 162 号中国银行, 赣州市章贡区南外街道办青年路 32 号天天便利 多个地址用分号隔开 DB36/ T2020 5 表4 批量地理编码请求参数说明（续） 请求参数 参数含义 是否必须 默认值 举例 描述 score 最少的得分 否 无 f 服务返回结果格式 否 xml xml json 数据返回形式，默认以xml 格式返回 4.4.2.2 返回参数 返回参数说明见表5。 表5 批量地理编码返回参数说明 返回参数 参数含义 数据类型 举例 说明 status 状态信息 布尔型 true：正常 false：异常 查询数据的状态标示 name 名称 字符型 中国银行 score 得分 单精度型 100 id ID 长整型 geotext WKT 格式的几何数据 字符型 POINT(114.91062000031286 25.843050000257335) geoType 几何数据类型 整型 1：点要素 2：线要素 3：面要素 返回数据几何类型 fullAddress 完整地址 字符型 江西省赣州市章贡区水南镇客家大道162 号中国银行 latitude 纬度 双精度型 114.91062000031286 longitude 经度 双精度型 25.843050000257335 province 省名称 字符型 江西省 city 市名称 字符型 赣州市 county 县名称 字符型 章贡区 town 乡名称 字符型 水南镇 street 道路名称 字符型 客家大道 street_suf 道路后缀 字符型 162 号 community 小区名称 字符型 communitySuf 小区后缀 字符型 landmark 第一地标名称 字符型 中国银行 results address secondLandmark 第二地标 字符型 4.4.3 反向地理编码服务接口 4.4.3.1 请求参数 请求参数说明见表6。 DB36/T 12332020 6 表6 反向地理编码请求参数说明 请求参数 参数含义 是否必须 默认值 举例 描述 distance 最远距离 否 500M 以用户输入的点为圆心，distance 为半径查询周边最近的道路或地标，最大范围 5000 米。 longitude 经度 是 用户输入点的经度 latitude 纬度 是 用户输入点的纬度 f 服务返回结果格式 否 xml xml json 数据返回形式，默认以 xml 格式返回 isGeom 道路和区域是否返回空间几何字段 否 true true：是 false：否 反向地理编码查询结果中的行政区划和道路是否返回空间坐标信息，结果较长，默认返回。 4.4.3.2 返回参数 返回参数说明见表7。 表7 反向地理编码返回参数说明 返回参数 参数含义 数据类型 举例 说明 status 状态信息 布尔型 true：正常 false：异常 查询数据的状态标示 count 返回结果数 字符型 100 批量匹配条数 name 名称 字符型 水南镇 fullddress 标准地址 字符型 江西省赣州市章贡区水南镇 province 省名称 字符型 江西省 city 市名称 字符型 赣州市 county 县名称 字符型 章贡区 region town 乡名称 字符型 水南镇 name 名称 字符型 客家大道 fullAddress 标准地址 字符型 江西省赣州市章贡区水南镇客家大道 province 省名称 字符型 江西省 city 市名称 双精度型 赣州市 county 县名称 双精度型 章贡区 town 乡名称 字符型 水南镇 street distance 请求点至道路最短距离 双精度型 98.34 name 地物名称 字符型 中国银行 fullAddress 标准地址 字符型 江西省赣州市章贡区水南镇客家大道 162 号中国银行 province 省名称 字符型 江西省 city 市名称 字符型 赣州市 result poi county 县名称 字符型 章贡区 DB36/ T2020 7 表7 反向地理编码返回参数说明（续） 返回参数 参数含义 数据类型 举例 说明 town 乡名称 字符型 水南镇 longitude 经度 双精度型 114.91062000031286 latitude 纬度 双精度型 25.843050000257335 result poi distance 请求点至 POI 最短距离 双精度型 30.74 _