1. 概述
1.1 版本
报表服务器版本 | 功能变动 |
---|---|
11.0 | - |
11.0.6 | 「地理信息>区域」支持合并已有地理区域为新区域,支持圆形选区,且新增内置目录「中国行政区」。详情参见第 2 章 「自定义 GIS 图层」支持引入高德地图、WMTS 。详情参见第 4 章 |
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 图层。
2. 地理信息
注:11.0.6 版本设计器新增「中国行政区」文件,需更新 地图文件资源 后使用。
地理信息界面如下图所示:
对应标号区域的功能说明如下表所示:
序号 | 功能 | 说明 |
---|---|---|
1 | 地理信息目录 | 目录名称即地图边界名称。支持添加目录、复制目录、删除目录、对目录重命名 |
2 | 地图类型 | 选择地图类型为「区域地图」还是「点地图」 |
3 | 地图编辑及展示 | 选择编辑工具后,可在地图上进行编辑操作,保存后即时展示效果 点击区域时,弹出区域信息,包括名称、中心点以及一些区域编码等。可手动修改,也可删除该区域 |
4 | 编辑工具 | 从上到下依次为:放大、缩小、多边形选区、矩形选区、圆形选区、合并区域、编辑区域边界、删除区域 |
5 | 区域列表 | 地理区域信息列表,可直接在列表中修改名称、经度和纬度;合并区域时可在列表中勾选区域进行合并 点击下方 |
6 | 保存/重置 | 修改配置后,点击「保存」即可保存修改的所有配置,保存成功设计器中即可生效 在未点击「保存」之前,点击「重置」,可还原配置到修改前的状态 |
7 | 同步地理文件 | 在 %FR_HOME%\webapps\webroot\WEB-INF\assets\map 目录下,手动添加、删除或修改 geographic (地理文件)、image(自定义图片)及其任意 JSON 文件内容时,需要「同步地理文件」设计器中才能生效。 |
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 目录下的相同文件夹位置下。
拷贝完成后,同样需要「同步地理文件」,还需要点击设计器中地图类型下的「刷新」按钮。如下图所示:
3. 自定义图片
自定义图片:即把一张图片作为地图边界,然后可以在图片中绘制区域或者点。
注:上传图片大小限制为 2M,也就是 Tomcat 默认 post 大小限制,用户可自行设置为不限制图片大小,设置方法参见文档:WangEditor富文本控件插件 第 4 节的内容。
详细的介绍和示例可以参见文档 自定义图片作为地图边界 的说明。
3.1 新建目录
自定义图片仅支持新建目录,不支持复制目录。同样需要先选择一个父级目录,再点击添加按钮添加目录。如下图所示:
选中创建的新目录,点击「导入图片」即可。如下图所示:
3.2 编辑工具
自定义图片中,编辑工具支持放大、缩小、多边形选区、矩形选区、圆形选区、标记点、合并区域、编辑和删除。
使用方法与「地理信息」中的工具相同,可参考第 2.2 节。
配置完成后,同样点击「保存」按钮进行保存,生成的 JSON 文件保存在 %FR_HOME%\webapps\webroot\WEB-INF\assets\map\image 目录下。
4. 自定义 GIS 图层
GIS 图层包含了世界范围内诸如省市区行政划分、道路交通、边界划分等信息,且不同的 GIS 图层对应的地图风格不同。
在决策系统中支持自定义 GIS 图层,可以作用于当前服务器下的所有地图。
自定义 GIS 图层有以下 4 种方式:
GIS 图层类型 | 说明 | 注意事项 |
---|---|---|
TileLayer | 请参见文档 自定义tilelayer图层 | 支持在设计器中直接自定义 |
WMS | 请参见文档 自定义WMS/WMTS地图服务 | |
高德地图 | 请参见文档 自定义高德地图GIS图层 | 11.0.6 版本设计器新增类型,暂不支持在设计器中直接自定义 |
WMTS | 请参见文档 自定义WMS/WMTS地图服务 |
5. 自定义 JSON 资源
5.1 资源下载
此处提供一些自定义的 JSON 资源可直接下载拷贝到对应目录下使用,文件中包含 FineReport 自带的一些 JSON 和用户自愿上传的 JSON。
点击下载文件 | 备注 |
---|---|
商场平面图 | |
商场2楼平面图 | |
网页区域热力图 | |
柜台平面图 | |
台湾省地图 | |
世界地图 & 中国各省市地图 |
如果用户自定义 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. 注意事项
6.1 迁移旧地图到新工程
旧服务器上的地图自定义过背景、图层时,若希望把旧服务器上的地图迁移到新部署的服务器,可将旧服务器中%FR_HOME%\webapps\webroot\WEB-INF\assets中所有文件复制粘贴到新服务器相同路径下,在「决策系统>地图配置」中点击「同步地理文件」即可。
6.2 地市内区县信息消失
如果如下图修改了地市名,那么地市内的区县信息都会消失。
此时可以参考文档 地图文件资源更新 获取新的 map 文件资源并替换。
6.3 其他
内置的中国地图 JSON 文件行政划分获取的是民政部数据:http://xzqh.mca.gov.cn/map
如果所在地有新的行政划分,但国家统计局还未更新数据,请先自定义 JSON 处理,并在文档下方评论或反馈给技术支持,每个季度将进行一次统一反馈到 JSON 厂商处理。