地图配置

1.1 版本

1.2 應用場景

FineReport 設計器支持使用地圖展示與地理位置相關的數據信息，而地理位置匹配的信息則是通過「地圖配置」來決定的。

我們可以通過「地圖配置」功能自定義地圖邊界和 GIS 圖層，在設計器中選擇對應的「地圖邊界」即可。

注1：11.0.6 版本對地圖進行了一系列優化，爲保證預覽效果，建議使用 Chrome 浏覽器。

注2：11.0.6 版本及之後的「地圖配置」界面，需聯網請求高德 API 資源，否則地理信息、自定義圖片圖層無法顯示。

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」文件一起拷贝到同一目录下。

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

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

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

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

3.1 新建目录

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

選中創建的新目錄，點擊「導入圖片」即可。如下圖所示：

3.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文件.rar，使用时将名称修改为自已定义的名称即可。

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

5.2 JSON 文件格式

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

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

5.2.1 区域地图

5.2.2 点地图

6.1 迁移旧地图到新工程

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

6.2 地市内区县信息消失

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

此時可以參考文檔  地圖文件資源更新 獲取新的 map 文件資源并替換。 

6.3 其他

• 内置的中国地图 JSON 文件行政划分获取的是国家统计局代码：http://www.stats.gov.cn/tjsj/tjbz/tjyqhdmhcxhfdm/2020/index.html
  其中台湾省、香港特别行政区和澳门特别行政区，获取的是民政部数据：http://xzqh.mca.gov.cn/map

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