1. 概述
1.1 应用场景
本章为用户详细介绍地理角色匹配的规则。
1.2 功能介绍
FineBI 的地理角色一共有四个层级，分别为国家/地区、省/市/直辖市、城市、区/县，用户可以在对应的层级下进行字段与地理角色的匹配。
2. 地理角色匹配
地理角色匹配实际上就是将地理信息中的地理角色与用户的字段进行匹配。
2.1 地理信息
进入「管理系统>地图配置>地理信息」，可以看到 FineBI 自带的地理信息中包含 world 和中国地图，并且中国地图下面包含省份、城市、区县三个层级，如下图所示：
进行地理角色字段匹配时，匹配的是区域。用户可以对地理角色进行自定义，更改地理角色的区域和名字，详细请参见：地理信息-区域
注：进行地理角色字段匹配时匹配不是点，无法直接进行点匹配。
2.2 匹配字段
将字段与地理信息中的地理角色进行匹配。
1）点击文本维度字段「下拉>地理角色」，可以看到四个层级国家/地区、省/市/自治区、城市、区/县，如下图所示：
2）根据字段选择对应的层级，选择「城市层级」。进入地理角色匹配设置页面，如下图所示：
注：直辖市匹配的是「省/市/自治区」层级，当前选择的是「城市」层级，所以下图「重庆市」、「天津市」等无法自动匹配。
3）当系统未能成功自动匹配时，可以点击下拉，选择地理角色，也可以通过搜索寻找。如下图所示：
4）点击「确定」，匹配完地理角色后，即可制作区域地图，详细请参见：区域地图
2.3 地理角色匹配规则
匹配数据只能在当前层级匹配，比如转为地理角色时选择省/市/自治区，那么只能匹配到第二层级省份数据，不能与其他层级的数据匹配。
在 FineBI 自带的地理信息中，直辖市在省市层级，直辖县在城市层级。例如本文 2.2 节，直辖市与自治区无法与城市层级(地级市)进行匹配。如何能让直辖市直接匹配城市层级可以参见：直辖市匹配地理角色(城市)
世界地图除中国外，其他国家和地区没有下一层级的地理信息。
多个字段匹配到同一区域，不会合并。例如：用户数据含有广东、广东省，则在匹配省份时，这两个字段都匹配到广东省，但是最后的显示结果不会合并，而是堆积显示。
3. 注意事项
地图配置里面的世界地图不会显示完整的其他国家地理信息。
但是 %FineBI%\webapps\webroot\WEB-INF\assets\map\geographic 下的 world-area.json 文件里有所有其他国家的地理信息，地理角色页是可以匹配全的。
