地址服务平台用户手册.docx

1、地址服务平台用户手册地址服务平台用户手册丰图科技（深圳）有限公司1.产品概述1.1 产品定位地址信息是城市管理以及人们便利生活的重要基础，随着互联网地图应用的开放，C端用户通过地图应用获取跟空间位置相关需求得到了很大程度的满足。但对于企业和政府，地址数据的产生以及管理有着更为迫切的需求。地址数据的管理目前面临两大问题：地址数据的分散管理导致标准不一，地址数据无论从哪个部门的应用都存在不准确的现象。我国地址信息分散在公安、民政厅、住建、市场监督等多个部门，不同部门之间的地址信息资源相对独立，遵循各自的行业标准，其地址格式和命名规范都不一致，缺乏统一的地名标准化机制；而政府各职能部门的信息系统在采

2、集地址时大多采用手工录入，地址的规范性和准确性得不到保证，给城市管理和社会治理带来诸多困难和不便；第二大问题为地址的更新问题。一方面城市化进程的加速导致地址更新的现实情况增加，而地址数据获取和管理与地址数据应用脱节，导致实际上政府部门建立起来的地址库是难以更新并使用的。为此，本产品定位为地址管理服务平台，地址管理服务平台首先会将丰图地理编码引擎进行标准化产品包装，作为地址管理服务平台的后台主体，地址管理服务平台提供地址数据的接入、地址数据的处理、地址服务实时接口提供以及服务管理功能。后续该平台会对接地址数据的生存平台，本版本仅提供少量地址数据的更新入口。1.2 用户分析地址服务管理平台的用户根

3、据其拥有的地址数据情况分成两大类型：1、地址应用类用户：地址应用类用户再其业务场景中积累了大量的地址数据，需要对这些数据进行空间化，而其本身缺乏地址数据坐标采集和核实的能力。地址信息空间化的准确程度对其业务场景的使用效果起到关键性作用。比如政务中心的各类办证窗口，金融部门的用户地址信息管理等。2、地址管理类用户：地址管理类用户主要是目前政府地址管理部门，主要是民政、公安、住建、自然资源、市场监督管理等。下表为本产品可能涉及到的政府业务管理域。序号部门业务域业务线序号业务事项1公安部门人口基本信息管理常住人口管理（户籍管理)1常住人口管理（户籍管理)2户籍管理流动人口管理3流动人口管理4暂（居）

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房

5、屋权属登记管理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单独选址建设用地报批管理建设用

6、地供应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内资企业集团

7、注销登记个体登记管理82个体开业登记83个体变更登记84个体歇业登记外商投资企业登记管理85外商投资企业设立登记86外商投资企业变更(备案)登记87外商投资企业注销登记外商投资分支机构登记管理88外商投资分支机构设立登记89外商投资分支机构变更(备案)登记90外商投资分支机构注销登记外国(地区)企业常驻代表机构登记管理91外国(地区)企业常驻代表机构设立登记92外国(地区)企业常驻代表机构变更(备案)登记93外国(地区)企业常驻代表机构注销登记外商投资企业集团设立登记管理94外商投资企业集团设立登记95外商投资企业集团变更登记96外商投资企业集团注销登记企业其他登记管理97企业迁入登记98企业

8、迁出登记99增、补营业执照1.3 数据架构地址服务管理平台的数据架构如下图所示：图 1 数据架构图地址管理服务平台对接用户两类数据：一种是通过用户系统调用服务接口输入的地址数据，地址管理服务通过接口返回对应标准地址以及相关扩展信息；一类是直接对接用户的批量待处理数据，目前支持用户上传文件以及连接用户数据库两种方式来接入用户数据。接入数据中又可以根据用户输入的数据内容分为地址管理类以及地址应用类。一般地址应用类用户输入地址仅包括地址描述类输入这类用户关心平台返回的经纬度信息，主要为了给这类信息做空间化处理，如上图等；地址管理类用户除了输入地址描述之外，可能包括地址坐标。原因是这类用户本省就是地址

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

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

