地址服务平台用户手册

1、地址服务平台用户手册丰图科技（深圳）有限公司目录TOC o 1-5 h z地址管理服务平台需求规格说明书11.产品概述3 HYPERLINK l bookmark4 o Current Document 产品定位3 HYPERLINK l bookmark6 o Current Document 用户分析4 HYPERLINK l bookmark8 o Current Document 数据架构8 HYPERLINK l bookmark10 o Current Document 功能矩阵10 HYPERLINK l bookmark12 o Current Document 业务流程图11

2、2.功能说明13 HYPERLINK l bookmark14 o Current Document 产品登录页13 HYPERLINK l bookmark16 o Current Document 产品引导页14 HYPERLINK l bookmark36 o Current Document 地址运营管理14 HYPERLINK l bookmark18 o Current Document 数据管理模块14 HYPERLINK l bookmark20 o Current Document 任务管理模块17 HYPERLINK l bookmark30 o Current Docum

3、ent 智能地址查询28地址服务目录29 HYPERLINK l bookmark40 o Current Document 系统管理29 HYPERLINK l bookmark32 o Current Document 服务配置29 HYPERLINK l bookmark34 o Current Document 版本总览29地址补录管理30 HYPERLINK l bookmark38 o Current Document 日志文件导出31用户系统管理32 HYPERLINK l bookmark42 o Current Document 程序安装32 HYPERLINK l book

4、mark44 o Current Document 基本配置33 HYPERLINK l bookmark46 o Current Document 可选配置33 HYPERLINK l bookmark48 o Current Document 服务配置33 HYPERLINK l bookmark50 o Current Document 性能需求说明33产品概述产品定位地址信息是城市管理以及人们便利生活的重要基础，随着互联网地图应用的开放，C端用户通过地图应用获取跟空间位置相关需求得到了很大程度的满足。但对于企业和政府，地址数据的产生以及管理有着更为迫切的需求。地址数据的管理目前面临两大

5、问题：地址数据的分散管理导致标准不一，地址数据无论从哪个部门的应用都存在不准确的现象。我国地址信息分散在公安、民政厅、住建、市场监督等多个部门，不同部门之间的地址信息资源相对独立，遵循各自的行业标准，其地址格式和命名规范都不一致，缺乏统一的地名标准化机制；而政府各职能部门的信息系统在采集地址时大多采用手工录入，地址的规范性和准确性得不到保证，给城市管理和社会治理带来诸多困难和不便；第二大问题为地址的更新问题。一方面城市化进程的加速导致地址更新的现实情况增加而地址数据获取和管理与地址数据应用脱节，导致实际上政府部门建立起来的地址库是难以更新并使用的。为此，本产品定位为地址管理服务平台，地址管理服

6、务平台首先会将丰图地理编码引擎进行标准化产品包装，作为地址管理服务平台的后台主体，地址管理服务平台提供地址数据的接入、地址数据的处理、地址服务实时接口提供以及服务管理功能。后续该平台会对接地址数据的生存平台，本版本仅提供少量地址数据的更新入口。用户分析地址服务管理平台的用户根据其拥有的地址数据情况分成两大类型：1、地址应用类用户：地址应用类用户再其业务场景中积累了大量的地址数据，需要对这些数据进行空间化，而其本身缺乏地址数据坐标采集和核实的能力。地址信息空间化的准确程度对其业务场景的使用效果起到关键性作用。比如政务中心的各类办证窗口，金融部门的用户地址信息管理等。2、地址管理类用户：地址管理类

7、用户主要是目前政府地址管理部门，主要是民政、公安、住建、自然资源、市场监督管理等。下表为本产品可能涉及到的政府业务管理域。序号部门业务域业务线序号业务事项1公安部门人口基本信息管理常住人口管理（户籍管理）1常住人口管理（户籍管理）2户籍管理流动人口管理3流动人口管理4暂（居）住证管理身份证管理5身份证登记管理6身份证受理管理2民政部门区划地名界线区划地名界线管理8行政区划制定调整11地名普查12地名档案管理13自然地理实体命名14自然地理实体更名15行政区域命名16行政区域更名1.3数据架构地址服务管理平台的数据架构如下图所示：地址管理类地址应用类地址服务目录顺丰地址数据生产、采集及审核平台任

