1. 概述
1.1 版本
| 报表服务器版本 | 功能变动 |
|---|---|
| 10.0.13 | 第 3 个 Tab 更名为：自定义GIS图层 |
| 10.0.17 | 新增「同步地理文件」按钮，实现不需要重启服务器即可同步更新地图 JSON 文件。详情参见本文 2.2.4 节 |
1.2 应用场景
决策系统的「管理系统」下有个「地图配置」功能，该功能可用于自定义地图边界和 GIS 图层。
1.3 功能介绍
地图配置功能共有三个配置项，分别为：
地理信息：可以自定义地图区域边界和点的经纬度。
自定义图片：使用自定义的图片作为地图边界。
自定义 GIS 图层：可以新增预定义 GIS 图层，设置图表时可以直接拿来用。
2. 地理信息
2.1 设置效果
地理信息：可以勾勒想要的区域地图或点地图。例如：
想要自定义一片华中区域，使用该区域作为地图的展示边界。如下图所示：
画好这样一个区域，保存之后，再去设置地图边界，发现新增了一个华中选项，如下图所示：
2.2 操作步骤
下面以区域地图为例，给出自定义地图边界的操作步骤。
2.2.1 新建目录
因为要自定义一个新地图边界，所以要先新建一个目录，作为该边界的名称，并在该目录处设置配置信息。
示例是定义区域地图边界，所以右侧地图编辑框上方要选择「区域」，如果是定义点地图，选择「点」就好，此处不展开。
选中左侧目录「world」，点击新增目录按钮 ，给目录一个名称，点击确定即可。
注：一定要先选中 world 下的目录再点新增按钮才能创建成功。
2.2.2 画区域
选中刚刚新建的目录，在右侧地图编辑框中使用画图工具勾勒出想要的区域效果，首尾连起来后，会弹出区域名和中心的配置框。
区域名填入跟新建的目录相同的名称，中心点选填，可以经纬度。保存好区域名和中心的的配置后，点击右上角保存按钮，该新区域边界即生成。如下图所示：
2.2.3 使用新边界
完成上述操作后，在设计器设置地图边界处，下拉可以即可看到自定义的地图边界，如 2.1 节设计器效果图所示。
2.2.4 同步地理文件
自定义的地理信息会生成两个 JSON 文件保存到%FR_HOME%\webapps\webroot\WEB-INF\assets\map\geographic\world目录下，分别是 名称-area.json 和 名称-point.json，如下图所示：
这些文件可以直接拷贝到服务器端使用，注意需要同时将「名称-area.json」和「名称-point.json」文件一起拷贝到同一目录下。拷贝完成后，点击决策系统右上角「同步地理文件」按钮，弹出确认同步的提示框，点击「确定」即可同步 JSON 文件。如下图所示：
注：在 %FR_HOME%\webapps\webroot\WEB-INF\assets\map 目录下，手动添加、删除或修改 geographic (地理文件)、image（自定义图片）及其任意 JSON 文件内容，都需要「同步地理文件」，地图模板应用才能生效。
另外需要注意的是，远程设计 时，若修改了地图配置，同步地理文件之后，还需点击设计器中地图类型下的「刷新」按钮。如下图所示：
注：10.0.17 之前版本的设计器中，需要重启服务器，这些文件才能生效。
3. 自定义图片
4. 自定义 GIS 图层
我们在配置地图时，是可以直接在设计器中直接自定义 GIS 背景的，但是它只能作用于当前报表，其他报表想要用只能再去设置，很麻烦。
在决策系统中配置，相当于预定义一个图层，可以作用于当前服务器下的所有地图。自定义 GIS 图层有 2 种方式：
tileLayer：详细介绍参见文档 自定义tileLayer图层 。
WMS：详细介绍参见 地图 。
5. 自定义 JSON 资源
5.1 资源下载
此处提供一些自定义的 JSON 资源可直接下载拷贝到对应目录下使用，文件中包含 FineReport 自带的一些 JSON 和用户自愿上传的 JSON。
| 点击下载文件 | 备注 |
|---|---|
| 商场平面图 | |
| 商场2楼平面图 | |
| 网页区域热力图 | |
| 柜台平面图 | |
| 台湾省地图 | |
| 世界地图 & 中国各省市地图 |
如果用户自定义 JSON 资源时，只自定义了其中一个 JSON 文件，需手动添加另一个 JSON 文件，再「同步地理文件」。此处提供两个空的 JSON 文件：空JSON文件.rar，使用时将名称修改为自已定义的名称即可。
注：如果有自愿提供自己自定义的 JSON 地图的，可在 论坛发帖 ，若被采纳会给予 F 币奖励。
5.2 JSON 文件格式
除了在前端制作地图的方式外，还可以后台直接编写，具体 JSON 格式如下所示：
注：若用户自己编写地图 JSON，需要注意：[新]地图中心点的算规则 。
5.2.1 区域地图
5.2.2 点地图
6. 注意事项
6.1 迁移旧地图到新工程
旧服务器上的地图自定义过背景、图层时，若希望把旧服务器上的地图迁移到新部署的服务器，可将旧服务器中%FR_HOME%\webapps\webroot\WEB-INF\assets中所有文件复制粘贴到新服务器相同路径下，在「决策系统>地图配置」中点击「同步地理文件」即可。
注：10.0.17 之前的版本需要重启服务器。
6.2 地市内区县信息消失
如果如下图修改了地市名，那么地市内的区县信息都会消失。
此时可以下载压缩包 world.rar，解压后替换掉%FR_HOME%\webapps\webroot\WEB-INF\assets\map\geographic目录下的 world 文件夹，再点击「决策系统>地图配置>同步地理文件」。如下图所示：
6.3 其他
内置的中国地图 JSON 文件行政划分获取的是国家统计局代码：http://www.stats.gov.cn/tjsj/tjbz/tjyqhdmhcxhfdm/2020/index.html
其中台湾省、香港特别行政区和澳门特别行政区，获取的是民政部数据：http://xzqh.mca.gov.cn/map如果所在地有新的行政划分，但国家统计局还未更新数据，请先自定义 JSON 处理，并在文档下方评论或反馈给技术支持，每个季度将进行一次统一反馈到 JSON 厂商处理。