地理角色

制作地图时，需要根据地理信息确认在地图上的位置。地点模式是根据地理名称，国家、一级行政区、二级行政区、三级行政区来定位在地图上的位置。在使用地点模式定位时，首先需要对地理名称进行地理角色转化。即将地理名称字段与系统中对应的地理位置名称进行匹配，匹配成功时代表该地理信息能够在地图上显示。

下面详细的介绍地理角色及其使用方法。

地理角色种类

地理角色包含四种类型：国家、一级行政区、二级行政区、三级行政区。目前系统预置了中国和美国各级行政区的数据，其他国家的各级行政区数据需要用户适配地理数据文件。

地理角色转化

可以通过下面两种方法将地理信息字段转化为地理角色字段。

方法一：在地图编辑页面的数据区域，点击需要转化的地理信息的下拉箭头，在地理角色中选择与地理信息对应的行政区域。

方法二：在数据集->字段管理中，根据需要转化的地理信息的别名，点击相应字段类型的下拉箭头，在地理角色中选择与地理信息对应的行政区域。

地理角色匹配

地理角色转换过程中，如果地理信息字段没有匹配到对应的地理角色时，会弹出地理角色匹配窗口，让用户对未匹配成功的字段进行手动匹配。匹配窗口左侧使用地图展示地理角色匹配情况，匹配成功的高亮显示。右侧使用列表显示匹配情况，未匹配成功的用红色标注。

点击未匹配成功的项宜兴，搜索宜兴所在省份城市，然后选择对应的行政区。示例中使用二级行政区转换，所以只能匹配无锡市，如果使用一级行政区转换，则宜兴匹配为江苏省。 所有未匹配项都处理完后，点击确定。

提示

匹配规则要求仅在当前行政层级匹配，比如地理角色选择一级行政区，北京市海淀区这个字段只能匹配为北京市，不能匹配到三级行政区。 对已经匹配成功的地理字段也支持手动修改对应的行政区。 三级行政区名称不唯一，如南京市有鼓楼区，徐州市也有鼓楼区，三级行政区进行地理角色匹配时，会将三级行政区与省、市进行关联，使三级行政区名称唯一。 这种场景要求省、市级字段必须进行地理角色转换。

地理角色字段作图

将地理信息转化为地理角色后，可以开始制作地图。

• 简易地图中，维度字段必须是地理角色字段，所以将地理角色字段直接拖入就可以生成地图。

• 分层地图中首先确认图层的定位模式。当定位模式为地点模式时，拖入地理角色字段后可以生成地图。当定位模式为经纬度模式时，无须进行地理角色转换，直接拖入后生成地图。

地理数据适配

系统预置了中国和美国两个国家的各级行政区地理数据，如果需要展示其他国家，如日本、加拿大、澳大利亚等国家各级行政区数据，需要用户适配相应国家的地理数据文件，并上传到{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[]

地理数据文件请参考中国地理数据文件示例。

大区地图

在使用地图分析数据时，常常涉及区域的概念。比如天气预报中常提及华北地区有大到暴雨，这里的华北地区不是某个具体省市，可能是几个省或者几个城市连起来的一个区域。针对这种情况可以使用地理角色列值分组功能，将地理角色中的字段根据实际区域组合成一个新的地理角色字段，使用新的地理角色字段制作地图，这种地图通常称为大区地图。

地理角色分组

地理角色字段与其他类型数值的列值分组一样，在数据集的字段管理中，点击地理角色字段的三点菜单，进行列值分组。

在列值分组界面，创建分组，并将地理角色拖入新的分组中。

分组后的地理角色形成了新的字段，拖入地图中生成大区地图。