1. 概述
1.1 版本
| FineBI 版本 | 功能变动 |
|---|---|
| 5.1.14 | 地图配置界面新增「同步地理文件」按钮；地图 json 文件在工程上新增或者替换时，点击该按钮，即可生效 |
| 5.1.24 | 「地理信息>区域」支持合并已有地理区域为新区域，支持圆形选区，且新增内置目录「中国行政区」。详情参见第 4 章 |
1.2 功能简介
「地理信息」是配置地图的区域边界和点经纬度信息的地方，即设置实际地理信息的入口。可以新增地理信息文件，也可以对内置的地理信息进行修改。
如下图所示，地理信息编辑界面左侧为地图层级目录，右侧为对应的地图编辑界面，分为区域和点，点击可进行切换。
2. 界面简介
对应标号区域的功能说明如下表所示：
| 序号 | 功能 | 说明 |
|---|---|---|
| 1 | 地理信息目录 | 目录名称即地图边界名称。支持添加目录、复制目录、删除目录、对目录重命名 |
| 2 | 地图类型 | 选择地图类型为「区域地图」还是「点地图」 |
| 3 | 地图编辑及展示 | 选择编辑工具后，可在地图上进行编辑操作，保存后即时展示效果 点击区域时，弹出区域信息，包括名称、中心点以及一些区域编码等。可手动修改，也可删除该区域 |
| 4 | 编辑工具 | 从上到下依次为：放大、缩小、多边形选区、矩形选区、圆形选区、合并区域、编辑区域边界、删除区域 |
| 5 | 区域列表 | 地理区域信息列表，可直接在列表中修改名称、经度和纬度；合并区域时可在列表中勾选区域进行合并 |
| 6 | 保存/重置 | 修改配置后，点击「保存」即可保存修改的所有配置，保存成功设计器中即可生效 在未点击「保存」之前，点击「重置」，可还原配置到修改前的状态 |
| 7 | 同步地理文件 | 在 %BI_HOME%\webapps\webroot\WEB-INF\assets\map 目录下，手动添加、删除或修改 geographic (地理文件)、image（自定义图片）及其任意 JSON 文件内容时，需要点击「同步地理文件」按钮才能生效 |
3. 新建/复制目录
3.1 新建目录
在地图层级目录中，点击右上角的 + 按钮可在当前选中目录下新建目录，该新建目录即为选中目录的下一层级，目录的层级即对应地图的钻取关系（若某地区没有层级，例如上海市，则不能实现钻取；若想实现钻取，需要在上海市下新建json文件）。
如下图所示，选中 world 层级后单击 + 按钮，出现创建地理信息地图设置，输入文件名。
注：新增目录前，必须要选中 world 目录，且只能在 world 目录下添加新目录。
点击确定保存该文件名，则在 world 层级下即新增自定义区域地图层级，将鼠标悬浮到目录上时，出现操作按钮可对该目录进行编辑和删除的操作，如下图所示：
3.2 复制目录
复制目录时，需选中你想要的地理信息目录，在弹出框中设置新目录的「文件名称」和「父级目录」，最后点击「确定」即可。如下图所示：
注1：不支持连同子目录一起复制，仅支持复制选中的目录文件。
注2：复制的目录文件，包含原目录文件的地理信息。
4. 区域
点击左侧对应的文件位置，右侧则切换成对应的地图编辑区域界面，比如我们点击内置的中国上海市，则右侧区切换成上海市的区域范围。如下图所示：
FineBI 支持对内置的地图区域进行编辑，也支持对新增的目录层级设置区域范围。区域编辑界面包含的操作如下，有放大缩小、添加多边形矩形形状、编辑删除层级等。如下图所示：
4.1 放大缩小
放大缩小即查看该地图时显示的大小缩放的功能，比如我们对显示的上海市区域图单击放大按钮，则该地图即放大显示，如下图所示：
注：除了单击放大/缩小按钮可以放大或缩小地图区域外，在地图中滚动鼠标的滚轮也可以实现地图的缩放。
4.2 编辑地图区域
编辑形状区域地图时，按照工具提示绘制自定义区域。画成以后需输入区域名和区域中心点经纬度（标签显示的位置），输入以后点击「保存」即添加成功。
以多边形工具为例，操作步骤如下：
1）点击「多边形」工具，点击开始绘制，双击鼠标左键或单击鼠标右键完成绘制，绘制结束点击「完成」，如下图所示：
2）可以更改区域名称，不想要这个区域地图可以删除后重新绘制，点击「保存」按钮，这张区域地图就绘制好了，如下图所示
4.3 合并区域
若地图中有可选的区域，在选择「合并」工具后，可点击地图中的区域或勾选列表中的区域进行合并。操作演示视频如下：
4.4 编辑/删除层级
点击编辑层级则可以编辑当前地图中已存在的区域。如下图所示，单击编辑层级后，到地图中拖拽已存在的点即可修改区域范围，修改完成后单击保存按钮（点击取消来撤销更改），层级修改成功。如下图所示：
5. 点
单击地图编辑界面的点框即可切换到点界面，包括地图点编辑区域及数据单元格编辑区域，如下图的内置上海市地图：
点界面可进行的操作与区域类似，包含放大缩小地图、编辑删除层级、添加标记点等，其中添加标记点可以在地图点编辑区域操作或者数据单元格区域编辑。层级操作则与上节区域操作类似，这里不再重复介绍。
5.1 画标记点
单击画标记点按钮以后，鼠标处即出现标记点符号，将标记点拖动到需要放置在地图中的位置，点击来放置并输入区域名，单击「保存」则新增成功。
右侧数据单元格即出现刚刚新增的单元格信息，并自动获取该设置点的经纬度，如下图所示：
5.2 单元格操作
5.2.1 编辑表数据
若想要从数据单元格操作的话，单击单元格时，即选中该单元格所在的整行表格。当该行表格处于被选中状态时，再次点击该行表格中的任一单元格，可对该单元格内容进行编辑。
注：只有当点击了表格行以外区域时，该行表格才为取消选中状态。
5.2.2 添加/删除表数据
除了编辑还可以添加或删除行，单击 「添加」按钮即新增行，输入点名称、经度、纬度数据即可，如下图所示，添加了点 123 及对应经纬度。
单击单元格，选择 「删除」按钮，即可删除该行数据。点选表格的同时使用 ctrl 键（苹果系统也使用 ctrl 键）或是直接框选多行表格，可以选中多行表格，进行多行数据的删除操作。
5.2.3 导入数据
单击「导入数据」按钮即可导入点数据信息，只可选择 excel 对应的文件格式。导入 excel 文件需要的格式为三列数据，第一列为名称，第二列为经度，第三列为纬度。用户导入的点信息必须按照以上规则才能正确导入。
导入成功后在单元格即出现导入的数据，左侧地图中显示导入点数据对应的标记，如下图所示：
6. 保存/重置
在 %BI_HOME%\webapps\webroot\WEB-INF\assets\map 目录下，手动添加、删除或修改 geographic (地理文件)、image（自定义图片）及其任意 JSON 文件内容，需要进入「地图配置」，点击右上角「同步地理文件」按钮，才能生效。
所以在「保存」后，重置不再生效；在「保存」之前，点击「重置」可恢复到修改之前的状态。
7. 同步地理文件
在 %BI_HOME%\webapps\webroot\WEB-INF\assets\map 目录下，手动添加、删除或修改 geographic (地理文件)、image（自定义图片）及其任意 JSON 文件内容，需要进入「地图配置」，重启 BI 工程或者在平台点击地图配置界面的右上角「同步地理文件」按钮，才能生效。
8. 应用
地图信息编辑并保存成功以后，在组件编辑中匹配 地理角色 时，即可以选择匹配到刚刚设置的地理信息，如下图所示：