8、务管理平台地址运营管理数据接入平台顺丰标准地址库后台系统管理缺失数据库更新数据库外采任务外采成果*I小蜜丰采集拍立赚采集外呼作业平台众包采集图1数据架构图地址管理服务平台对接用户两类数据：一种是通过用户系统调用服务接口输入的地址数据，地址管理服务通过接口返回对应标准地址以及相关扩展信息；一类是直接对接用户的批量待处理数据，目前支持用户上传文件以及连接用户数据库两种方式来接入用户数据。接入数据中又可以根据用户输入的数据内容分为地址管理类以及地址应用类。一般地址应用类用户输入地址仅包括地址描述类输入这类用户关心平台返回的经纬度信息，主要为了给这类信息做空间化处理，如上图等；地址管理类用户除了输入地

9、址描述之外，可能包括地址坐标。原因是这类用户本省就是地址管理类用户，如民政、公安、测绘（地理信息中心等）他们本身就有地址数据采集建库管理的能力，需要将这类数据输入到我们的平台进行地址标准化处理或地址关联等。并希望将这类地址数据反馈到平台依赖的顺丰标准地址库中这两类用户数据处理流程分别：1、应用单位业务系统地址文本：通过接入平台对数据抽取分离出地址文本数据，再经过分词、重构、标准化以及地址匹配等操作，形成标准地址，并将用户关心的地址经纬度、标准地址描述信息返回给用户。2、应单位业务系统经纬度数据：通过平台数据采集系统进入数据管理平台，选择地址标准化或关联方式等相关地址处理，返回用户关心的标准地址

10、、经纬度信息、关联业务地址信息及业务ID等内容。上述过程中地址匹配失败或者确实的通过后台管理系统进入缺失地址库，由系统运维人员将缺失地址库导出提供给丰图科技，丰图科技根据用户约定更新时间进行数据更新。1.4功能矩阵平台产品基础版本功能主要应对跑数功能的需求，标准版上增加了地图模块能够进行地址搜索、匹配上图、坐标拾取等。高级版主要针对公安行业定制化需求，增加地址标准化、业务关联等地址强需求。表SFGeocoding功能矩阵功能项基础版标准版咼级版服务节点配置VVV白名单配置VVV许可管理VVV数据接入VVV任务管理VVV节点管理VVV指标分析统计VVV结果下载VVV结果预览VVV地图配置VV坐标

11、拾取VV上图展示VVPOISVV地址服务目录VV地址关联V地址标准化V业务流程图目前本版本的用户体系只包括了普通用户和系统管理员，普通用户后续会根据用户的业务类型进行角色划分，包括地址管理员和地址应用人员。普通用户使用本产品主要完成两大类工作，关注地址描述细节和关注地址坐标。关注地址描述细节的细分为地址标准化以及地址关联关系建立。关注地址坐标的需要获取地址坐标并上图查看。普通用户的业务逻辑如下图所示：图2普通用户业务逻辑系统管理员负责对目前产品依赖的底层算法和数据进行更新和版本管理，并对系统对外提供的接口服务进行服务管理，其业务逻辑如下图所示：图3管理员业务逻辑2.功能说明产品登录页地址服务管

12、理平台登录页，同时也是产品的宣传介绍页，提供登录功能，用户点击登录，输入分配的账号密码，登录至平台系统。登录页对顺丰地址服务管理平台支持的三种层级的地址服务进行了介绍，包括AOI级地址服务、楼栋级地址服务、深度立体地址服务，并附带了顺丰地图介绍及联系方式。产品引导页地址服务管理平台部署完成之后，输入引导页url进入地址服务管理功能引导部分，主要三大功能：地址运营管理、地址示范应用、地址服务目录。2.3地址运营管理地址运营管理主要包括数据管理和任务管理两大功能，数据管理模块主要用于接入用户批量地址处理数据，任务管理用于管理用户创建的各类地址任务。本版本支持的任务类型包括三大类型:地址匹配、地址标

13、准化、地址关联。数据管理模块数据管理模块的主要功能用于接入用户的批量数据。接入数据包括文件和数据库格式。后期版本会扩展数据接入的类型，包括WebService接口类型、大数据管理平台数据接入等。数据管理模块本版本规划了三个子模块：数据接入模块、数据列表模块、我的数据模块。登陆用户进入系统之后，通过数据接入模块上传或者链接对应的数据库，上传对应数据之后，其相关数据进入到对应用户的数据列表中。TMtffQQWItR*：|aIIIJI摆Hfl：rQViiarFWM图4数据接入界面进入数据接入页面之后，用户可选择使用数据库接入，或者直接拖拽csv文件进入系统，如果是数据库接入，则会要求用户选择表及字段

