地图配置

1.1 版本

1.2 应用场景

FineReport 设计器支持使用地图展示与地理位置相关的数据信息，而地理位置匹配的信息则是通过「地图配置」来决定的。

我们可以通过「地图配置」功能自定义地图边界和 GIS 图层，在设计器中选择对应的「地图边界」即可。

注1：11.0.6 版本对地图进行了一系列优化，为保证预览效果，建议使用 Chrome 浏览器。

注2：11.0.6 版本及之后的「地图配置」界面，需联网请求高德 API 资源，否则「地理信息」、「自定义图片」图层无法显示。

内网情况下开放标准样式的高德 api 白名单域名可使用：webapi.amap.com 、vdata.amap.com 、restapi.amap.com 。

1.3 功能简介

1）在设计器中点击「服务器>地图配置」，登录数据决策系统，即可直接跳转到地图配置界面。如下图所示：

2）在设计器中点击「服务器>报表平台管理」，登录数据决策系统，在「管理系统」下点击「地图配置」功能。如下图所示：

3）「地图配置」中共有三个配置页面，分别为：

• 地理信息：可以自定义地图区域边界和点的信息。

• 自定义图片：使用自定义的图片作为地图边界。

• 自定义 GIS 图层：可以新增预定义 GIS 图层。

注：11.0.6 版本设计器新增「中国行政区」文件，需更新 地图文件资源 后使用。

地理信息界面如下图所示：

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

2.1 新建/复制目录

要自定义一个新地图边界，首先要新建或复制一个目录，设置新边界的名称。

2.1.1 新建目录

新建目录时，需选中一个已有的目录作为父级目录，再点击目录右上角的添加按钮添加目录，设置名称后点击确定。如下图所示：

新建的目录在「父级目录」下，没有任何地理信息。如下图所示：

2.1.2 复制目录

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

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

复制的目录文件，包含原目录文件的地理信息。如下图所示：

2.2 地图编辑工具

2.2.1 选区工具

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

以多边形选区工具为例，操作步骤如下图所示：

2.2.2 合并区域

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

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

2.2.3 编辑/删除工具

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

操作步骤如下图所示：

2.2.4 标记点工具

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

如下图所示：

2.3 保存/重置

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

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

2.4 同步地理文件

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

远程设计 时，这些 json 文件可以直接拷贝到服务器端使用，注意需要同时将「名称-area.json」和「名称-point.json」文件一起拷贝到服务器端webroot\WEB-INF\assets\map 目录下的相同文件夹位置下。

拷贝完成后，同样需要「同步地理文件」，还需要点击设计器中地图类型下的「刷新」按钮。如下图所示：

自定义图片：即把一张图片作为地图边界，然后可以在图片中绘制区域或者点。

注：上传图片大小限制为 2M，也就是 Tomcat 默认 post 大小限制，用户可自行设置为不限制图片大小，设置方法参见文档：WangEditor富文本控件插件 第 4 节的内容。

详细的介绍和示例可以参见文档 自定义图片作为地图边界 的说明。

3.1 新建目录

自定义图片仅支持新建目录，不支持复制目录。同样需要先选择一个父级目录，再点击添加按钮添加目录。如下图所示：

选中创建的新目录，点击「导入图片」即可。如下图所示：

3.2 编辑工具

自定义图片中，编辑工具支持放大、缩小、多边形选区、矩形选区、圆形选区、标记点、合并区域、编辑和删除。

使用方法与「地理信息」中的工具相同，可参考第 2.2 节。

配置完成后，同样点击「保存」按钮进行保存，生成的 JSON 文件保存在 %FR_HOME%\webapps\webroot\WEB-INF\assets\map\image 目录下。

GIS 图层包含了世界范围内诸如省市区行政划分、道路交通、边界划分等信息，且不同的 GIS 图层对应的地图风格不同。

在决策系统中支持自定义 GIS 图层，可以作用于当前服务器下的所有地图。

自定义 GIS 图层有以下 4 种方式：

5.1 资源下载

此处提供一些自定义的 JSON 资源可直接下载拷贝到对应目录下使用，文件中包含 FineReport 自带的一些 JSON 和用户自愿上传的 JSON。

如果用户自定义 JSON 资源时，只自定义了其中一个 JSON 文件，需手动添加另一个 JSON 文件，再到地图配置中「同步地理文件」。

此处提供两个空的 JSON 文件：空JSON文件.zip ，使用时将名称修改为自已定义的名称即可。

注：如果有自愿提供自己自定义的 JSON 地图的，可在 论坛发帖 ，若被采纳会给予 F 币奖励。 

5.2 JSON 文件格式

除了在前端制作地图的方式外，还可以后台直接编写，具体 JSON 格式如下所示：

注：若用户自己编写地图 JSON，需要注意：地图中心点计算规则 。

5.2.1 区域地图

5.2.2 点地图

5.3 加载资源

1）将JSON文件放在工程webapps\webroot\WEB-INF\assets\map\image文件夹下

2）在数据决策系统中，点击「管理系统>地图配置>同步地理文件」即可。

6.1 迁移旧地图到新工程

旧服务器上的地图自定义过背景、图层时，若希望把旧服务器上的地图迁移到新部署的服务器，可将旧服务器中%FR_HOME%\webapps\webroot\WEB-INF\assets中所有文件复制粘贴到新服务器相同路径下，在「决策系统>地图配置」中点击「同步地理文件」即可。

6.2 地市内区县信息消失

如果如下图修改了地市名，那么地市内的区县信息都会消失。

此时可以参考文档  地图文件资源更新 获取新的 map 文件资源并替换。 

6.3 其他

• 内置的中国地图 JSON 文件行政划分获取的是民政部数据：http://xzqh.mca.gov.cn/map

• 如果所在地有新的行政划分，但国家统计局还未更新数据，请先自定义 JSON 处理，并在文档下方评论或反馈给技术支持，每个季度将进行一次统一反馈到 JSON 厂商处理。