生成矢量瓦片配置文件
使用说明
生成矢量瓦片配置文件工具用于为矢量瓦片生成操作提供地图瓦片配置文件(.sci)。
地图瓦片配置文件提供了地图生成瓦片所需要的参数信息,包括:瓦片比例尺、存储格式、瓦片范围、瓦片原点、瓦片大小(矢量瓦片大小固定为512*512像素)。在地图瓦片应用的全流程中,拆分切图任务、多进程生成地图瓦片以及本地地图瓦片的管理中都会使用地图瓦片配置文件(.sci)。
参数说明
参数名 | 默认值 | 参数释义 | 参数类型 |
---|---|---|---|
瓦片名称 | 地图瓦片的名称。 | String | |
工作空间文件 | 存储待切片地图的工作空间文件的全路径,仅支持本地路径。 | String | |
地图名称 | 待切片地图的名称。 | String | |
存储格式 | Original | 地图瓦片的存储格式,该参数的值有以下几种情况: 1. 原始:瓦片以单独的图片文件或mvt文件存储,数据未压缩。2. 紧凑:对原始瓦片文件进行压缩和加密。3. MongoDB:瓦片存储在MongoDB数据库中。 |
StorageType |
瓦片层级组 | 瓦片层级方案。该参数列表中的每一条记录为一个切片层级,其值为全球剖分比例尺层级编号。支持输入不连续层级编号,但矢量瓦片显示时,缺失层级显示效果会出现异常。 | String | |
本地存储路径 | 地图瓦片的本地存储路径。如果地图瓦片存储采用MongoDB数据库或者对象存储时,该参数也必须设置,用来存储切片过程中产生的临时文件,例如:切片子任务.sci文件。 在Windows系统下,该参数还支持共享目录路径,例如:\\127.0.0.1\test\cache。 |
String | |
瓦片连接信息 (可选) (可选) |
地图瓦片存储采用MongoDB数据库或对象存储时,需要使用该参数指定具体存储位置。 若存储格式为MongoDB型。该参数为MongoDB数据库连接信息,格式为: --userName=demo --password=123456 --database=test --server=localhost:27017 其中,--userName和--password为MongoDB的访问用户名密码,若没有,这两个参数可以省略;--server 指定MongoDB数据服务器地址和端口;--database 指定MongoDB数据库名称,若指定的数据库不存在,将新建该数据库。 若地图瓦片的存储格式为原始或紧凑,并且瓦片存储采用对象存储(支持兼容标准 AWS S3协议的对象存储),该参数为对象存储路径信息,格式为:--type=ObjectStorage --server=/vsis3/bucketname/path/ 其中,--type=ObjectStorage必须参数;--server 指定对象存储路径:“/vsis3/”固定前缀,bucketname为对象存储桶名称,path为存储桶下的路径。 注意:使用“/vsis3/”固定前缀的对象存储路径,需要当前机器已完成访问对象存储服务的系统环境变量配置。 此外,SuperMap iDesktopX 11i(2024) 版本开始,支持连接云存储服务,无需配置访问对象存储服务的系统环境变量,这种情况下,在iDesktopX中使用GPA工具生成地图瓦片到对象存储时,“瓦片连接信息”参数的对象存储路径格式为://minio@image/cachedir/test,其中: // 为云存储路径的必须前缀 minio@image 为当前程序已经连接的云储存服务的连接名称,即iDesktopX添加云存储服务连接时指定的连接名称。 /cachedir/test:连接文件夹(添加云存储连接时指定的“文件夹”)下的子目录路径。 iDesktopX添加云存储服务连接,请参见《 iDesktopX 帮助文档——云存储服务》 |
String | |
瓦片范围 (可选) |
限定一个矩形切图范围,默认为地图全幅范围。 该参数由“左,下,右,上”矩形的两个对角点的坐标值限定一个矩形范围,例如:地图坐标系为WGS1984,该参数值为: 97.348082,26.045865999999997,108.546712,34.31300000000001 表示的含义为:左:97.348082,下:26.045865999999997,右:108.546712,上:34.31300000000001,坐标单位为度。 |
String | |
生成字体缓存文件 (可选) |
true | 勾选,表示生成字体缓存文件;未勾选,表示不生成字体缓存文件。推荐勾选“生成字体缓存文件”,否则,结果矢量瓦片中的文字内容存在异常。 | Boolean |
添加所有属性字段值 (可选) |
false | 勾选,表示生成的矢量瓦片中,将包含几何对象的全部非系统字段;未勾选,只会将地图配图使用的属性字段信息写入矢量瓦片数据。 通常情况下,无需添加所有属性字段,当地图数据庞大时,添加所有属性字段影响切片性能。 |
Boolean |
缓冲范围 (可选) |
16 | 矢量瓦片缓存范围,默认16,通过调整该参数值可以解决瓦片边界对象绘制衔接对齐的问题。 | Integer |
内部范围 (可选) |
4096 | 矢量瓦片内部逻辑范围,默认4096,通过调整该参数值可以解决非常细小对象的岛洞关系错误导致绘制显示错误的问题。 | Integer |
分离数据与风格 (可选) |
true | 勾选,表示分离数据与风格;未勾选,表示不分离数据与风格。当用户后期需要单独更新矢量瓦片的数据或者风格时,需要勾选该项。 备注说明:如果生成的矢量瓦片未包含所有属性字段,地图数据未变化,地图风格变化了,且使用了新的字段配图时,在更新瓦片,就不能只重新生成瓦片风格,也要重新生成矢量瓦片数据,新的字段才能写入矢量瓦片数据。 |
Boolean |
抽稀显示 (可选) |
true | 勾选,将对小比例尺下的几何对象进行抽稀,可以提高显示性能,未勾选,表示不抽稀。 是否应用抽稀,用户可根据实际数据情况设置。 此项设置仅对非PostGIS数据源有效。 针对PostGIS数据源,需要修改SuperMap.xml文件(位于iDesktopX安装目录/Bin/),添加“<MVTSimplifyPGIS>TRUE</MVTSimplifyPGIS>”标签,参数值为TRUE,表示抽稀;为FALSE,表示不抽稀。 节点密集,形状复杂的面对象,在小比例尺下,抽稀后,结果矢量瓦片存在面对象变形情况,例如:千万级地类图斑数据,经过抽稀后,小比例尺下,面对象变形将导致地图出现镂空问题,建议针对海量地类图斑数据先创建矢量金字塔,再生成矢量瓦片。 |
Boolean |
mongo高精度存储 (可选) |
true | 该参数仅对MongoDB型存储格式有效。地理坐标系的地图生成大于19层级(对应比例尺为1:564.25)的瓦片时,需要勾选该项,否则,会因存储精度低导致瓦片错乱或丢失。 | Boolean |
输出结果
该工具执行的输出参数:
- 生成的sci文件路径:该工具执行后,会根据指定的参数创建地图瓦片配置文件.sci,该参数为生成的.sci文件的全路径。
- 工作空间文件:该参数值等于工具的输入参数“工作空间文件”。
- 地图名称:该参数值等于工具的输入参数“地图名称”。
- 瓦片存储路径:该参数值等于工具的输入参数“本地存储路径”。
补充说明
生成矢量瓦片配置文件工具不会执行切片操作,要生成矢量瓦片还需要联合“拆分切图任务”和“多进程生成地图瓦片”工具,下图即为多进程生成地图矢量瓦片完整流程的模型。
为了方便用户生产地图瓦片,工具箱提供了多进程生成瓦片的预定义模型工具,将上面复杂的流程封装为工具(位于“模型”-“多进程生成瓦片”-“多进程生成矢量瓦片”),工具部分参数的说明同上。