14、，对CSV，则需要用户选择字段，数据上传过程对必须字段进行检查，满足格式要求的数据上传可提示上传成功。平台系统对数据格式要求为：数据库：ORACLE数据库文件：CSV文件，编码格式限定为UTF-8无编码字段：上传过程中，用户必须指定数据的ID,ADDRESS字段，可选择指定BASECODE字段，当指定BASECODE字段后，该份数据就会成为挂接母版数据，且会追加存入平台挂接系统的母库中。图5CSV接入页面图6数据库接入界面jt企b耳神曲亠:碎EtaWJSftH弓5SJg_Ai=B5W:tvBtt；上楸廈丄EK*昨E22lESKUl3ai4Kmnbin纸咖r-ftfl-:i(W阳立110址切Id

15、d此8:“SB附if饰cubJEflKH仙01ij“*+01*4-01Irifiisj.csijikHNNVudi前图7我的数据列表界面任务管理模块数据接口到对应用户的数据列表之后，用户可进入到任务中心创建对应任务。本版本任务中心支持三种地址任务的创建：地址匹配任务（对地址进行地址编码返回对应地址的经纬度信息，并对用户输入地址和匹配结果进行统计分析）、地址标准化任务（对用户输入地址进行标准化处理，并对比标准化前后的结果对输入地址所做操作进行统计分析）、地址关联任务（用户输入两份地址数据，对改两份地址数据进行地址关联操作，地址关联分为定向关联和非定向关联两大类型）。地址匹配任务图8地址任务创建弗

16、3FWH31SRtt?EM必H剧亦it辭m啊席iqafc需|衣=輛in19*1.歼专V帀与口BKiDv)iinHfr*l5l?SPli9阴前&也ftKiFV*TirMi_kml=14;分词含13级and不含14级，match_level=13；分词含12级and不含13、14级，match_level=12；分词含11级and不含12、13、14级，match_level=11；分词含10级and不含11、12、13、14级，match_level=10；分词含9级and不含10、11、12、13、14级，matchlevel=9；不完全匹配剩余高精、非ps返回的即为不完全匹配其它Ps返回结果

17、对于低精匹配数据，报表图3，图4进行了进一步表示，即图3是低精里面按匹配精度相符（src_level二match_level&match_level不为poi、门牌）、匹配精度不足（src_levelmatch_level&match_level为poi、门牌且fillter非128），这部分可以认为是原始地址中质量不够的数据。图4则是部分匹配级别足够，但是未返回高精的数据表现，规则如下表：低精类型数量占比图3：匹配级别够filter非128P0lfilter10P0lfilter128POI-filter130P0lfilter194P0lfilter40POI-filter74POI-fi

18、lter32P0l-filter66地址标准化任务地址标准化是针对用户提供的多种地址，通过对地址进行切词分级、智能匹配，结合机器学习和规则算法，提供用户输入地址的标准化地址。在数据标准化中，会对原有数据进行地址要素新增、删除、修改等。:jiyiTXKlIUIWH-OiW：tiwtiWftjrgictNrnMisurrsuTOEiKCQP卿IWE-SrfiJ-iiirrwj4uhHpq-lb图11地址标准化结果列表mt田昭订ih.lt4f*HiuiZaEanAEiq心ia-hrJFpM-hi-rttJL-H-AdtI-r;Hfl图12地址标准化结果分析地址关联任务地址关联方法支持定向关联和非定向

19、关联两种类型：图14定向关联逻辑定向关联与非定向关联的区别：定向关联明确一个基础关联地址，比如房屋地址或者公安标准地址。定向关联地址中将输入数据中带有BaseAddr,BaseCode字段的（模板中要求必须包含）视为基础地址，后续所有业务地址与改基础地址进行地址关联，典型的应用场景如下两种：1）规划部门和地址应用部门统一使用房屋地址以及房屋编号进行业务关联,房屋地址数据+房屋地址编号（到户室）。2）公安部门及其对应业务部门统一使用公安标准地址以及公安标准地址ID号作为地址关联的基础数据这两类数据都必须包括两个基础字段：输入地址中将BaseAddr、BaseCode,这两个字为必须输入字段。需要