11、通用户和系统管理员，普通用户后续会根据用户的业务类型进行角色划分，包括地址管理员和地址应用人员。普通用户使用本产品主要完成两大类工作，关注地址描述细节和关注地址坐标。关注地址描述细节的细分为地址标准化以及地址关联关系建立。关注地址坐标的需要获取地址坐标并上图查看。普通用户的业务逻辑如下图所示：图 2 普通用户业务逻辑系统管理员负责对目前产品依赖的底层算法和数据进行更新和版本管理，并对系统对外提供的接口服务进行服务管理，其业务逻辑如下图所示：图 3 管理员业务逻辑2.功能说明2.1产品登录页地址服务管理平台登录页，同时也是产品的宣传介绍页，提供登录功能，用户点击登录，输入分配的账号密码，登录至平

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

13、数据包括文件和数据库格式。后期版本会扩展数据接入的类型，包括WebService接口类型、大数据管理平台数据接入等。数据管理模块本版本规划了三个子模块：数据接入模块、数据列表模块、我的数据模块。登陆用户进入系统之后，通过数据接入模块上传或者链接对应的数据库，上传对应数据之后，其相关数据进入到对应用户的数据列表中。图 4 数据接入界面进入数据接入页面之后，用户可选择使用数据库接入，或者直接拖拽CSV文件进入系统，如果是数据库接入，则会要求用户选择表及字段，对CSV，则需要用户选择字段，数据上传过程对必须字段进行检查，满足格式要求的数据上传可提示上传成功。平台系统对数据格式要求为：数据库：ORAC

14、LE 数据库文件：CSV文件，编码格式限定为UTF-8无编码字段：上传过程中，用户必须指定数据的ID，ADDRESS字段，可选择指定BASECODE字段，当指定BASECODE字段后，该份数据就会成为挂接母版数据，且会追加存入平台挂接系统的母库中。图 5 CSV接入页面图 6 数据库接入界面图 7 我的数据列表界面2.5.2任务管理模块数据接口到对应用户的数据列表之后，用户可进入到任务中心创建对应任务。本版本任务中心支持三种地址任务的创建：地址匹配任务（对地址进行地址编码返回对应地址的经纬度信息，并对用户输入地址和匹配结果进行统计分析）、地址标准化任务（对用户输入地址进行标准化处理，并对比标准

15、化前后的结果对输入地址所做操作进行统计分析）、地址关联任务（用户输入两份地址数据，对改两份地址数据进行地址关联操作，地址关联分为定向关联和非定向关联两大类型）。2.5.2.1地址匹配任务图 8 地址任务创建图 9 任务列表地址匹配提供单条地址进行地理编码匹配功能，查询完毕后，展示返回结果。若已配置地图并生效，查询坐标加载到地图上进行展示。提供坐标拾取功能，通过在地图上点选位置获得该位置的坐标。图 10 地址匹配结果分析匹配结果上图查看图 11 匹配结果上图展示地址匹配指标分析创建任务创建地理编码批量任务，输入方式可选择上传文件或指定目录，还可选择输出目录（不选择时默认完成任务时进行下载），结果

16、文件格式为.db。填写任务描述，创建生产地理编码任务。当输入文件带x，y坐标，执行任务时计算与地理编码匹配坐标的距离（只计算高精部分），输出结果增加距离字段。任务列表展示任务信息，包含名称、描述、创建人、数据量、创建时间、预计完成时间、完成时间、状态等，任务完成后提供结果文件、统计报表下载。当前有任务执行时，新创建的任务显示为等待执行，待当前任务完成后按照创建时间依次执行结果文件标准结果文件字段包含输入地址id、address、adcode，输出字段is_vaild，result_adcode，confidence、percision、err、result_type、match_address

