地理信息

1.1 版本

1.2 功能简介

「地理信息」是配置地图的区域边界和点经纬度信息的地方，即设置实际地理信息的入口。可以新增地理信息文件，也可以对内置的地理信息进行修改。

如下图所示，地理信息编辑界面左侧为地图层级目录，右侧为对应的地图编辑界面，分为区域和点，点击可进行切换。

2.1 界面简介

界面如下图所示：

对应标号区域的功能说明如下表所示：

2.2 新建/复制目录

2.2.1 新建目录

在地图层级目录中，点击右上角的 + 按钮可在当前选中目录下新建目录，该新建目录即为选中目录的下一层级，目录的层级即对应地图的钻取关系（若某地区没有层级，例如上海市，则不能实现钻取；若想实现钻取，需要在上海市下新建json文件）。

如下图所示，选中 world 层级后单击 + 按钮，出现创建地理信息地图设置，输入文件名。

新建的目录在「父级目录」下，将鼠标悬浮到该目录上时，出现操作按钮可对该目录进行复制、编辑、删除的操作。如下图所示：

2.2.2 复制目录

复制目录时，需选中你想要的地理信息目录，在弹出框中设置新目录的「文件名称」和「父级目录」，最后点击「确定」即可。如下图所示：

注1：不支持连同子目录一起复制，仅支持复制选中的目录文件。

注2：复制的目录文件，包含原目录文件的地理信息。

2.3 区域

2.3.1 选区工具

选中某个目录，在地图编辑框中选择选区工具，按照工具提示绘制自定义区域，绘制完成时会弹出默认区域名和中心点的配置框，可自行修改。

多边形、矩形、圆形选区工具操作演示视频如下所示：

2.3.2 合并区域

若地图中有可选的区域，在选择「合并」工具后，可点击地图中的区域或勾选区域列表中的区域进行合并。操作演示视频如下所示：

注：不支持取消合并，在没有点击右上角「保存」之前，可使用「重置」恢复到修改前的状态。

2.3.3 编辑/删除工具

若地图中有可编辑的区域，选择「编辑」工具后，可对区域形状、大小等进行修改。选择「删除」工具后，点击区域删除，点击「完成」即删除成功。

操作演示视频如下所示：

2.4 点

2.4.1 标记点工具

同一个目录的「区域」和「点」类型互不影响，若要改变点地图信息，选中目录后再选择「点」修改即可。点地图无选区工具、合并区域工具，支持标记点工具。

如下图所示：

2.4.2 单元格操作

1）编辑表数据

若想要从数据单元格操作的话，单击单元格时，即选中该单元格所在的整行表格。

当该行表格处于被选中状态时，再次点击该行表格中的任一单元格，可对该单元格内容进行编辑。

只有当点击了表格行以外区域时，该行表格才为取消选中状态。

2）添加/删除表数据

除了编辑还可以添加或删除行，单击 「添加」按钮即新增行，输入点名称、经度、纬度数据即可，如下图所示，添加了点123 及对应经纬度。

单击单元格，选择 「删除」按钮，即可删除该行数据。点选表格的同时使用 ctrl 键（苹果系统也使用 ctrl 键）或是直接框选多行表格，可以选中多行表格，进行多行数据的删除操作。

3）导入数据

单击「导入数据」按钮即可导入点数据信息，只可选择 excel 对应的文件格式。导入 excel 文件需要的格式为三列数据，第一列为名称，第二列为经度，第三列为纬度。用户导入的点信息必须按照以上规则才能正确导入。

导入成功后在单元格即出现导入的数据，左侧地图中显示导入点数据对应的标记，如下图所示：

2.5 保存/重置

配置完成后，点击右上角「保存」按钮，自定义的地理信息会生成两个 JSON 文件保存到%BI_HOME%\webapps\webroot\WEB-INF\assets\map\geographic\对应目录下，分别是 名称-area.json 和 名称-point.json，如下图所示：

所以在「保存」后，重置不再生效；在「保存」之前，点击「重置」可恢复到修改之前的状态。

2.6 同步地理文件

在 %BI_HOME%\webapps\webroot\WEB-INF\assets\map 目录下，手动添加、删除或修改 geographic (地理文件)、image（自定义图片）及其任意 JSON 文件内容，需要进入「地图配置」，点击右上角「同步地理文件」按钮，才能生效。

地图信息编辑并保存成功以后，在组件编辑中匹配 地理角色 时，即可以选择匹配到刚刚设置的地理信息，如下图所示：

且区域地图中匹配到的是对应画的区域，点地图中匹配到的是对应的标记点。