20、进行两步操作：a）系统管理员通过系统配置将房屋地址（公安标准地址数据）上传到后台服务器，启动初始化配置任务，将含有BaseAddr,BaseCode的基础地址数据进行初始化入库，写入到后台数据库Relate_config配置表中。b）系统识别到用户输入地址文件中包括两个必须包括的字段，启动地址关联的时候，走定向地址关联分支，对Relate_config配置表进行数据追加。非定向地址关联指的是用户缺乏统一的基础地址类数据，但是又需要对两个HBL30K2011604113&4.第1710.轴地址进行关联，这时候默认选择系统后台顺丰标准地址库作为关联参考基准。改来地址关联业务无需用户指定基础字段。输

21、入的两个待关联数据中都包括了必须的Address字段即可开始关联任务。地址关联指标设计地址关联包括指标设计：甩口耳剁崔离1*匹配到楼悔频MOIGIfiL别圧樺占比底占比AJDltfiKl底占比底槽占比地址关联结果指标设计1.总体关联率2.分多个分支统计数量及关联率1）对数据最细的描述等级分类；2）分为楼栋级别、户级别，两种粒度的关联据预处理分类进行房间挂接道路地址车库地址多个楼栋号地描述等级数量关联类型数量关联率房间（M）196399幢（DML）10640.54%房间（DSH）17089087.01%楼栋号（B）8502幢（DML）632774.42%房间（DSH）8399.87%小区（C）7

22、24幢（DML）58680.94%房间（DSH）131.80%门牌号（S）9120幢（DML）662072.59%房间（DSH）2412.64%道路（R）90幢（DML）66.67%房间（DSH）0.00%其他4821幢（DML）389&07%房间（DSH）307363.74%幢挂接量149926.83%房间号挂接量17505679.70%挂接总量合计19004886.52%地址关联任务完成跑数后，同样存在数据报表和数据列表，如下：图16地址关联报表图17地址关联列表智能地址查询地址服务平台还提供地址-地图结合的查询服务，即智能地址查询服务，该服务提供正/逆地理编码两种上图查询，结合提供的高精

23、细地图，可进行地址-地图结合。图16地址正反地理编码地址服务目录地址服务目录主要包括正向地理编码、批量正向地理编码、逆地理编码、地址标准化服务接口、地址关联服务接口。此部分单独形成文档，详见地址服务管理平台-地址服务目录文档。系统管理服务配置地理编码服务地址配置。提供配置地理编码服务地址，测试连接地图服务地址配置（可选）提供配置地图服务地址，配置生效后，可在单条查询功能处加载地图，查询后定位显示在地图上。版本总览展示目前客户端版本（含地理编码服务地址）、geo服务（算法、配置、索引）、ps服务（算法、索引）的版本信息、文件路径。图17服务配置应用启动停止提供应用启动停止按钮，重启相应服务（ge

24、o、ps）,完成后刷新当前总览页面，更新相应版本信息。授权信息：展示地理编码服务授权信息、有效期。地址补录管理对于用户已知的精确地址，在运营管理中，提供地址白名单的管理，形成地址补录功能，当用户的业务数据与补录地址一致时，将会匹配返回补录地址。地址补录提供补录地址的增、删、改、查功能。图18提供补录地址坐标拾取功能补录地址上传提供上传文件模板，用户可批量更新白名单功能，新地址为新增，已存在地址覆盖。FEfl禹JTfliKI。前圈Id0*沁Flgm0临m阿*再tu圈IdtJJ11113爲苗noioU临lU01L0ML14HfT)13-49-1311VWi彌!赣E；切齣.NYt.刃珥鼻卅*1厘1展

25、帽皿円律牙卜皿：！剋彌覊i*ti晒規AnI辛喘曲一itwfiii!URwr匸二卄tjiif皆Ipit石工e则Isa匸rqJihv*凋田牛|2鼻聊科輕耳社井晒miHPT毎怖則IAJ?*lxAEWrtKii*HitI-ivi图19地址补录名单日志文件导出提供手动方式导出存量C+日志，可附加筛选条件（如时间范围）。该模块功能尚在开发中，目前版本暂未提供。用户系统管理地址服务平台自带一套用户管理系统，管理方式为角色管理-用户管理-权限内容管理模式，即标准的RBAC模式；就是用户通过角色与权限进行关联，从而获得某些功能的使用权限。权限被赋予给角色，而不是用户，但是一个用户可以拥有若干个角色，当一个角色被赋予给某一个用户时，此用户就拥有了该角色所包含的功能权限。用户管理架构如下：用户管理权限系统图20用户管理架构程序安装基于可执行程序完成g