17、，key，xcoord，ycoord。由管理员创建的特殊创建任务生成的任务结果包含所有字段。结果文件格式包含.db，根据创建任务选择的格式输出下载，下载为.ZIP压缩格式。分析报告统计图：以饼图，柱状图的形式展示当前批次数据有效、无效占比，以及有效数据中的高低精占比。报表定义：第一图为以饼图形式展示数据总量、有效数据量（及占比）、无效数据量（及占比），以及高精量（及占比）、低精量（及占比），垃圾地址（即无效数据），如下表：数据总量100无效10有效90高精70完全匹配35不完全匹配20其他15低精20匹配精度相符10匹配精度不足10然后对于高精匹配额，报表图2展示高精里面按匹配程度来划分（规则

18、如下详见下表）完全匹配有效地址高精匹配时1分词含14级，match_level=14;2分词含13级and不含14级，match_level=13；3分词含12级and不含13、14级，match_level=12；4分词含11级and不含12、13、14级，match_level=11；5分词含10级and不含11、12、13、14级，match_level=10；6分词含9级and不含10、11、12、13、14级，match_level=9；不完全匹配剩余高精、非ps返回的即为不完全匹配其它Ps返回结果对于低精匹配数据，报表图3，图4进行了进一步表示，即图3是低精里面按匹配精度相符（sr

19、c_level=match_level&match_level不为poi、门牌）、匹配精度不足（src_levelmatch_level&match_level为poi、门牌且fillter非128），这部分可以认为是原始地址中质量不够的数据。图4则是部分匹配级别足够，但是未返回高精的数据表现，规则如下表：低精类型数量占比图3：匹配级别够filter非128POI-filter10POI-filter128POI-filter130POI-filter194POI-filter40POI-filter74POI-filter32POI-filter66POI-filter96附近（filter

20、16）其它图4：匹配级别不够匹配级别不够-城市匹配级别不够-区县匹配级别不够-乡镇/街道匹配级别不够-村/社区匹配级别不够-道路其它无坐标地址标准化任务地址标准化是针对用户提供的多种地址，通过对地址进行切词分级、智能匹配，结合机器学习和规则算法，提供用户输入地址的标准化地址。在数据标准化中，会对原有数据进行地址要素新增、删除、修改等。图 11 地址标准化结果列表图 12 地址标准化结果分析地址关联任务图 13 地址关联结果地址关联方法支持定向关联和非定向关联两种类型：图 14 定向关联逻辑定向关联与非定向关联的区别：定向关联明确一个基础关联地址，比如房屋地址或者公安标准地址。定向关联地址中将输

21、入数据中带有BaseAddr，BaseCode字段的（模板中要求必须包含）视为基础地址，后续所有业务地址与改基础地址进行地址关联，典型的应用场景如下两种：1）规划部门和地址应用部门统一使用房屋地址以及房屋编号进行业务关联，房屋地址数据+房屋地址编号（到户室）。2）公安部门及其对应业务部门统一使用公安标准地址以及公安标准地址ID号作为地址关联的基础数据.这两类数据都必须包括两个基础字段：输入地址中将BaseAddr、BaseCode，这两个字为必须输入字段。需要进行两步操作：a)系统管理员通过系统配置将房屋地址（公安标准地址数据）上传到后台服务器，启动初始化配置任务，将含有BaseAddr，Ba

22、seCode的基础地址数据进行初始化入库，写入到后台数据库Relate_config配置表中。b)系统识别到用户输入地址文件中包括两个必须包括的字段，启动地址关联的时候，走定向地址关联分支，对Relate_config配置表进行数据追加。非定向地址关联指的是用户缺乏统一的基础地址类数据，但是又需要对两个地址进行关联，这时候默认选择系统后台顺丰标准地址库作为关联参考基准。改来地址关联业务无需用户指定基础字段。输入的两个待关联数据中都包括了必须的Address字段即可开始关联任务。图 15 非定向关联逻辑地址关联指标设计地址关联包括指标设计：地址关联结果指标设计1. 总体关联率2. 分多个分支统计

