地址服务平台用户手册.docx
《地址服务平台用户手册.docx》由会员分享，可在线阅读，更多相关《地址服务平台用户手册.docx（37页珍藏版）》请在冰豆网上搜索。
地址服务平台用户手册
地址服务平台用户手册
丰图科技（深圳）有限公司
1.产品概述
1.1产品定位
地址信息是城市管理以及人们便利生活的重要基础，随着互联网地图应用的开放，C端用户通过地图应用获取跟空间位置相关需求得到了很大程度的满足。
但对于企业和政府，地址数据的产生以及管理有着更为迫切的需求。
地址数据的管理目前面临两大问题：
地址数据的分散管理导致标准不一，地址数据无论从哪个部门的应用都存在不准确的现象。
我国地址信息分散在公安、民政厅、住建、市场监督等多个部门，不同部门之间的地址信息资源相对独立，遵循各自的行业标准，其地址格式和命名规范都不一致，缺乏统一的地名标准化机制；而政府各职能部门的信息系统在采集地址时大多采用手工录入，地址的规范性和准确性得不到保证，给城市管理和社会治理带来诸多困难和不便；第二大问题为地址的更新问题。
一方面城市化进程的加速导致地址更新的现实情况增加，而地址数据获取和管理与地址数据应用脱节，导致实际上政府部门建立起来的地址库是难以更新并使用的。
为此，本产品定位为地址管理服务平台，地址管理服务平台首先会将丰图地理编码引擎进行标准化产品包装，作为地址管理服务平台的后台主体，地址管理服务平台提供地址数据的接入、地址数据的处理、地址服务实时接口提供以及服务管理功能。
后续该平台会对接地址数据的生存平台，本版本仅提供少量地址数据的更新入口。
1.2用户分析
地址服务管理平台的用户根据其拥有的地址数据情况分成两大类型：
1、地址应用类用户：
地址应用类用户再其业务场景中积累了大量的地址数据，需要对这些数据进行空间化，而其本身缺乏地址数据坐标采集和核实的能力。
地址信息空间化的准确程度对其业务场景的使用效果起到关键性作用。
比如政务中心的各类办证窗口，金融部门的用户地址信息管理等。
2、地址管理类用户：
地址管理类用户主要是目前政府地址管理部门，主要是民政、公安、住建、自然资源、市场监督管理等。
下表为本产品可能涉及到的政府业务管理域。
序号
部门
业务域
业务线
序号
业务事项
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
增、补营业执照
1.3数据架构
地址服务管理平台的数据架构如下图所示：
图1数据架构图
地址管理服务平台对接用户两类数据：
一种是通过用户系统调用服务接口输入的地址数据，地址管理服务通过接口返回对应标准地址以及相关扩展信息；一类是直接对接用户的批量待处理数据，目前支持用户上传文件以及连接用户数据库两种方式来接入用户数据。
接入数据中又可以根据用户输入的数据内容分为地址管理类以及地址应用类。
一般地址应用类用户输入地址仅包括地址描述类输入这类用户关心平台返回的经纬度信息，主要为了给这类信息做空间化处理，如上图等；地址管理类用户除了输入地址描述之外，可能包括地址坐标。
原因是这类用户本省就是地址管理类用户，如民政、公安、测绘（地理信息中心等）他们本身就有地址数据采集建库管理的能力，需要将这类数据输入到我们的平台进行地址标准化处理或地址关联等。
并希望将这类地址数据反馈到平台依赖的顺丰标准地址库中这两类用户数据处理流程分别：
1、应用单位业务系统地址文本：
通过接入平台对数据抽取分离出地址文本数据，再经过分词、重构、标准化以及地址匹配等操作，形成标准地址，并将用户关心的地址经纬度、标准地址描述信息返回给用户。
2、应单位业务系统经纬度数据：
通过平台数据采集系统进入数据管理平台，选择地址标准化或关联方式等相关地址处理，返回用户关心的标准地址、经纬度信息、关联业务地址信息及业务ID等内容。
上述过程中地址匹配失败或者确实的通过后台管理系统进入缺失地址库，由系统运维人员将缺失地址库导出提供给丰图科技，丰图科技根据用户约定更新时间进行数据更新。
1.4功能矩阵
平台产品基础版本功能主要应对跑数功能的需求，标准版上增加了地图模块，能够进行地址搜索、匹配上图、坐标拾取等。
高级版主要针对公安行业定制化需求，增加地址标准化、业务关联等地址强需求。
表SFGeocoding功能矩阵
功能项
基础版
标准版
高级版
服务节点配置
√
√
√
白名单配置
√
√
√
许可管理
√
√
√
数据接入
√
√
√
任务管理
√
√
√
节点管理
√
√
√
指标分析统计
√
√
√
结果下载
√
√
√
结果预览
√
√
√
地图配置
√
√
坐标拾取
√
√
上图展示
√
√
POIS
√
√
地址服务目录
√
√
地址关联
√
地址标准化
√
1.5业务流程图
目前本版本的用户体系只包括了普通用户和系统管理员，普通用户后续会根据用户的业务类型进行角色划分，包括地址管理员和地址应用人员。
普通用户使用本产品主要完成两大类工作，关注地址描述细节和关注地址坐标。
关注地址描述细节的细分为地址标准化以及地址关联关系建立。
关注地址坐标的需要获取地址坐标并上图查看。
普通用户的业务逻辑如下图所示：
图2普通用户业务逻辑
系统管理员负责对目前产品依赖的底层算法和数据进行更新和版本管理，并对系统对外提供的接口服务进行服务管理，其业务逻辑如下图所示：
图3管理员业务逻辑
2.功能说明
2.1产品登录页
地址服务管理平台登录页，同时也是产品的宣传介绍页，提供登录功能，用户点击登录，输入分配的账号密码，登录至平台系统。
登录页对顺丰地址服务管理平台支持的三种层级的地址服务进行了介绍，包括AOI级地址服务、楼栋级地址服务、深度立体地址服务，并附带了顺丰地图介绍及联系方式。
2.2产品引导页
地址服务管理平台部署完成之后，输入引导页url进入地址服务管理功能引导部分，主要三大功能：
地址运营管理、地址示范应用、地址服务目录。
2.3地址运营管理
地址运营管理主要包括数据管理和任务管理两大功能，数据管理模块主要用于接入用户批量地址处理数据，任务管理用于管理用户创建的各类地址任务。
本版本支持的任务类型包括三大类型:
地址匹配、地址标准化、地址关联。
2.5.1数据管理模块
数据管理模块的主要功能用于接入用户的批量数据。
接入数据包括文件和数据库格式。
后期版本会扩展数据接入的类型，包括WebService接口类型、大数据管理平台数据接入等。
数据管理模块本版本规划了三个子模块：
数据接入模块、数据列表模块、我的数据模块。
登陆用户进入系统之后，通过数据接入模块上传或者链接对应的数据库，上传对应数据之后，其相关数据进入到对应用户的数据列表中。
图4数据接入界面
进入数据接入页面之后，用户可选择使用数据库接入，或者直接拖拽CSV文件进入系统，如果是数据库接入，则会要求用户选择表及字段，对CSV，则需要用户选择字段，数据上传过程对必须字段进行检查，满足格式要求的数据上传可提示上传成功。
平台系统对数据格式要求为：
✧数据库：
ORACLE数据库
✧文件：
CSV文件，编码格式限定为UTF-8无编码
✧字段：
上传过程中，用户必须指定数据的ID，ADDRESS字段，可选择指定BASECODE字段，当指定BASECODE字段后，该份数据就会成为挂接母版数据，且会追加存入平台挂接系统的母库中。
图5CSV接入页面
图6数据库接入界面
图7我的数据列表界面
2.5.2任务管理模块
数据接口到对应用户的数据列表之后，用户可进入到任务中心创建对应任务。
本版本任务中心支持三种地址任务的创建：
地址匹配任务（对地址进行地址编码返回对应地址的经纬度信息，并对用户输入地址和匹配结果进行统计分析）、地址标准化任务（对用户输入地址进行标准化处理，并对比标准化前后的结果对输入地址所做操作进行统计分析）、地址关联任务（用户输入两份地址数据，对改两份地址数据进行地址关联操作，地址关联分为定向关联和非定向关联两大类型）。
2.5.2.1地址匹配任务
图8地址任务创建
图9任务列表
地址匹配
提供单条地址进行地理编码匹配功能，查询完毕后，展示返回结果。
若已配置地图并生效，查询坐标加载到地图上进行展示。
提供坐标拾取功能，通过在地图上点选位置获得该位置的坐标。
图10地址匹配结果分析
匹配结果上图查看
图11匹配结果上图展示
地址匹配指标分析
●创建任务
创建地理编码批量任务，输入方式可选择上传文件或指定目录，还可选择输出目录（不选择时默认完成任务时进行下载），结果文件格式为.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展示高精里面按匹配程度来划分（规则如下详见下表）
完全匹配
有效地址高精匹配时
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是低精里面按匹配精度相符（src_level=match_level&match_level不为poi、门牌）、匹配精度不足（src_level>match_level&match_level为poi、门牌且fillter非128），这部分可以认为是原始地址中质量不够的数据。
图4则是部分匹配级别足够，但是未返回高精的数据表现，规则如下表：
低精类型
数量
占比
图3：
匹配级别够filter非128
POI-filter10
POI-filter128
POI-filter130
POI-filter194
POI-filter40
POI-filter74
POI-filter32
POI-filter66
POI-filter96
附近（filter16）
其它
图4：
匹配级别不够
匹配级别不够-城市
匹配级别不够-区县
匹配级别不够-乡镇/街道
匹配级别不够-村/社区
匹配级别不够-道路
其它
无坐标
地址标准化任务
地址标准化是针对用户提供的多种地址，通过对地址进行切词分级、智能匹配，结合机器学习和规则算法，提供用户输入地址的标准化地址。
在数据标准化中，会对原有数据进行地址要素新增、删除、修改等。
图11地址标准化结果列表
图12地址标准化结果分析
地址关联任务
图13地址关联结果
地址关联方法支持定向关联和非定向关联两种类型：
图14定向关联逻辑
定向关联与非定向关联的区别：
定向关联明确一个基础关联地址，比如房屋地址或者公安标准地址。
定向关联地址中将输入数据中带有BaseAddr，BaseCode字段的（模板中要求必须包含）视为基础地址，后续所有业务地址与改基础地址进行地址关联，典型的应用场景如下两种：
1）规划部门和地址应用部门统一使用房屋地址以及房屋编号进行业务关联，房屋地址数据+房屋地址编号（到户室）。
2）公安部门及其对应业务部门统一使用公安标准地址以及公安标准地址ID号作为地址关联的基础数据.这两类数据都必须包括两个基础字段：
输入地址中将BaseAddr、BaseCode，这两个字为必须输入字段。
需要进行两步操作：
a）系统管理员通过系统配置将房屋地址（公安标准地址数据）上传到后台服务器，启动初始化配置任务，将含有BaseAddr，BaseCode的基础地址数据进行初始化入库，写入到后台数据库Relate_config配置表中。
b）系统识别到用户输入地址文件中包括两个必须包括的字段，启动地址关联的时候，走定向地址关联分支，对Relate_config配置表进行数据追加。
非定向地址关联指的是用户缺乏统一的基础地址类数据，但是又需要对两个地址进行关联，这时候默认选择系统后台顺丰标准地址库作为关联参考基准。
改来地址关联业务无需用户指定基础字段。
输入的两个待关联数据中都包括了必须的Address字段即可开始关联任务。
图15非定向关联逻辑
地址关联指标设计
地址关联包括指标设计：
地址关联结果指标设计
1.总体关联率
2.分多个分支统计数量及关联率
（1）对数据最细的描述等级分类；
（2）分为楼栋级别、户级别，两种粒度的关联
总量
数据预处理
分类
数据细分项
数量
描述等级
数量
关联类型
数量
关联率
236294
有效地址
进行房间挂接的地址
219656
房间（M）
196399
幢（DML）
1064
0.54%
房间（DSH）
170890
87.01%
楼栋号（B）
8502
幢（DML）
6327
74.42%
房间（DSH）
839
9.87%
小区（C）
724
幢（DML）
586
80.94%
房间（DSH）
13
1.80%
门牌号（S）
9120
幢（DML）
6620
72.59%
房间（DSH）
241
2.64%
道路（R）
90
幢（DML）
6
6.67%
房间（DSH）
0.00%
其他
4821
幢（DML）
389
8.07%
房间（DSH）
3073
63.74%
无效地址
道路地址
109
幢挂接量
14992
6.83%
车库地址
15358
房间号挂接量
175056
79.70%
多个楼栋号地址
1171
挂接总量合计
190048
86.52%
地址关联任务完成跑数后，同样存在数据报表和数据列表，如下：
图16地址关联报表
图17地址关联列表
2.6智能地址查询
地址服务平台还提供地址-地图结合的查询服务，即智能地址查询服务，该服务提供正/逆地理编码两种上图查询，结合提供的高精细地图，可进行地址-地图结合。
图16地址正反地理编码
2.7地址服务目录
地址服务目录主要包括正向地理编码、批量正向地理编码、逆地理编码、地址标准化服务接口、地址关联服务接口。
此部分单独形成文档，详见《地址服务管理平台-地址服务目录》文档。
2.8系统管理
2.8.1服务配置
●地理编码服务地址配置。
提供配置地理编码服务地址，测试连接
●地图服务地址配置（可选）提供配置地图服务地址，配置生效后，可在单条查询功能处加载地图，查询后定位显示在地图上。
2.8.2版本总览
展示目前客户端版本（含地理编码服务地址）、geo服务（算法、配置、索引）、ps服务（算法、索引）的版本信息、文件路径。
图17服务配置
●应用启动停止
提供应用启动停止按钮，重启相应服务（geo、ps），完成后刷新当前总览页面，更新相应版本信息。
●授权信息：
展示地理编码服务授权信息、有效期。
2.8.3地址补录管理
对于用户已知的精确地址，在运营管理中，提供地址白名单的管理，形成地址补录功能，当用户的业务数据与补录地址一致时，将会匹配返回补录地址。
●地址补录
提供补录地址的增、删、改、查功能。
图18提供补录地址坐标拾取功能
●补录地址上传
提供上传文件模板，用户可批量更新白名单功能，新地址为新增，已存在地址覆盖。
图19地址补录名单
2.8.4日志文件导出
提供手动方式导出存量C++日志，可附加筛选条件（如时间范围）。
该模块功能尚在开发中，目前版本暂未提供。
2.9用户系统管理
地址服务平台自带一套用户管理系统，管理方式为角色管理-用户管理-权限内容管理模式，即标准的RBAC模式；就是用户通过角色与权限进行关联，从而获得某些功能的使用权限。
权限被赋予给角色，而不是用户，但是一个用户可以拥有若干个角色，当一个角色被赋予给某一个用户时，此用户就拥有了该角色所包含的功能权限。
用户管理架构如下：
图20用户管理架构
2.10程序安装
基于可执行程序完成geo服务、客户端等相关系统的一键安装。
完整组件安装包含如下：
客户端
Geo
（程序+索引+算法配置）
Pois
（程序+索引）
黑白名单
（mysql）
地图服务
√
√
可选
可选
可选
2.10.1基本配置
可选择本机或指定目标服务器安装，支持windows、Linux（推荐）操作系统，可指定安装目录、服务端口。
2.10.2可选配置
可扩展安装poi搜索服务、地址补录匹配、以及基础地图服务。
2.11服务配置
算法、配置、索引版本、服务地址总览
2.12性能需求说明
系统软件支持64位操作系统。
平台操作简便，具有高稳定、较强的容错能力，支持24×7的服务能力。
在平台出现故障后应10小时内到达现场，12小时内查找出问题原因并提出解决方案。
（1）系统的可靠性：
系统要能具备一定的检错和容错能力，要有较强的自我恢复能力；保证系统能够持续（7×24小时）无故障运行。
同时系统具备出错处理、容错能力、冗余备份能力等。
（2）系统的可操作性：
系统设计时要尽可能的满足用户的操作习惯与不同层次办公人员的使用需要。
（3）系统的可维护性：
体现在易分析性，易更改性、易测试性、稳定性、使用模块化的结构等方面，保证系统维护管理简明、方便、有效。
（4）系统的反应速度
升级会员 