--- url: /v6.2/map-geographic-role.md --- # 地理角色 制作地图时，需要根据地理信息确认在地图上的位置。地点模式是根据地理名称，国家、一级行政区、二级行政区、三级行政区来定位在地图上的位置。在使用地点模式定位时，首先需要对地理名称进行地理角色转化。即将地理名称字段与系统中对应的地理位置名称进行匹配，匹配成功时代表该地理信息能够在地图上显示。 下面详细的介绍地理角色及其使用方法。 ## 地理角色种类 地理角色包含四种类型：国家、一级行政区、二级行政区、三级行政区。目前系统预置了中国和美国各级行政区的数据，其他国家的各级行政区数据需要用户适配[地理数据文件](#地理数据适配)。 ## 地理角色转化 可以通过下面两种方法将地理信息字段转化为地理角色字段。 方法一：在地图编辑页面的数据区域，点击需要转化的地理信息的下拉箭头，在**地理角色**中选择与地理信息对应的行政区域。 ![](/images/map-geographic-role-001.png) 方法二：在**数据集**->**字段管理**中，根据需要转化的地理信息的别名，点击相应**字段类型**的下拉箭头，在地理角色中选择与地理信息对应的行政区域。 ![](/images/map-geographic-role-002.png) ## 地理角色匹配 地理角色转换过程中，如果地理信息字段没有匹配到对应的地理角色时，会弹出地理角色匹配窗口，让用户对未匹配成功的字段进行手动匹配。匹配窗口左侧使用地图展示地理角色匹配情况，匹配成功的高亮显示。右侧使用列表显示匹配情况，未匹配成功的用红色标注。 ![](/images/map-geographic-role-006.png) 点击未匹配成功的项`宜兴`，搜索`宜兴`所在省份城市，然后选择对应的行政区。示例中使用二级行政区转换，所以只能匹配无锡市，如果使用一级行政区转换，则`宜兴`匹配为江苏省。 所有未匹配项都处理完后，点击确定。 > \[!TIP] 提示 > 匹配规则要求仅在当前行政层级匹配，比如地理角色选择一级行政区，北京市海淀区这个字段只能匹配为北京市，不能匹配到三级行政区。 > 对已经匹配成功的地理字段也支持手动修改对应的行政区。 > 三级行政区名称不唯一，如南京市有鼓楼区，徐州市也有鼓楼区，三级行政区进行地理角色匹配时，会将三级行政区与省、市进行关联，使三级行政区名称唯一。 这种场景要求省、市级字段必须进行地理角色转换。 ## 地理角色字段作图 将地理信息转化为地理角色后，可以开始制作地图。 * 简易地图中，维度字段必须是地理角色字段，所以将地理角色字段直接拖入就可以生成地图。 * 分层地图中首先确认图层的定位模式。当定位模式为地点模式时，拖入地理角色字段后可以生成地图。当定位模式为经纬度模式时，无须进行地理角色转换，直接拖入后生成地图。 ## 地理数据适配 系统预置了中国和美国两个国家的各级行政区地理数据，如果需要展示其他国家，如日本、加拿大、澳大利亚等国家各级行政区数据，需要用户适配相应国家的地理数据文件，并上传到`{HengShiHome}/conf/geo/upload`下。 每个国家地理数据文件包含该国家的一级行政区、二级行政区、三级行政区的地理数据，文件类型为 geojson，各行政区文件按照行政级别命名，如一级行政区命名为1.json，二级行政区命名为2.json，三级行政区命名为3.json，最后将该国家所有级别的行政区地理数据压缩为 zip 包，上传到系统`{HengShiHome}/conf/geo/upload`下，并重启系统。 地理数据压缩的 zip 包以该国家英文简称命名，如中国地理数据压缩包为 CN.zip，英国的为 GB.zip，加拿大的为 CA.zip。 地理数据文件中使用 properties 字段存储行政区唯一标识、行政区基础名称等信息，geometries 列存储地理位置信息，中心点由用户自行计算。属性 properties 由以下字段组成。 |字段名称|字段含义|是否必须|类型| |----|----|----|----| |name|行政区名称|是|String| |adcode|行政区唯一标识|是|String| |parentCode|父级行政区唯一标识|是，一级行政区可以不填，其他层级必填|String| |abbr|行政区缩写|否|String| |ChineseName|行政区中文名缩写|否|String| |fullChineseName|行政区中文名全称|否|String| |cp|中心坐标点（顺序\[经度、纬度]）|是|double\[]| 地理数据文件请参考[中国地理数据文件示例](/CN.zip)。 ## 大区地图 在使用地图分析数据时，常常涉及区域的概念。比如天气预报中常提及华北地区有大到暴雨，这里的华北地区不是某个具体省市，可能是几个省或者几个城市连起来的一个区域。针对这种情况可以使用地理角色列值分组功能，将地理角色中的字段根据实际区域组合成一个新的地理角色字段，使用新的地理角色字段制作地图，这种地图通常称为大区地图。 ### 地理角色分组 地理角色字段与其他类型数值的[列值分组](dataset-field-management.md#列值分组)一样，在**数据集**的**字段管理**中，点击地理角色字段的三点菜单，进行列值分组。 ![](/images/map-geographic-role-003.png) 在列值分组界面，创建分组，并将地理角色拖入新的分组中。 ![](/images/map-geographic-role-004.png) 分组后的地理角色形成了新的字段，拖入地图中生成大区地图。 ![](/images/map-geographic-role-005.png)