23、数量及关联率（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

24、幢（DML）3898.07%房间（DSH）307363.74%无效地址道路地址109幢挂接量149926.83%车库地址15358房间号挂接量17505679.70%多个楼栋号地址1171挂接总量合计19004886.52%地址关联任务完成跑数后，同样存在数据报表和数据列表，如下：图 16 地址关联报表图 17 地址关联列表2.6智能地址查询地址服务平台还提供地址-地图结合的查询服务，即智能地址查询服务，该服务提供正/逆地理编码两种上图查询，结合提供的高精细地图，可进行地址-地图结合。图 16 地址正反地理编码2.7地址服务目录地址服务目录主要包括正向地理编码、批量正向地理编码、逆地理编码、地

25、址标准化服务接口、地址关联服务接口。此部分单独形成文档，详见地址服务管理平台-地址服务目录文档。2.8系统管理2.8.1服务配置地理编码服务地址配置。提供配置地理编码服务地址，测试连接地图服务地址配置（可选）提供配置地图服务地址，配置生效后，可在单条查询功能处加载地图，查询后定位显示在地图上。2.8.2版本总览展示目前客户端版本（含地理编码服务地址）、geo服务（算法、配置、索引）、ps服务（算法、索引）的版本信息、文件路径。图 17 服务配置应用启动停止提供应用启动停止按钮，重启相应服务（geo、ps），完成后刷新当前总览页面，更新相应版本信息。授权信息：展示地理编码服务授权信息、有效期。2

26、.8.3地址补录管理对于用户已知的精确地址，在运营管理中，提供地址白名单的管理，形成地址补录功能，当用户的业务数据与补录地址一致时，将会匹配返回补录地址。地址补录提供补录地址的增、删、改、查功能。图 18 提供补录地址坐标拾取功能补录地址上传提供上传文件模板，用户可批量更新白名单功能，新地址为新增，已存在地址覆盖。图 19 地址补录名单2.8.4日志文件导出提供手动方式导出存量C+日志，可附加筛选条件（如时间范围）。该模块功能尚在开发中，目前版本暂未提供。2.9用户系统管理地址服务平台自带一套用户管理系统，管理方式为角色管理-用户管理-权限内容管理模式，即标准的RBAC模式；就是用户通过角色与

27、权限进行关联，从而获得某些功能的使用权限。权限被赋予给角色，而不是用户，但是一个用户可以拥有若干个角色，当一个角色被赋予给某一个用户时，此用户就拥有了该角色所包含的功能权限。用户管理架构如下：图 20 用户管理架构2.10程序安装基于可执行程序完成geo服务、客户端等相关系统的一键安装。完整组件安装包含如下：客户端Geo（程序+索引+算法配置）Pois（程序+索引）黑白名单（mysql）地图服务可选可选可选2.10.1基本配置可选择本机或指定目标服务器安装，支持windows、Linux（推荐）操作系统，可指定安装目录、服务端口。2.10.2可选配置 可扩展安装poi搜索服务、地址补录匹配、以

28、及基础地图服务。2.11服务配置算法、配置、索引版本、服务地址总览2.12性能需求说明系统软件支持64位操作系统。平台操作简便，具有高稳定、较强的容错能力，支持247的服务能力。在平台出现故障后应10小时内到达现场，12小时内查找出问题原因并提出解决方案。（1）系统的可靠性：系统要能具备一定的检错和容错能力，要有较强的自我恢复能力；保证系统能够持续（724小时）无故障运行。同时系统具备出错处理、容错能力、冗余备份能力等。（2）系统的可操作性：系统设计时要尽可能的满足用户的操作习惯与不同层次办公人员的使用需要。（3）系统的可维护性：体现在易分析性，易更改性、易测试性、稳定性、使用模块化的结构等方面，保证系统维护管理简明、方便、有效。（4）系统的反应速度