生成栅格瓦片配置文件(全球剖分)

发送反馈


使用说明

生成栅格瓦片配置文件(全球剖分)工具用于为基于全球剖分比例尺层级的栅格瓦片生成提供地图瓦片配置文件(.sci)。

地图瓦片配置文件提供了地图生成瓦片所需要的参数信息,包括:瓦片比例尺方案、瓦片格式、存储格式、瓦片范围、瓦片原点等参数。在地图瓦片生成的流程中,拆分切图任务、多进程生成地图瓦片以及本地地图瓦片的管理中都会使用地图瓦片配置文件(.sci)。

下图为基于全球剖分比例尺层级多进程生成地图栅格瓦片完整流程。

基于全球剖分比例尺层级多进程生成地图栅格瓦片完整流程

为了方便用户生产地图瓦片,工具箱提供了多进程生成瓦片的预定义模型工具,将上面复杂的流程封装为工具,如下图所示:“多进程生成地图瓦片_全球剖分”工具,工具部分参数的说明同下。

基于全球剖分比例尺层级多进程生成地图栅格瓦片工具

参数说明

参数名 默认值 参数释义 参数类型
瓦片名称   地图瓦片的名称。 String
工作空间文件   存储待切片地图的工作空间文件的全路径,仅支持本地路径。 String
地图名称   待切片地图的名称。 String
存储格式 Original 地图瓦片的存储格式,该参数的值有以下几种情况:
1. 原始:瓦片以单独的图片文件或mvt文件存储,数据未压缩。2. 紧凑:对原始瓦片文件进行压缩和加密。3. MongoDB:瓦片存储在MongoDB数据库中。
StorageType
瓦片格式 WEBP 栅格瓦片采用的图片类型,支持 PNG,JPG,JPG_PNG,PNG8,WEBP。默认值为 WEBP。 TileFormat
最小比例尺层级   一个全剖剖分比例尺层级编号。地图瓦片生成时,将生成“最小比例尺层级”至“最大比例尺层级”间的全部层级瓦片。
全球剖分比例尺层级编号从0开始计数,层级与比例尺的对应关系参见本页的附表1。
Integer
最大比例尺层级   一个全剖剖分比例尺层级编号。地图瓦片生成时,将生成“最小比例尺层级”至“最大比例尺层级”间的全部层级瓦片。
全球剖分比例尺层级编号从0开始计数,层级与比例尺的对应关系参见本页的附表1。
Integer
本地存储目录   地图瓦片的本地存储路径。如果地图瓦片存储采用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
瓦片背景透明
(可选)
false 瓦片的背景是否透明,勾选,表示瓦片背景透明(瓦片格式为PNG或WEBP时有效);未勾选,表示瓦片将保留地图的背景色。 Boolean
完全填充瓦片
(可选)
true 例如:当用户选中某市的行政范围面作为生成瓦片的范围,生成瓦片时,若未勾选该项,瓦片内容只会包含该行政面对象范围内的地图内容;若勾选该项,针对瓦片范围边界的瓦片存在未包含在该行政面对象范围内的地图内容。
获得地图瓦片配置文件
Boolean
瓦片大小(像素)
(可选)
SIZE256 瓦片尺寸,单位为像素。该参数默认值为:256,表示单张瓦片尺寸为 256*256像素。通常该参数的值为:2048,1024,512,256,128,64。 TileSize
瓦片范围
(可选)
  限定一个矩形切图范围,默认为地图全幅范围。
该参数由“左,下,右,上”矩形的两个对角点的坐标值限定一个矩形范围,例如:地图坐标系为WGS1984,该参数值为:
112.60,28.66,112.83,28.76
表示的含义为:左:112.60,下:28.66,右:112.83,上:28.76,坐标单位为度。
String
瓦片原点
(可选)
  瓦片原点确定了瓦片的索引范围,即确定了地图瓦片切分规则;具有相同索引范围的地图瓦片才可以进行合并、追加、更新操作。
该参数由“左,下,右,上”矩形的两个对角点的坐标值限定一个矩形范围。
如果该参数未设置,针对全球剖分比例尺,默认使用坐标系有效范围;针对自定义比例尺,默认为地图范围。
例如:目标地图为地理坐标系,使用全球剖分比例尺层级生成地图瓦片,该参数默认为:-180,-90,180,90,表示的含义为:左:-180,下:-90,右:180,上:90。目标地图为投影坐标系,使用全球剖分规则生成地图瓦片,该参数默认为坐标系的有效范围,如,地图坐标系为EPSG 3857,其有效范围是:-20037508.342789244,-20037508.342789244,20037508.342789244,20037508.342789244(左:-20037508.342789244,下:-20037508.342789244,右:20037508.342789244,上:20037508.342789244)。
String
忽略无效数据区域瓦片
(可选)
false 勾选该项,将不会生成无数据区域的瓦片,可提升瓦片生成效率。 Boolean
基于金字塔算法生成瓦片
(可选)
false 基于金字塔算法生成瓦片方式只适用于对影像地图(地图中只有影像图层,而不包含矢量图层)生成栅格瓦片。
勾选该参数,将使用一种更高效的地图瓦片生成方式,该方式先基于地图生成最大比例尺层级瓦片;再通过金字塔算法,基于最大比例尺层级瓦片创建其他比例尺层级瓦片。
未勾选该参数,各层级的地图瓦片都将基于对应比例尺层级的地图生成。
Boolean
金字塔原始瓦片层级
(可选)
0.0 当勾选了“基于金字塔算法生成瓦片”时,该参数才有效。该参数的值与“最大比例尺层级”参数值一致。 Double
mongo高精度存储
(可选)
true 该参数仅对MongoDB型存储格式有效。地理坐标系的地图生成大于19层级(对应比例尺为1:564.25)的瓦片时,需要勾选该项,否则,会因存储精度低导致瓦片错乱或丢失。 Boolean

输出结果

该工具执行的输出参数:

  1. 生成的sci文件路径:该工具执行后,会根据指定的参数创建地图瓦片配置文件.sci,该参数为生成的.sci文件的全路径。
  2. 工作空间文件:该参数值等于工具的输入参数“工作空间文件”。
  3. 地图名称:该参数值等于工具的输入参数“地图名称”。
  4. 瓦片存储目录:该参数值等于工具的输入参数“本地存储目录”。

附表 1:全球剖分比例尺层级及对应的比例尺

全球剖分比例尺层级及对应的比例尺