为充分发挥矢量瓦片服务V2多样式浏览、多级过滤、高性能渲染等能力,iServer 配套提供了样式、数据、缓存三类服务设置模块,提供全链路管理功能。本节将为您介绍具体配置流程及注意事项。
操作步骤
功能入口:
- 服务管理首页‐>服务‐>服务管理标签页‐>指定矢量瓦片服务V2
操作说明:
(1)样式配置
在服务发布完成后,您可直接使用 iServer 默认提供的样式进行浏览。但除发布配置的样式外,您可能还会再添加其他样式,或对已配置的样式进行编辑修改,此时即可使用样式配置能力。样式配置支持添加样式、编辑样式、删除样式和浏览样式。具体如下:
- 添加样式:支持通过界面左上角添加样式按钮添加样式模板和样式文件。
- 添加样式模板:您可从样式管理提供的样式模板列表中选取一个或多个进行添加。
- 添加样式文件:您可添加 iDesktopX 2026 及以上版本“地图输出为 WebMap”工具导出的样式和 Mapbox 标准样式。样式中使用的数据集和字段需要与数据集设置步骤中选用的数据集和属性字段保持一致。此外,还可以在添加过程中对样式设置自定义名称,若不设置,将默认使用样式文件的文件名。
- 编辑样式:支持通过服务样式列表中每个样式后方的编辑操作对样式进行编辑
- 编辑样式模板:您可以对服务发布时设置的或样式配置时添加的样式模板进行图层和字段映射编辑。使用方法详见图层映射
- 编辑样式文件:您可以对服务发布时设置的或样式配置时添加的样式文件进行数据映射和渲染风格编辑。
- 数据映射:指将样式文件中使用的数据源与当前服务使用的数据库进行绑定,点击一键映射即可完成。当您在样式配置功能中添加样式文件后,建议执行此操作。
- 渲染风格编辑:当您需要对地图的渲染风格,如颜色等进行修改时,请通过此功能编辑。您可以通过界面直接对 JSON 文件进行修改
- 此外,服务样式列表中的每个样式都支持名称设置,点击名称后的编辑按钮即可输入自定义名称,后续服务使用过程中均将使用此自定义名称。若不设置,将仍使用列表中的原名称。
- 删除样式:支持通过服务样式列表中每个样式后方的删除操作对指定样式进行删除。
- 完成后上述所有修改后,需点击界面右上角保存将成果应用到服务。
- 浏览样式:支持通过服务样式列表中每个样式后方的预览操作对不同样式的地图在 OpenLayers 表述中进行预览。
样式管理:
功能入口:服务管理首页‐>数据‐>样式管理标签页
功能说明:该功能支持对服务中所有使用的样式进行统一管理。当前版本支持对 REST-矢量瓦片服务 V2 提供全局统一的样式模板,样式来源包括由 iDesktopX 2026 及以上版本“地图输出为 WebMap”工具导出的样式(可包含字体、图标资源)和 Mapbox 标准样式。支持上传 zip 样式文件、删除样式,并支持设置样式名称,若不设置将默认使用样式文件的文件名。
(2)数据配置
为控制数据可见范围、优化瓦片生成效率,iServer 提供了 SQL 条件过滤和属性字段选择功能,支持对已发布的数据集添加相应条件。具体操作如下:
- 在 iServer 服务详情-服务提供者标签页,进行如下配置:
- 缓冲范围:设置瓦片缓冲范围,每张瓦片按照设置的范围值向四周扩大,即生成的瓦片包含了缓冲区范围内的数据。设置缓冲范围的意义是在浏览瓦片时,相邻瓦片的边界可以无缝衔接。默认值为16,单位为像素。
- 抽稀显示:支持勾选,iServer 将对小比例尺下的几何对象进行抽稀,可提高显示性能,不勾选,表示不抽稀。默认不勾选
- 在 iServer 服务详情-数据标签页,点击添加数据,进行如下配置:
- 数据集:选择需要添加数据条件的数据集,选中的数据集将作为图层进行出图,不添加则没有数据集可供地图渲染。
- 过滤选项:根据过滤条件筛选出所选数据集中需要的要素对象,该设置对服务中的所有样式生效。支持符合 SQL 语句规范的过滤表达式,表达式中可包含多个条件,例如:dlbm='011' or dlbm='013'。
- 属性字段:支持在所选数据集中选择需要在瓦片中包含的属性字段,该字段可用于查询。若不选择,生成的瓦片将不包含属性信息。该设置对服务中的所有样式生效
- 配置完成后点击确定,弹窗关闭后点击保存
- 此外,您还可以对服务发布过程中或服务详情中配置的数据信息进行编辑,点击服务数据列表后方的编辑操作即可完成,支持编辑的内容和添加数据功能相同。注意:当已经对服务生成过矢量预缓存时,如果需要应用当前设置,需清除已有缓存重新生成才可生效
您还可以对服务中已有的数据进行删除,点击服务数据列表后方的删除操作即可完成。注意:若删除数据,则样式中映射到该数据集的图层将无法渲染。
完成后上述所有修改后,需点击界面右上角保存将成果应用到服务。
(3)缓存配置
为保证地图的高性能渲染,iServer 为矢量瓦片服务V2提供了一系列缓存机制,您可按需进行配置,具体如下:
- 在 iServer 服务详情-缓存标签页,进行如下配置:
- 是否启用缓存:默认开启。启用后,服务会优先使用指定存储位置下的栅格和矢量预缓存,如果预缓存不存在则会进行动态缓存,保障地图出图性能。
- 矢量存储位置:当前仅支持 ./output/MVT
- 矢量预缓存:将显示本地已存在的矢量缓存层级(包括动态缓存和预缓存)。
- 栅格存储位置:当前仅支持 ./output/cache
- 栅格预缓存:将按样式分别显示本地已存在的栅格缓存层级(包括动态缓存和预缓存)。
注意事项
- 上传的样式文件包(*.zip)中应满足如下目录结构
根目录/
├─ WebMap.json
├─ sprites/
└─ fonts/
- 当地图中包含大数据量的数据集时,建议先行创建预缓存,否则将会影响出图性能及效果。
- 当配置了样式模板的服务需要迁移到其他 iServer 时,请您将 %iServer_HOME%/webapps/iserver/web-inf/config/vectorstyles/template 目录整体复制到新的 iServer 对应目录中。
相关主题