地址服务平台用户手册

地址服务平台顾客手册丰图科技（深圳）有限公司

目录地址管理服务平台需求规格阐明书 11. 产品概述 31.1产品定位 31.2顾客分析 31.3数据架构 81.4功效矩阵 101.5业务流程图 112. 功效阐明 132.1 产品登录页 132.2 产品引导页 142.3 地址运行管理 142.5.1 数据管理模块 142.5.2 任务管理模块 172.6 智能地址查询 282.7 地址服务目录 292.8 系统管理 292.8.1 服务配备 292.8.2 版本总览 292.8.3 地址补录管理 302.8.4 日志文献导出 312.9 顾客系统管理 322.10 程序安装 322.10.1 基本配备 332.10.2 可选配备 332.11 服务配备 332.12 性能需求阐明 33产品概述产品定位地址信息是都市管理以及人们便利生活的重要基础，随着互联网地图应用的开放，C端顾客通过地图应用获取跟空间位置有关需求得到了很大程度的满足。但对于公司和政府，地址数据的产生以及管理有着更为迫切的需求。地址数据的管理现在面临两大问题：地址数据的分散管理造成原则不一，地址数据无论从哪个部门的应用都存在不精确的现象。我国地址信息分散在公安、民政厅、住建、市场监督等多个部门，不同部门之间的地址信息资源相对独立，遵照各自的行业原则，其地址格式和命名规范都不一致，缺少统一的地名原则化机制；而政府各职能部门的信息系统在采集地址时大多采用手工录入，地址的规范性和精确性得不到确保，给都市管理和社会治理带来诸多困难和不便；第二大问题为地址的更新问题。首先都市化进程的加速造成地址更新的现实状况增加，而地址数据获取和管理与地址数据应用脱节，造成事实上政府部门建立起来的地址库是难以更新并使用的。为此，本产品定位为地址管理服务平台，地址管理服务平台首先会将丰图地理编码引擎进行原则化产品包装，作为地址管理服务平台的后台主体，地址管理服务平台提供地址数据的接入、地址数据的解决、地址服务实时接口提供以及服务管理功效。后续该平台会对接地址数据的生存平台，本版本仅提供少量地址数据的更新入口。顾客分析地址服务管理平台的顾客根据其拥有的地址数据状况分成两大类型：地址应用类顾客：地址应用类顾客再其业务场景中积累了大量的地址数据，需要对这些数据进行空间化，而其本身缺少地址数据坐标采集和核算的能力。地址信息空间化的精确程度对其业务场景的使用效果起到核心性作用。例如政务中心的各类办证窗口，金融部门的顾客地址信息管理等。地址管理类顾客：地址管理类顾客重要是现在政府地址管理部门，重要是民政、公安、住建、自然资源、市场监督管理等。下表为本产品可能涉及到的政府业务管理域。序号部门业务域业务线序号业务事项1公安部门人口基本信息管理常住人口管理（户籍管理)1常住人口管理（户籍管理)2户籍管理流动人口管理3流动人口管理4暂（居）住证管理身份证管理5身份证登记管理6身份证受理管理2民政部门区划地名界限区划地名界限管理8行政区划制订调节11地名普查12地名档案管理13自然地理实体命名14自然地理实体改名15行政区域命名16行政区域改名17专业部门设立的命名18专业部门设立的改名19地名使用原则制订20地名数据库建设21地名标志建立22地名标志更新24省县乡行政区域界限管理3住建部门住房保障管理房地产开发管理25房地产开发公司管理26房地产开发从业人员管理27房地产开发项目管理商品房预（销）售管理28房地产开发五证信息管理29商品房楼盘信息管理30商品房预（销）售许可管理31商品房合同备案房屋权属管理32房屋信息管理33房屋权属登记管理34房屋抵押登记管理35房屋交易管理36房屋租赁管理37房屋面积测绘管理房屋拆迁管理38房屋拆迁单位管理39房屋拆迁从业人员管理40房屋拆迁许可管理41房屋拆迁项目管理42房屋拆迁纠纷管理物业管理43物业管理公司管理44物业管理从业人员管理45物业管理公司经营状况管理保障性住房管理46保障性住房房源信息管理47经济合用房申请审批48廉租住房申请审批49房改房上市准入申请审批50住房补贴申请审批4生态环境部门土地管理土地调查51地籍调查52土地资源调查53土地变更调查54基本农田调查建设用地审批55建设项目用地预审管理56都市分批次建设用地报批管理57单独选址建设用地报批管理建设用地供应58建设用地项目供应管理59房地产市场宏观管理60存量土地管理土地运用61土地使用权挂牌交易管理62土地收购储藏管理63闲置土地管理64都市地价管理65农用地分等定级管理66公司改制土地资产处置管理土地权属67土地登记管理68土地权属纠纷调处69土地权属管理5市场监管部门市场主体准入与退出内资公司登记管理70内资公司设立登记71内资公司变更登记72内资公司注销登记分公司登记管理73分公司设立登记74分公司变更登记75分公司注销登记营业单位登记管理76营业单位开业登记77营业单位变更登记78营业单位注销登记内资公司集团登记管理79内资公司集团设立登记80内资公司集团变更登记81内资公司集团注销登记个体登记管理82个体开业登记83个体变更登记84个体歇业登记外商投资公司登记管理85外商投资公司设立登记86外商投资公司变更(备案)登记87外商投资公司注销登记外商投资分支机构登记管理88外商投资分支机构设立登记89外商投资分支机构变更(备案)登记90外商投资分支机构注销登记外国(地区)公司常驻代表机构登记管理91外国(地区)公司常驻代表机构设立登记92外国(地区)公司常驻代表机构变更(备案)登记93外国(地区)公司常驻代表机构注销登记外商投资公司集团设立登记管理94外商投资公司集团设立登记95外商投资公司集团变更登记96外商投资公司集团注销登记公司其它登记管理97公司迁入登记98公司迁出登记99增、补营业执照数据架构地址服务管理平台的数据架构以下图所示：图SEQ图\*ARABIC1数据架构图地址管理服务平台对接顾客两类数据：一种是通过顾客系统调用服务接口输入的地址数据，地址管理服务通过接口返回对应原则地址以及有关扩展信息；一类是直接对接顾客的批量待解决数据，现在支持顾客上传文献以及连接顾客数据库两种方式来接入顾客数据。接入数据中又能够根据顾客输入的数据内容分为地址管理类以及地址应用类。普通地址应用类顾客输入地址仅涉及地址描述类输入这类顾客关心平台返回的经纬度信息，重要为了给这类信息做空间化解决，如上图等；地址管理类顾客除了输入地址描述之外，可能涉及地址坐标。因素是这类顾客我省就是地址管理类顾客，如民政、公安、测绘（地理信息中心等）他们本身就有地址数据采集建库管理的能力，需要将这类数据输入到我们的平台进行地址原则化解决或地址关联等。并但愿将这类地址数据反馈到平台依赖的顺丰原则地址库中这两类顾客数据解决流程分别：1、 应用单位业务系统地址文本：通过接入平台对数据抽取分离出地址文本数据，再通过分词、重构、原则化以及地址匹配等操作，形成原则地址，并将顾客关心的地址经纬度、原则地址描述信息返回给顾客。2、 应单位业务系统经纬度数据：通过平台数据采集系统进入数据管理平台，选择地址原则化或关联方式等有关地址解决，返回顾客关心的原则地址、经纬度信息、关联业务地址信息及业务ID等内容。上述过程中地址匹配失败或者确实的通过后台管理系统进入缺失地址库，由系统运维人员将缺失地址库导出提供应丰图科技，丰图科技根据顾客商定更新时间进行数据更新。功效矩阵平台产品基础版本功效重要应对跑数功效的需求，原则版上增加了地图模块，能够进行地址搜索、匹配上图、坐标拾取等。高级版重要针对公安行业定制化需求，增加地址原则化、业务关联等地址强需求。表SFGeocoding功效矩阵功效项基础版原则版高级版服务节点配备√√√白名单配备√√√许可管理√√√数据接入√√√任务管理√√√节点管理√√√指标分析统计√√√成果下载√√√成果预览√√√地图配备√√坐标拾取√√上图展示√√POIS√√地址服务目录√√地址关联√地址原则化√业务流程图现在本版本的顾客体系只涉及了普通顾客和系统管理员，普通顾客后续会根据顾客的业务类型进行角色划分，涉及地址管理员和地址应用人员。普通顾客使用本产品重要完毕两大类工作，关注地址描述细节和关注地址坐标。关注地址描述细节的细分为地址原则化以及地址关联关系建立。关注地址坐标的需要获取地址坐标并上图查看。普通顾客的业务逻辑以下图所示：图图SEQ图\*ARABIC2普通顾客业务逻辑系统管理员负责对现在产品依赖的底层算法和数据进行更新和版本管理，并对系统对外提供的接口服务进行服务管理，其业务逻辑以下图所示：图图SEQ图\*ARABIC3管理员业务逻辑功效阐明产品登录页地址服务管理平台登录页，同时也是产品的宣传介绍页，提供登录功效，顾客点击登录，输入分派的账号密码，登录至平台系统。登录页对顺丰地址服务管理平台支持的三种层级的地址服务进行了介绍，涉及AOI级地址服务、楼栋级地址服务、深度立体地址服务，并附带了顺丰地图介绍及联系方式。产品引导页地址服务管理平台布署完毕之后，输入引导页url进入地址服务管理功效引导部分，重要三大功效：地址运行管理、地址示范应用、地址服务目录。 地址运行管理地址运行管理重要涉及数据管理和任务管理两大功效，数据管理模块重要用于接入顾客批量地址解决数据，任务管理用于管理顾客创立的各类地址任务。本版本支持的任务类型涉及三大类型:地址匹配、地址原则化、地址关联。数据管理模块数据管理模块的重要功效用于接入顾客的批量数据。接入数据涉及文献和数据库格式。后期版本会扩展数据接入的类型，涉及WebService接口类型、大数据管理平台数据接入等。数据管理模块本版本规划了三个子模块：数据接入模块、数据列表模块、我的数据模块。登陆顾客进入系统之后，通过数据接入模块上传或者链接对应的数据库，上传对应数据之后，其有关数据进入到对应顾客的数据列表中。图SEQ图\*ARABIC4数据接入界面进入数据接入页面之后，顾客可选择使用数据库接入，或者直接拖拽CSV文献进入系统，如果是数据库接入，则会规定顾客选择表及字段，对CSV，则需要顾客选择字段，数据上传过程对必须字段进行检查，满足格式规定的数据上传可提示上传成功。平台系统对数据格式规定为：数据库：ORACLE数据库文献：CSV文献，编码格式限定为UTF-8无编码字段：上传过程中，顾客必须指定数据的ID，ADDRESS字段，可选择指定BASECODE字段，当指定BASECODE字段后，该份数据就会成为挂接母版数据，且会追加存入平台挂接系统的母库中。图SEQ图\*ARABIC5CSV接入页面图SEQ图\*ARABIC6数据库接入界面图SEQ图\*ARABIC7我的数据列表界面任务管理模块数据接口到对应顾客的数据列表之后，顾客可进入到任务中心创立对应任务。本版本任务中心支持三种地址任务的创立：地址匹配任务（对地址进行地址编码返回对应地址的经纬度信息，并对顾客输入地址和匹配成果进行统计分析）、地址原则化任务（对顾客输入地址进行原则化解决，并对比原则化前后的成果对输入地址所做操作进行统计分析）、地址关联任务（顾客输入两份地址数据，对改两份地址数据进行地址关联操作，地址关联分为定向关联和非定向关联两大类型）。地址匹配任务图SEQ图\*ARABIC8地址任务创立图SEQ图\*ARABIC9任务列表地址匹配提供单条地址进行地理编码匹配功效，查询完毕后，展示返回成果。若已配备地图并生效，查询坐标加载到地图上进行展示。提供坐标拾取功效，通过在地图上点选位置获得该位置的坐标。图SEQ图\*ARABIC10地址匹配成果分析匹配成果上图查看图SEQ图\*ARABIC11匹配成果上图展示地址匹配指标分析创立任务创立地理编码批量任务，输入方式可选择上传文献或指定目录，还可选择输出目录（不选择时默认完毕任务时进行下载），成果文献格式为.db。填写任务描述，创立生产地理编码任务。当输入文献带x，y坐标，执行任务时计算与地理编码匹配坐标的距离（只计算高精部分），输出成果增加距离字段。任务列表展示任务信息，包含名称、描述、创立人、数据量、创立时间、预计完毕时间、完毕时间、状态等，任务完毕后提供成果文献、统计报表下载。现在有任务执行时，新创立的任务显示为等待执行，待现在任务完毕后按照创立时间依次执行成果文献原则成果文献字段包含输入地址id、address、adcode，输出字段is_vaild，result_adcode，confidence、percision、err、result_type、match_address，key，xcoord，ycoord。由管理员创立的特殊创立任务生成的任务成果包含全部字段。成果文献格式包含.db，根据创立任务选择的格式输出下载，下载为.ZIP压缩格式。分析报告统计图：以饼图，柱状图的形式展示现在批次数据有效、无效占比，以及有效数据中的高低精占比。报表定义：第一图为以饼图形式展示数据总量、有效数据量（及占比）、无效数据量（及占比），以及高精量（及占比）、低精量（及占比），垃圾地址（即无效数据），以下表：数据总量100无效10有效90高精70完全匹配35不完全匹配20其它15低精20匹配精度相符10匹配精度局限性10然后对于高精匹配额，报表图2展示高精里面按匹配程度来划分（规则以下详见下表）完全匹配有效地址高精匹配时分词含14级，match_level>=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级，match_level>=9；不完全匹配剩余高精、非ps返回的即为不完全匹配其它Ps返回成果对于低精匹配数据，报表图3，图4进行了进一步表达，即图3是低精里面按匹配精度相符（src_level=match_level&match_level不为poi、门牌）、匹配精度局限性（src_level>match_level&match_level为poi、门牌且fillter非128），这部分能够认为是原始地址中质量不够的数据。图4则是部分匹配级别足够，但是未返回高精的数据体现，规则以下表：低精类型数量占比图3：匹配级别够filter非128POI-filter10POI-filter128POI-filter130POI-filter194POI-filter40POI-filter74POI-filter32POI-filter66POI-filter96附近（filter16）其它图4：匹配级别不够匹配级别不够-都市匹配级别不够-区县匹配级别不够-乡镇/街道匹配级别不够-村/社区匹配级别不够-道路其它无坐标地址原则化任务地址原则化是针对顾客提供的多个地址，通过对地址进行切词分级、智能匹配，结合机器学习和规则算法，提供顾客输入地址的原则化地址。在数据原则化中，会对原有数据进行地址要素新增、删除、修改等。图11地址原则化成果列表图SEQ图\*ARABIC12地址原则化成果分析地址关联任务图SEQ图\*ARABIC13地址关联成果地址关联办法支持定向关联和非定向关联两种类型：图SEQ图\*ARABIC14定向关联逻辑定向关联与非定向关联的区别：定向关联明确一种基础关联地址，例如房屋地址或者公安原则地址。定向关联地址中将输入数据中带有BaseAddr，BaseCode字段的（模板中规定必须包含）视为基础地址，后续全部业务地址与改基础地址进行地址关联，典型的应用场景以下两种：1）规划部门和地址应用部门统一使用房屋地址以及房屋编号进行业务关联，房屋地址数据+房屋地址编号（到户室）。2）公安部门及其对应业务部门统一使用公安原则地址以及公安原则地址ID号作为地址关联的基础数据.这两类数据都必须涉及两个基础字段：输入地址中将BaseAddr、BaseCode，这两个字为必须输入字段。需要进行两步操作：a)系统管理员通过系统配备将房屋地址（公安原则地址数据）上传到后台服务器，启动初始化配备任务，将含有BaseAddr，BaseCode的基础地址数据进行初始化入库，写入到后台数据库Relate_config配备表中。b)系统识别到顾客输入地址文献中涉及两个必须涉及的字段，启动地址关联的时候，走定向地址关联分支，对Relate_config配备表进行数据追加。非定向地址关联指的是顾客缺少统一的基础地址类数据，但是又需要对两个地址进行关联，这时候默认选择系统后台顺丰原则地址库作为关联参考基准。改来地址关联业务无需顾客指定基础字段。输入的两个待关联数据中都涉及了必须的Address字段即可开始关联任务。图SEQ图\*ARABIC15非定向关联逻辑地址关联指标设计地址关联涉及指标设计：地址关联成果指标设计1.总体关联率2.分多个分支统计数量及关联率（1）对数据最细的描述等级分类；（2）分为楼栋级别、户级别，两种粒度的关联总量数据预解决分类数据细分项数量描述等级数量关联类型数量关联率236294有效地址进行房间挂接的地址219656房间（M）196399幢（DML）10640.54%房间（DSH）17089087.01%楼栋号（B）8502幢（DML）632774.42%房间（DSH）8399.87%社区（C）724幢（DML）58680.94%房间（DSH）131.80%门牌号（S）9120幢（DML）662072.59%房间（DSH）2412.64%道路（R）90幢（DML）66.67%房间（DSH）0.00%其它4821幢（DML）3898.07%房间（DSH）307363.74%无效地址道路地址109幢挂接量149926.83%车库地址15358房间号挂接量17505679.70%多个楼栋号地址1171挂接总量累计19004886.52%地址关联任务完毕跑数后，同样存在数据报表和数据列表，以下：图16地址关联报表图17地址关联列表智能地址查询地址服务平台还提供地址-地图结合的查询服务，即智能地址查询服务，该服务提供正/逆地理编码两种上图查询，结合提供的高精细地图，可进行地址-地图结合。图SEQ图\*ARABIC16地址正反地理编码地址服务目录地址服务目录重要涉及正向地理编码、批量正向地理编码、逆地理编码、地址原则化服务接口、地址关联服务接口。此部分单独形成文档，详见《地址服务管理平台-地址服务目录》文档。系统管理服务配备地理编码服务地址配备。提供配备地理编码服务地址，测试连接地图服务地址配备（可选）提供配备地图服务地址，配备生效后，可在单条查询功效处加载地图，查询后定位显示在地图上。版本总览展示现在客户端版本（含地理编码服务地址）、geo服务（算法、配备、索引）、ps服务（算法、索引）的版本信息、文献途径。图SEQ图\*ARABIC17服务配备应用启动停止提供应用启动停止按钮，重启对应服务（geo、ps），完毕后刷新现在总览页面，更新对应版本信息。授权信息：展示地理编码服务授权信息、使用期。地址补录管理对于顾客已知的精确地址，在运行管理中，提供地址白名单的管理，形成地址补录功效，当顾客的业务数据与补录地址一致时，将会匹配返回补录地址。地址补录提供补录地址的增、删、改、查功效。图SEQ图\*ARABIC18提供补录地址坐标拾取功效补录地址上传提供上传文献模板，顾客可批量更新白名单功效，新地址为新增，已存在地址覆盖。图19地址补录名单日志文献导出提供手动方式导出存量C++日志，可附加筛选条件（如时间范畴）。该模块功效尚在开发中，现在版本暂未提供。顾客系统管理地址服务平台自带一套顾客管理系统，管理方式为角色管理-顾客管理-权限内容管理模式，即原则的RBAC模式；就是顾客通过角色与权限进行关联，从而获得某些功效的使用权限。权限被赋予给角色