地图服务提供者配置参数 |
地图服务提供者封装了地图功能的实现，为地图服务组件提供地图功能支持。根据地图功能来源的不同，地图服务提供者分为：本地地图服务提供者、WMS 地图服务提供者、REST 地图服务提供者、聚合地图服务提供者等，各类服务提供者有自己的配置参数。
本地地图服务提供者封装了来自 SuperMap 工作空间的地图功能。
表 1本地地图服务提供者配置参数
| 参数名称 | 描述 | ||
|
通用信息 |
服务提供者名称 | 【必填参数】 唯一标识该服务提供者。默认名称前缀是“ugcMapProvider-”。 |
|
|
基本设置 |
工作空间类型 | 【必填参数】 工作空间的类型分文件型、数据库型（ SQL Server 、Oracle 、DM 工作空间）。SQL Server 工作空间表示工作空间保存在 SQL Server 数据库中，Oracle 工作空间表示工作空间保存在 Oracle 数据库中，DM 工作空间表示工作空间保存在 DM 数据库中。 |
|
| 工作空间路径 | 远程服务器文件系统 | 工作空间为文件型时必选，为数据库型时参见表2。服务器不在本地时，选择“远程浏览”，可以使用服务器上的文件或者将本地文件上传至服务器后再使用；服务器在本地时，选择“本地浏览”。 SuperMap 的工作空间（*.smwu、*.sxwu、 *.smw 、 *.sxw ）中存储了 GIS 数据的相关信息。 |
|
| 本地文件系统 | |||
| 工作空间密码 | 所用工作空间的密码，不存在时可以不填或者输入任意字符。 | ||
| 地图 DPI | 工作空间发布的地图服务的 DPI，DPI 最低可设为60，如不进行设置，则 DPI 将会采用缺省值 0，即 DPI 使用地图默认值 | ||
|
高级设置 |
缓存版本 | 动态缓存的版本，默认为5.0。目前 iServer 支持的缓存版本信息详见SuperMap 缓存策略。如果需要兼容 SuperMap iServer 2008生成的简易缓存，则缓存版本需设置为3.1。 | |
| 首选 PNG 缓存图片类型 | 使用 PNG 缓存时首选 PNG 图片类型，目前支持 PNG 和 PNG8，若为 null 则默认使用 PNG。PNG8支持背景透明和256色，无损压缩，存储空间比 PNG 更小，适用于图像颜色较少或具备较大亮度差异以及强烈对比的简单图像，目前只对5.0缓存版本有效。 | ||
| 发布的地图名称列表 | 发布的地图名称列表，多个地图名称之间以英文逗号隔开，为空表示发布所有地图。 | ||
| 地图默认设置列表 | 用户可以对地图高亮目标的显示风格进行设置。高亮目标就是指为了突出表达某些对象及其所在的空间位置，GIS 服务器会用一种区别于其它同类地物对象的显示风格在地图上来渲染该地物对象。 不设置时，高亮显示目标时会自动按照地图设置的默认风格渲染。 |
||
| 是否启用多线程模式 | 是否启用多线程模式，启用多线程模式可以提高本地地图服务提供者的并发性能，默认为启用。如果工作空间地图中有镶嵌数据集，则建议关闭多线程模式。 | ||
| 地图缓冲池大小 | 启用多线程模式时，地图缓冲池大小，默认为0，此时系统会根据工作空间中地图数量均分对象池，对于 SuperMap iServer 32位产品，最大为32个，64位产品对象池最大64个。 用户可以根据服务器状况手动设置或更改缓冲池大小。 |
||
| 是否禁用缓存 | 是否禁用缓存，使用缓存可以提高本地地图服务提供者出图性能，默认为使用。出图参数中也可以设置是否使用缓存，当两者发生冲突时，采用禁用优先原则。例如服务提供者配置中设置禁用缓存，而出图参数设置为使用缓存，则结果为不使用缓存。 | ||
注：SuperMap iServer 还提供了其他可以在配置文件中设置的可选参数，如 useCompactCache、extractCacheToFile、queryExpectCount，请参考通过 XML 文件配置服务提供者。
其中，用户可以修改默认的高亮点、高亮线、高亮面风格：
采用 UGC 默认的符号库中某种点符号风格来渲染高亮的点对象。在地图设置中，可以设置点符号的样式（通过符号库中点风格的 ID 指定），以及这个符号的颜色是什么，符号的大小是多少，符号旋转的角度等等。
采用 UGC 默认的符号库中某种线符号风格来渲染高亮的线对象。在地图设置中，可以设置线对象的样式（通过符号库中线风格的 ID 指定），以及这个线型的线宽，线的颜色是什么等等。
采用 UGC 默认的符号库中某种面符号风格来渲染高亮的面对象。在地图设置中，可以设置面对象的样式（通过符号库中填充风格的 ID 指定），以及这个填充的边线颜色，填充颜色，是否采用透明，填充中心的垂直或者偏移百分比等等。
每个地图只能设置一种风格。iServer Manager 提供了一个默认地图设置。对于没有设置风格的地图，高亮显示目标时会自动按照地图设置的默认风格渲染。
SuperMap 工作空间为数据库型时，配置参数说明如下：
| 参数名称 | 描述 |
| 服务器 | 服务器名称。对于 Oracle 数据库，其服务器名为其 TNS 服务名称；对于 SQL Server 数据库，其服务器名为其系统 DSN（Database System Name）名称；对 DM 数据库，其服务器名为 DM 数据库所在机器的 IP，如 192.168.110.110。 |
| 数据库 | 空间数据库名称。 |
| 驱动 | 当采用 ODBC 链接时的驱动程序名称。只有 SQL Server 数据库使用 ODBC 链接，其驱动程序名可为 SQL Server 或 SQL Native Client。 |
| 名称 | 工作空间在数据库中的名称。 |
| 用户名 | 用来登录数据库的用户名。 |
| 密码 | 用来登录数据库的密码。 |
REST 地图服务提供者封装了从远程 SuperMap iServer 地图 REST 服务获取的 GIS 功能。
表 3 REST 地图服务提供者配置参数
| 参数名称 | 描述 | ||
| 通用信息 | 服务提供者名称 | 【必填参数】 唯一标识该服务提供者。默认名称前缀是“restMapProvider-”。 |
|
| 基本设置 | REST 服务根目录 URL | 【必填参数】 远程 SuperMap iServer 地图 REST 服务的根目录地址，如：http://supermapiserver:8090/iserver/services/map-world/rest 。 |
|
| 高级设置 | Token或API-Key | 启用安全机制的情况下，访问受保护的 REST 资源需要提供Token 令牌或API-Key。 | |
| 是否使用缓存 | 是否使用缓存。默认为 true。开启缓存后，对资源的 REST 请求会缓存在本地，下次收到同样的请求就直接在缓存中读取，不需要再向服务端发送。 | ||
| 缓存策略 | 磁盘最大容量 | 磁盘最大容量。单位为 MB，默认大小为2048MB。 | |
| 存活时间 | 设置缓存存活的时间上限，超时后会自动清除缓存。从创建记录开始计算，单位为秒，默认为0，代表缓存永久存活。 | ||
| 闲置时间 | 设置缓存闲置的时间上限，超时后会自动清除缓存。从上次被访问开始计算，单位为秒，默认为0，代表缓存永久存活。 | ||
超图云 地图服务提供者封装了从远程超图云地图 在线服务获取的 GIS 功能。用户需要设置的参数及其说明如下表所示。
表 4 超图云地图 地图服务提供者参数
| 参数名称 | 描述 | |
| 通用信息 | 服务提供者名称 | 【必填参数】 唯一标识该服务提供者。默认的名称前缀是“cloudMapProvider-”。 |
| 基本设置 | 地图服务地址 | 远程超图云地图服务的出图服务地址。如果用户设置 servicesUrl，则使用用户设置的服务地址，否则使用默认的云地图服务地址:http://t2.supermapcloud.com/FileService/image。 |
| 高级设置 | 是否缓存到本地 | 地图服务提供者生成缓存来提高服务访问效率。为 true 时，访问发布的服务时就可以在本地生成地图缓存，从而可以提高后续服务浏览访问的速度。 |
FastDFS 地图服务提供者封装了由 FastDFS 瓦片包提供的 GIS 功能，相关参数如下表所示。
表 5 FastDFS 地图服务提供者参数
| 参数名称 | 描述 | |
| 通用信息 | 服务提供者名称 | 【必填参数】 唯一标识该服务提供者。默认的名称前缀是“fastMapProvider-”。 |
| 基本设置 | 从分布式切片库中加载配置 | 选择已有的分布式切片库，无需再设置 FastDFS 服务地址。 |
| FDFS Trackers | FastDFS Trackers 服务地址。 | |
| FDHT Groups | FastDHT Groups 服务地址。 | |
|
发布的地图 |
如果 FastDFS 服务器中存储了多个地图的瓦片，则需要选择要发布的地图，可以同时发布所有地图。 |
GDP 地图服务提供者封装了由 GDP 瓦片包提供的 GIS 功能，相关参数如下表所示。
表 6 GDP 地图服务提供者参数
| 参数名称 | 描述 | |
| 通用信息 | 服务提供者名称 | 【必填参数】 唯一标识该服务提供者。默认的名称前缀是“gdpMapProvider-”。 |
| 基本设置 | GDP 文件目录 | 【必填参数】 GDP 文件所在目录。 |
| dpi | 瓦片的屏幕分辨率，默认为96。 | |
| 缓存版本 | 瓦片的版本，目前支持发布版本为5.0和3.1的 GDP 瓦片包。 瓦片版本的详细信息请参考：SuperMap UGC 格式的地图瓦片。 |
|
| 第0级比例尺分母 | 瓦片包中第0级比例尺分母，默认为5.916587109091312E8。 |
地图服务提供者封装了从 MongoDB 分布式存储的瓦片获取的 GIS 功能。用户需要设置的参数及其说明如下表所示。
表 7 MongoDB 地图服务提供者参数
| 参数名称 | 描述 | |
| 通用信息 | 服务提供者名称 | 【必填参数】 唯一标识该服务提供者。默认的名称前缀是“mongodbMapProvider-”。 |
| 基本设置 | 从分布式切片库中加载配置 | 选择已有的分布式切片库，无需再设置 MongoDB 服务地址。 |
|
服务地址 |
【必填参数】 MongoDB 的服务地址。 |
|
|
添加复制集 |
勾选后可添加复制集，多个复制集可提升瓦片读写性能与数据的安全性。 | |
|
数据库 |
用来存储该地图服务中瓦片的数据库。 | |
|
用户名 |
具有该数据库访问权限的用户。 | |
|
密码 |
该用户的密码。 | |
|
发布的地图 |
如果 MongoDB 服务器中存储了多个地图的瓦片，则需要选择要发布的地图，可以同时发布所有地图。 |
地图服务提供者封装了从 MongoDB 分布式存储的瓦片获取的 GIS 功能。用户需要设置的参数及其说明如下表所示。
表 8 MongoDB MVT 地图服务提供者参数
| 参数名称 | 描述 | |
| 通用信息 | 服务提供者名称 | 【必填参数】 唯一标识该服务提供者。默认的名称前缀是“mongoDBMvtMapProvider-”。 |
| 基本设置 |
服务地址 |
【必填参数】 MongoDB 的服务地址。 |
|
添加复制集 |
勾选后可添加复制集，多个复制集可提升瓦片读写性能与数据的安全性。 | |
|
数据库 |
用来存储待发布瓦片的数据库。 | |
|
用户名 |
具有该数据库访问权限的用户。 | |
|
密码 |
该用户的密码。 |
地图服务提供者封装了从 OTS 分布式存储的瓦片获取的 GIS 功能。用户需要设置的参数及其说明如下表所示。
表 9 OTS 地图服务提供者参数
| 参数名称 | 描述 | |
| 通用信息 | 服务提供者名称 | 【必填参数】 唯一标识该服务提供者。 |
| 基本设置 | 从分布式切片库中加载配置 | 选择已有的分布式切片库，无需再设置 OTS 服务信息。 |
|
实例名称 |
【必填参数】 使用的OTS 实例名称。可通过阿里云官网的管理控制台创建实例。 |
|
| 节点名称 | 阿里云服务节点，为创建实例时选择的地址。如地址为杭州，服务节点为cn-hangzhou。 | |
|
是否公网访问 |
公网访问时，访问的OTS服务地址为：http://<instanceName>.<nodeName>.ots.aliyuncs.com。非公网访问时，访问的OTS服务地址为：http://<instanceName>.<nodeName>.ots-internal.aliyuncs.com。 | |
|
accessKeyId |
【必填参数】 OTS 根据 AccessKey 对请求进行身份认证和鉴权。accessKeyId 用于标识AccessKey。可通过阿里云官网的管理控制台获取accessKeyId |
|
|
accessKeySecret |
【必填参数】 AccessKeySecret 用于加密OTS 请求。可通过阿里云官网的管理控制台获取accessKeySecret |
|
|
发布的地图 |
如果 OTS 中存储了多个地图的瓦片，则需要选择要发布的地图，可以同时发布所有地图。 |
SMTiles 地图服务提供者封装了从 SMTiles 地图瓦片包获取的 GIS 功能。用户需要设置的参数及其说明如下表所示。
表 10 SMTiles 地图服务提供者参数
| 参数名称 | 描述 | |
| 通用信息 | 服务提供者名称 | 【必填参数】 唯一标识该服务提供者。默认的名称前缀是“smTilesMapProvider-”。 |
| 基本设置 | SMTiles 文件目录 | 【必填参数】 SMTiles 文件目录。 |
SVTiles 地图服务提供者封装了从 SVTiles 地图瓦片包获取的 GIS 功能。用户需要设置的参数及其说明如下表所示。
表 11 SVTiles 地图服务提供者参数
| 参数名称 | 描述 | |
| 通用信息 | 服务提供者名称 | 【必填参数】 唯一标识该服务提供者。默认的名称前缀是“svTilesMapProvider-”。 |
| 基本设置 | SVTiles 文件目录 | 【必填参数】 SVTiles 文件目录。 |
UGCV5 地图服务提供者封装了从 SuperMap UGC V5 地图瓦包获取的 GIS 功能。用户需要设置的参数及其说明如下表所示。
表 12 UGCV5 地图服务提供者参数
| 参数名称 | 描述 | |
| 通用信息 | 服务提供者名称 | 【必填参数】 唯一标识该服务提供者。默认的名称前缀是“ugcv5MapProvider-”。 |
| 基本设置 | 瓦片配置文件 | 【必填参数】 SuperMap UGC V5瓦片的配置文件或索引文件（*.sci 或 *.inf）。 |
WMS 地图服务提供者封装了来自 WMS 服务的地图功能。
表 13 WMS 地图服务提供者配置参数
| 参数名称 | 描述 | |
| 通用信息 | 服务提供者名称 | 【必填参数】 唯一标识该服务提供者。默认名称前缀是“wmsMapProvider-”。 |
| 基本设置 | WMS 服务根目录 URL | 【必填参数】 WMS 服务地址。 |
| WMS 服务的版本号 | WMS 服务的版本号，如“1.1.1” 。 | |
| 授权访问服务的用户名 | 只有授权的用户才有权限访问 WMS 服务。由发布 WMS 地图的服务器提供。 | |
| 访问服务的密码 | 授权用户的访问密码。由发布 WMS 地图的服务器提供。 | |
| 图层顺序是否倒置 | 设置图层的顺序是否倒置。 | |
| 高级设置 | 是否启用缓存 | SuperMap iServer 支持对 WMS 地图服务提供者生成缓存来提高服务访问效率，即启用 WMSMapProvider 缓存，访问发布的服务时就可以在本地生成地图缓存，从而可以提高后续服务浏览访问的速度。具体请参见 WMSMapProvider 缓存的配置。 |
WMTS 地图服务提供者封装了来自 WMTS 服务的地图功能。
表 14 WMTS 地图服务提供者配置参数
| 参数名称 | 描述 | |
| 通用信息 | 服务提供者名称 | 【必填参数】 唯一标识该服务提供者。默认名称前缀是“wmtsMapProvider-”。 |
| 基本设置 | WMTS 服务根目录 URL | 【必填参数】 WMTS 服务地址。 |
| WMTS 服务的版本号 | WMTS 服务的版本号，如“1.0.0” 。目前支持1.0.0版本的 WMTS 服务作为源。 | |
| 授权访问服务的用户名 | 只有授权的用户才有权限访问 WMTS 服务。由发布 WMTS 地图的服务器提供。 | |
| 访问服务的密码 | 授权用户的访问密码。由发布 WMTS 地图的服务器提供。 | |
| dpi | 远程 WMTS 服务源的 dpi。 | |
| 比例尺集 | 地图对应的比例尺集。会列出 WMTS 服务源下所有地图对应的比例尺集。 | |
| 高级设置 | 分辨率集合 | WMTS 服务各级别对应的分辨率。与所选择比例尺集下的 TileMatrix 保持一致，相邻分辨率以逗号隔开，需要填写 TileMartrix 下所有级别对应的分辨率。 |
| 是否缓存到本地 | SuperMap iServer 支持对 WMTS 地图服务提供者生成缓存来提高服务访问效率，即启用 WMTSMapProvider 缓存，访问发布的服务时就可以在本地生成地图缓存，从而可以提高后续服务浏览访问的速度。 |
Bing Maps 地图服务提供者封装了从远程 Bing Maps 在线服务获取的 GIS 功能。用户需要设置的参数及其说明如下表所示。
表 15 BingMaps 地图服务提供者参数
| 参数名称 | 描述 | |
| 通用信息 | 服务提供者名称 | 【必填参数】 唯一标识该服务提供者。默认的名称前缀是“bingMapsMapProvider-”。 |
| 基本设置 | 地图集 | 【必填参数】 Bing Maps 的地图集名称。Bing Maps 提供了"Aerial"、"AerialWithLables"、"Birdseye"、"BirdseyeWithLables"、"Road"几种数据集，分别对应不同类型的地图服务。 |
| 地图版本 | Bing Maps 的地图版本，如 "v0"、"v1"。 | |
| BingMaps key | 设置 Bing Maps 的授权 key。访问 Bing Maps 地图服务需要申请 key，该 key 由 Bing Maps 提供。 | |
| 高级设置 | 是否启用缓存 | SuperMap iServer 支持对 Bing Maps 地图服务提供者生成缓存来提高服务访问效率。为 true 时，访问发布的服务时就可以在本地生成地图缓存，从而可以提高后续服务浏览访问的速度。 |
Google Maps 地图服务提供者封装了从远程 Google Maps 在线服务获取的 GIS 功能，发布需要设置的参数及其说明如下表所示。
表 16 Google Maps 地图服务提供者参数
| 参数名称 | 描述 | |
| 通用信息 | 服务提供者名称 | 【必填参数】 唯一标识该服务提供者。默认的名称前缀是“googleMapsProvider-”。 |
| 基本设置 | Google Maps client ID | 具有 Google Maps 访问权限的账户。 |
| Google Maps CryptoKey | 该账户的私人密钥。 | |
| 语言 | 地图中的文本标注所使用的语言。 | |
| Api Key | Google Maps 的 API 密钥 | |
| Google瓦片宽度 | 每次向 Google Maps 请求瓦片时，瓦片的宽度（像素）。因为每次请求的单张瓦片上可能会有一个Geoogle的水印，所以将瓦片设置大一些可以减少整个视窗中的水印密度。但是，单张瓦片过大可能会影响瓦片获取的效率，因为您应该根据软硬件及网络条件，设置合理的值。 | |
| Google瓦片高度 | 每次向 Google Maps 请求瓦片时，瓦片的高度（像素）。一般会设置为宽、高相等的瓦片。 | |
| 高级设置 | 是否启用缓存 | SuperMap iServer 支持对远程地图服务提供者生成缓存来提高服务访问效率。为 true 时，访问发布的服务时就可以在本地生成地图缓存，从而可以提高后续服务浏览访问的速度。 |
天地图 地图服务提供者封装了从远程天地图服务获取的 GIS 功能。支持的天地图版本为2.0。用户需要设置的参数及其说明如下表所示。
表 17 天地图 地图服务提供者参数
| 参数名称 | 描述 | |
| 通用信息 | 服务提供者名称 | 【必填参数】 唯一标识该服务提供者。默认的名称前缀是“tiandituMapProvider-”。 |
| 基本设置 | 地图服务地址 | 远程天地图地图服务的出图服务地址。格式如下： http://t<number >.tianditu.gov.cn 天地图提供的服务地址 number 值为0-7，如果用户设置 servicesUrl，则使用用户设置的服务地址，否则随机从 0-7中选取一个作为 number 的值来构建服务地址。当天地图地图服务的出图地址发生变动时可通过修改地图服务地址以与最新的地址保持一致。 |
| 开发许可 | 【必填参数】 天地图 API 及服务接口调用的 Token 字符串。该 Token 可由www.tianditu.gov.cn获取（在申请时请选择“浏览器端”许可） |
|
| 高级设置 | 是否启用缓存 | SuperMap iServer 支持对天地图 地图服务提供者生成缓存来提高服务访问效率。为 true 时，访问发布的服务时就可以在本地生成地图缓存，从而可以提高后续服务浏览访问的速度。 |
ArcGIS REST 地图服务提供者封装了从在线 ArcGIS REST 服务获取的 GIS 功能。用户需要设置的参数及其说明如下表所示。
表 18 ArcGIS REST 地图 地图服务提供者参数
| 参数名称 | 描述 | |
| 通用信息 | 服务提供者名称 | 【必填参数】 唯一标识该服务提供者。默认的名称前缀是“ArcGISRESTMapProvider-”。 |
| 基本设置 | ArcGIS REST 地图服务地址 | 【必填参数】 待发布的 ArcGIS REST 地图服务的地址，如 http://localhost:6080/arcgis/rest/services/SampleWorldCities/MapServer。 |
| 用户名 | 用户名。 如果待发布的服务开启了安全控制，且安全认证方式选择了“用户名/密码”，则需要提供具有访问权限的用户账户。 |
|
| 密码 | 用户密码。 | |
| Token | 对待发布服务具有访问权限的 Token 字符串。 如果待发布的服务开启了安全控制，且安全认证方式选择了“Token”，则需要提供可用的 Token 字符串。目前仅支持通过 HTTP Referer 方式生成的 Token，且生成 Token 时 HTTP Referer 应该设置为“ISERVER”。 |
|
| 高级设置 | 是否启用缓存 | SuperMap iServer 支持对天地图 地图服务提供者生成缓存来提高服务访问效率。为 true 时，访问发布的服务时就可以在本地生成地图缓存，从而可以提高后续服务浏览访问的速度。 |
TPK 地图服务提供者封装了由 TPK 瓦片包（*.tpk）提供的 GIS 功能，相关参数如下表所示。
表 19 TPK 地图服务提供者参数
| 参数名称 | 描述 | |
| 通用信息 | 服务提供者名称 | 【必填参数】 唯一标识该服务提供者。默认的名称前缀是“tpkMapProvider-”。 |
| 基本设置 | TPK 文件路径 | 【必填参数】 TPK 文件目录。 |
VTPK 地图服务提供者封装了由矢量切片 VTPK （*.vtpk）提供的 GIS 功能，相关参数如下表所示。
表 20 VTPK 地图服务提供者参数
| 参数名称 | 描述 | |
| 通用信息 | 服务提供者名称 | 【必填参数】 唯一标识该服务提供者。默认的名称前缀是“vtpkMapProvider-”。 |
| 基本设置 | VTPK 文件路径 | 【必填参数】 VTPK 文件目录。 |
百度地图 地图服务提供者封装了从远程百度地图 在线服务获取的 GIS 功能。用户需要设置的参数及其说明如下表所示。
表 21 百度地图 地图服务提供者参数
| 参数名称 | 描述 | |
| 通用信息 | 服务提供者名称 | 【必填参数】 唯一标识该服务提供者。默认的名称前缀是“baiduMapProvider-”。 |
| 基本设置 | 地图服务地址 | 地图服务地址应为一个可获取地图切片的地址模板，其中{x},{y},{z}分别表示切片的列号,行号，级别。如：http://online0.map.bdimg.com/tile/?qt=tile&x={x}&y={y}&z={z}&styles=pl |
| 地图名称 | 自定义地图名称。当配置了地图服务地址未配置该参数时，默认为"baidu"。 | |
| 高级设置 | 是否启用缓存 | SuperMap iServer 支持对百度地图地图服务提供者生成缓存来提高服务访问效率。为 true 时，访问发布的服务时就可以在本地生成地图缓存，从而可以提高后续服务浏览访问的速度。 |
表 22 OpenStreetMap 地图服务提供者参数
| 参数名称 | 描述 | |
| 通用信息 | 服务提供者名称 | 【必填参数】 唯一标识该服务提供者。默认的名称前缀是“openStreetMapProvider-”。 |
| 基本设置 | 地图服务地址 | 地图服务地址应为一个可获取地图切片的地址模板，其中{x},{y},{z}分别表示切片的列号,行号，级别。如：http://a.tile.openstreetmap.org/{z}/{x}/{y}.png |
| 地图名称 | 自定义地图名称。当配置了地图服务地址未配置该参数时，默认为"OSM"。 | |
| apikey | 访问 OpenStreetMap 的密钥，如不配置该参数地图将显示水印。 | |
| 高级设置 | 是否启用缓存 | SuperMap iServer 支持对百度地图地图服务提供者生成缓存来提高服务访问效率。为 true 时，访问发布的服务时就可以在本地生成地图缓存，从而可以提高后续服务浏览访问的速度。 |
具有聚合能力的地图服务提供者，用于聚合多个地图功能。
请参见：地图功能聚合的配置。
GeoPackage 地图服务提供者封装了由 GeoPackage 地图瓦片包（*.gpkg）提供的 GIS 功能，相关参数如下表所示。
表 23 GeoPackage 地图服务提供者参数
| 参数名称 | 描述 | |
| 通用信息 | 服务提供者名称 | 【必填参数】 唯一标识该服务提供者。默认的名称前缀是“geopkgMapProvider-”。 |
| 基本设置 | GeoPackage 文件目录 | 【必填参数】 GeoPackage 文件目录。 |
| 地图默认投影 | 【必填参数】 GeoPackage 文件发布为地图服务后，地图的默认投影。 |
|
| 坐标轴正方向 | 【必填参数】 GeoPackage 文件发布为地图服务后，坐标轴正方向，包括RightDown 和RightUp。默认为RightDown 。 |
|
| 切片原点 |
【必填参数】 GeoPackage 切片原点，格式为{x},{y}。 |
表 24 ZXYTiles 地图服务提供者
| 参数名称 | 描述 | |
| 通用信息 | 服务提供者名称 | 【必填参数】 唯一标识该服务提供者。 |
| 基本设置 | ZXYTiles 文件目录 | 【必填参数】 zip 格式的 ZXYTiles 瓦片压缩文件或未压缩的ZXYTiles瓦片文件的存储路径 (路径需要写到地图名所在的层级，如此层级下存在多个地图，发布时会将多个地图瓦片一起发布出来)。 |
表 25 ArcGIS 缓存地图服务提供者
| 参数名称 | 描述 | |
| 通用信息 | 服务提供者名称 | 【必填参数】 唯一标识该服务提供者。默认前缀是“arcgisCacheMapProvider-”。 |
| 基本设置 | 缓存配置文件 | 【必填参数】 ArcGIS 缓存配置文件目录。后缀为.xml或.cdi。 |
表 26 ArcGIS 缓存地图服务提供者
| 参数名称 | 描述 | |
| 通用信息 | 服务提供者名称 | 【必填参数】 唯一标识该服务提供者。默认前缀是“arcgisCacheV2MapProvider-”。 |
| 基本设置 | 缓存配置文件 | 【必填参数】 ArcGIS 紧凑型缓存 (V2) 配置文件目录。后缀为 .xml 或 .cdi。 |
UGCV5(MVT) 地图服务提供者封装了从 UGCV5(MVT) 缓存文件获取的 GIS 功能。用户需要设置的参数及其说明如下表所示。
表 27 UGCV5(MVT)地图服务提供者
| 参数名称 | 描述 | |
| 通用信息 | 服务提供者名称 | 【必填参数】 唯一标识该服务提供者。 |
| 基本设置 | 配置文件路径 | 【必填参数】 UGCV5(MVT)缓存文件目录。后缀为.sci。 |
Shapefile 地图服务提供者封装了从 Shapefile 数据文件获取的 GIS 功能。用户需要设置的参数及其说明如下表所示。
表 28 Shapefile 地图服务提供者参数
| 参数名称 | 描述 | |
| 通用信息 | 服务提供者名称 | 【必填参数】 唯一标识该服务提供者。 |
| 基本设置 | Shapefile 文件目录 | 【必填参数】 Shapefile 数据文件目录。 |
| Shapefile 文件编码 | 【必填参数】 设置Shapefile文件的编码格式。 |
|
| 样式文件 | 为地图指定 Mapbox 风格样式，例如：E:\SuperMapiServer\style\style.json。如不指定，iServer 将使用默认的风格文件：【SuperMapiServer安装目录】\webapps\iserver\WEB-INF\config\mapboxstyles\defaultstyle.json。 | |
| 高级设置 | 是否禁用缓存 | 缓存设置。 |
PostGIS 地图服务提供者封装了由 PostGIS 服务提供的 GIS 功能，相关参数如下表所示。
表 29 PostGIS 地图服务提供者参数
| 参数名称 | 描述 | |
| 通用信息 | 服务提供者名称 | 【必填参数】 唯一标识该服务提供者。如“postgisMapProvider-”。 |
| 基本设置 |
主机地址 |
【必填参数】 PostGIS 的服务地址。 |
|
端口 |
【必填参数】 PostGIS 的服务端口号。 |
|
|
数据库名 |
【必填参数】 用来存储瓦片的数据库。 |
|
|
用户名 |
【必填参数】 具有该数据库访问权限的用户。 |
|
|
访问密码 |
【必填参数】 该用户的密码。 |
|
|
样式文件 |
为地图指定 Mapbox 风格样式，例如：E:\SuperMapiServer\style\style.json。如不指定，iServer 将使用默认的风格文件：【SuperMapiServer安装目录】\webapps\iserver\WEB-INF\config\mapboxstyles\defaultstyle.json。 | |
|
高级设置 |
是否禁用缓存 | 缓存设置。 |
复合瓦片地图服务提供者封装了由复合地图瓦片提供的 GIS 功能，相关参数如下表所示。
表 31 复合瓦片地图服务提供者参数
| 描述 | 描述 | |
| 通用信息 | 服务提供者名称 | 【必填参数】 唯一标识该服务提供者。如“MultiTilesProvider-”。 |
|
基本设置 |
地图名 |
【必填参数】 发布的地图服务的名称 |
|
合并模式 |
【必填参数】 发布的复合瓦片的合并模式，支持默认模式、底图模式、自定义模式 |
|
| 切片集集合 | 【必填参数】 要发布的切片集的集合 |
|
| SMTiles文件 | 【必填参数】 SMTiles 文件的存储路径 |
|
| UGC5.0 切片配置文件 | 【必填参数】 UGCV5 切片配置文件的存储路径 |
|
| 分布式切片库 | 要发布的分布式切片库 | |
| 服务地址 | 【必填参数】 要发布的切片集所在的数据库的服务地址，如“192.168.17.214:27017” |
|
|
数据库 |
要发布的数据库的名称 | |
| 用户名 | 具有访问该数据库权限的用户名。 | |
| 密码 | 该用户的密码。 | |
| 选择的切片集 | 【必选参数】 选择要发布的切片集。 |
|
| 底图瓦片集 | 作为底图的瓦片集集合 | |
| 自定义比例尺 | 自定义的比例尺集合，如“6.25E-8”。 |
区块链地图服务提供者封装了由区块链服务提供的GIS功能，相关参数如下表所示。
表32 区块链地图服务提供者参数
| 参数名称 | 描述 | |
|
通用信息 |
服务提供者名称 | 【必填参数】 唯一标识该服务提供者。如“BlockchainMapProvider-”。 |
| 基本设置 | 配置文件 | 【必填参数】 区块链网络 .yaml配置文件存放目录。 |
| 数据源别名 | 【必填参数】 用户命名区块链数据源的别名，如“BlockchainData”。 |
|
|
样式文件 |
为地图指定Mapbox风格样式，例如： E:\SuperMapiServer\style\style.json |
|
| 高级设置 | 是否禁用缓存 | 缓存设置 |
分布式空间文件引擎地图服务提供者封装了由分布式空间文件引擎服务提供的GIS功能，相关参数如下表所示。
表33 分布式空间文件引擎地图服务提供者参数
| 参数名称 | 描述 | |
|
通用信息 |
服务提供者名称 | 【必填参数】 唯一标识该服务提供者。如“DSFMapProvider-”。 |
| 基本设置 | 分布式空间文件引擎 | 【必填参数】 分布式空间文件引擎在本地或 HDFS 分布式文件系统上的存储目录，如 F:/world 或 hdfs://{ip}:{port}/data/catalog |
| 样式文件 |
为地图指定 Mapbox 风格样式，例如：E:\SuperMapiServer\style\style.json |
|
| 高级设置 | 是否禁用缓存 | 缓存设置 |
MBTiles 地图服务提供者封装了从 MBTiles 地图瓦片包获取的 GIS 功能。用户需要设置的参数及其说明如下表所示。
表 34 SMTiles 地图服务提供者参数
| 参数名称 | 描述 | |
| 通用信息 | 服务提供者名称 | 【必填参数】 唯一标识该服务提供者。默认的名称前缀是“mbTilesMapProvider-”。 |
| 基本设置 | SMTiles 文件目录 | 【必填参数】 SMTiles 文件目录。 |
| 存储瓦片类型为矢量瓦片 | 存储的瓦片类型是否为矢量瓦片。 | |
| 样式文件 | 矢量瓦片的样式文件目录，当存储的瓦片类型为矢量瓦片时必填。 |