配置地图服务提供者

SuperMap iServer 支持以下类型的地图服务提供者：

配置本地地图服务提供者
配置 REST 地图服务提供者
配置超图云地图服务提供者
配置 FastDFS 地图服务提供者
配置 GDP 地图服务提供者
配置 MongoDB 地图服务提供者
配置 OTS 地图服务提供者
配置 SMTiles 地图服务提供者
配置 SVTiles 地图服务提供者
配置 UGCV5 地图服务提供者
配置 WMS 地图服务提供者
配置 WMTS 地图服务提供者
配置 Bing Maps 地图服务提供者
配置 Google Maps 地图服务提供者
配置百度地图服务提供者
配置 OpenStreetMap 地图服务提供者
配置天地图地图服务提供者
配置 ArcGIS REST 地图服务提供者
配置 TPK 地图服务提供者
配置 GeoPackage 地图服务提供者
配置 ZXYTiles 地图服务提供者
配置 ArcGIS 缓存地图服务提供者

配置本地地图服务提供者

配置一个 UGC 地图服务提供者，如下所示：

<provider name="ugcMapProvider1" class="com.supermap.services.providers.UGCMapProvider">
        <config class="com.supermap.services.providers.UGCMapProviderSetting">
                <outputPath>../webapps/iserver/output</outputPath>
                <outputSite>http://localhost:8090/iserver/output/</outputSite>
                <workspacePath>server=../samples/data/World/World.sxwu;password=supermap</workspacePath>
                <cacheVersion>4.0</cacheVersion>
                <useCompactCache>false</useCompactCache>
                <multiThread>true</multiThread>
                <!-- 是否禁用扩大查询功能 -->                
                <inflatDisabled>true</inflatDisabled>               
                <poolSize>0</poolSize>
                <preferedPNGType>PNG</preferedPNGType>
                <queryExpectCount>1000</queryExpectCount>
                <leftTopCorner>
                        <x>-180.0</x>
                        <y>90.0</y>
                </leftTopCorner>
               <!-- 设置排除字段 -->                
               <excludedFieldsInMaps>
                     <com.supermap.services.providers.ExcludedFieldsInMap>
                          <mapName>World</mapName>
                          <excludedFieldsInLayers>
                               <com.supermap.services.providers.ExcludedFieldsInLayer>
                                  <layerName>Captial@World</layerName> 
                                  <excludedFields>SMID,NAME</excludedFields>
                               </com.supermap.services.providers.ExcludedFieldsInLayer>
                          </excludedFieldsInLayers>
                    </com.supermap.services.providers.ExcludedFieldsInMap>
                </excludedFieldsInMaps>
        </config>
</provider>

其中<provider>中的 class 标识的是 UGC 服务提供者的实现类，<config>中的 class 标识的是 UGC 服务提供者对应的配置类，即 UGCMapProviderSetting ，<config>中的内容是 UGCMapProviderSetting 对应的配置项：

<inflatDisabled>：动态出图是否禁用扩大查询范围功能。为true时表示关闭扩大查询范围，对于浏览瓦片地图时，可将该参数设置为false，表示开启扩大查询，以保证相邻瓦片正常拼接，出图完整。需要将该选项设置为false,即在动态出图时，扩大查询范围。当浏览非瓦片地图时，为了提高出图性能，可以将该参数设置为true，禁用扩大查询功能，仅浏览所需范围的区域。
<outputPath>：图片的输出路径。
<outputSite>：访问图片的根目录 URI。
<workspacePath>：该服务提供者所用的工作空间的路径。若工作空间有密码，假设密码为 supermap，则写为：

<workspacePath>server=../samples/data/World/World.sxwu;password=supermap</workspacePath>

此外，工作空间路径支持从环境变量和系统配置文件中读取。可写为：

<workspacePath>server=${datapath1}/World.sxwu;password=supermap</workspacePath>

详细说明请参见：预设本地工作空间路径

<cacheVersion>：指定动态缓存的版本，默认为4.0，目前 iServer 支持的缓存版本信息详见SuperMap 缓存策略。如果需要兼容 SuperMap iServer 2008生成的简易缓存，则缓存版本需设置为3.1。
<ignoreHashcodeWhenUseCache>：如果为 true，表示读取原始缓存时忽略 hashcode，默认为 false。此参数支持4.0和5.0缓存。
<useCompactCache>：是否使用紧凑格式的缓存，如果设为 true 则使用紧凑缓存，默认为 false。目前只有5.0版本的缓存支持该参数。
<multiThread>：是否使用多线程，默认为 true。
<poolSize>：线程缓冲池大小，详见服务提供者配置的参数说明。
<preferedPNGType>：使用 PNG 缓存时首选 PNG 图片类型，目前支持 PNG 和 PNG8，若为 null 则默认使用 PNG。详见服务提供者配置的参数说明。
<queryExpectCount>：服务端默认返回查询结果条目的数量，默认为1000。
<leftTopCorner>：设置地图切片时，左上角的起始点，默认为地图范围的左上角坐标。
<cacheDisabled>：是否禁用缓存，默认为使用。出图参数中也可以设置是否使用缓存，当两者发生冲突时，采用禁用优先原则。详见服务提供者配置的参数说明。
<excludedFieldsInMaps>：设置排除字段。管理员可以根据需要，排除指定图层的字段，当用户进行地图查询操作时，将查看不到已排除的字段。

其中，com.supermap.services.providers.ExcludedFieldsInMap、com.supermap.services.providers.ExcludedFieldsInLayer为字段排除设置实现类。<mapName>为地图名称，<layerName>为数据集名称，<excludedFields>指定排除的字段。

SuperMap iServer 也支持 Oracle 及 SQL Server 数据库型的工作空间作为服务提供者。需要提供的参数如表1所示，没有特殊说明表示两种类型都需要该参数。

表1 数据库型工作空间信息设置参数

参数名称	描述
type	工作空间的类型，目前支持的数据库型工作空间为 Oracle 工作空间和 SQL Server 工作空间，其值分别为 ORACLE 和 SQL。ORACLE 表示工作空间保存在 oracle 数据库中，SQL 表示工作空间保存在 SQL Server 数据库中。
name	工作空间在数据库中的名称。
username	用来登录数据库的用户名。
password	用来登录数据库的密码。
server	服务器名称。对于 Oracle 数据库，其服务器名为其 TNS 服务名称；对于 SQL Server 数据库，其服务器名为其系统 DSN（Database System Name）名称
database	数据库名称。
driver	当采用 ODBC 连接时的驱动程序名称。只有 SQL Server 数据库使用 ODBC 连接，其驱动程序名可为 SQL Server 或 SQL Native Client。

使用 Oracle 数据库提供数据源的<workspacePath>格式如下：

<workspacePath>type=ORACLE;name=testOralce;username=cq;password=cq;server=ISERVER;database=iserver</workspacePath>

使用 SQL 数据库提供数据源的<workspacePath>为：

<workspacePath>type=SQL;name=testSQL;username=sa;password=iserver;server=ISERVICE\SQL2005;driver= 
 SQL Server;database=iserver</workspacePath>

此外，多个<provider>可以绑定为一个整体，即作为一个<providerSet>向服务组件（<component>）提供服务，详见通过 XML 文件配置服务提供者集合。<provider> 和 <providerSet> 在配置文件中的结构如下所示：

<server>
        ...
        <application>
                ...
                <providerSets>
                        ...
                        <providerSet>
                                ...
                        </providerSet>
                </providerSets>
                <providers>
                        ...
                        <provider>
                        ...
                        </provider>
                </providers>
        </application>
</server>

配置 REST 地图服务提供者

配置 REST 服务提供者在<provider>节点中进行：

<provider name="restMapProvider1" class="com.supermap.services.providers.RESTMapProvider">
        <config class="com.supermap.services.providers.RESTMapProviderSetting">
                <restServiceRootURL>http://localhost:8090/iserver/services/rest</restServiceRootURL>
                <token>GsXST0cE0CumxQUFXBX7Oopin4<token>
        </config>
</provider>

其中<provider>中的 class 标识的是 REST 服务提供者的实现类，<config>中的 class 标识的是 REST 服务提供者对应的配置类，即 RESTMapProviderSetting ，<config>中的内容是 RESTMapProviderSetting 对应的配置项：

<restServiceRootURL>：REST 地图服务的地址，指向服务的根资源路径，如 http://localhost:8090/iserver/services/map-china400/rest。
<useCache>：是否使用缓存。默认为 true。开启缓存后，对资源的 REST 请求会缓存在本地，下次收到同样的请求就直接在缓存中读取，不需要再向服务端发送。
<restProviderCacheConfig>：服务提供者历史请求缓存在内存中的存储设置，包括：
<maxElementsInMemory>：内存中允许存储的最大请求记录数。0代表无限制；1代表不使用内存缓存，默认为1。如果不为1，则优先向内存中存储请求记录。
<maxSizeOnDisk>：磁盘最大容量。单位为 MB，默认大小为2048MB。
<timeToLiveSeconds>：设置缓存存活的时间上限，超时后会自动清除缓存。从创建记录开始计算，单位为秒，默认为0，代表缓存永久存活。
<timeToIdleSeconds>：设置缓存闲置的时间上限，超时后会自动清除缓存。从上次被访问开始计算，单位为秒，默认为0，代表缓存永久存活。
<token>：启用安全机制的情况下，访问受保护的 REST 资源需要提供Token 令牌。

配置超图云地图服务提供者

超图云服务提供者的配置在<provider>节点中进行。具体配置方式如下：

<provider name="CloudMapProvider1" class="com.supermap.services.providers.CloudMapProvider">
        <config class="com.supermap.services.providers.CloudMapProviderSetting">
                <outputPath>../webapps/iserver/output</outputPath>
                <outputSite>http://localhost:8090/iserver/output/</outputSite>
                <servicesUrl>http://t0.supermapcloud.com/FileService/image</servicesUrl>
                <cacheEnabled>true</cacheEnable> 
        </config>
</provider>

其中<provider>中的 class 标识的是超图云服务提供者的实现类，<config>中的 class 标识的是超图云服务提供者对应的配置类，即 CloudMapProviderSetting，<config>中的内容对应的是 CloudMapProviderSetting 对应的配置项：

<outputPath>：图片的输出路径。
<outputSite>：访问图片的根目录 URI。
<servicesUrl>：远程超图云地图服务的出图服务地址。如果用户设置 servicesUrl，则使用用户设置的服务地址，否则使用默认的服务地址：http://t0.supermapcloud.com/FileService/image。
<cacheEnabled>：是否缓存到本地。为 true 时，访问发布的服务时就可以在本地生成地图缓存，从而可以提高后续服务浏览访问的速度。默认为 true。

配置 FastDFS 地图服务提供者

FastDFS 服务提供者的配置在<provider>节点中进行。具体配置方式如下：

    <provider class="com.supermap.services.providers.FastDFSTileProvider" enabled="true" name="fastDfs"> 
      <config class="com.supermap.services.providers.FastDFSTileProviderSetting"> 
        <fdfsTrackers> 
          <string>192.168.112.251:22122</string> 
        </fdfsTrackers>  
        <fdhtGroups> 
          <string-array> 
            <string>192.168.112.250:11411</string> 
          </string-array> 
        </fdhtGroups> 
      </config> 
    </provider>

其中<provider>中的 class 标识的是 FastDFS 服务提供者的实现类，<config>中的 class 标识的是 FastDFS 服务提供者对应的配置类，即 FastDFSTileProviderSetting，<config>中的内容对应的是 FastDFSTileProviderSetting 对应的配置项：

<fdfsTrackers>：FastDFS Trackers 服务地址。
<fdhtGroups>：FastDHT Groups 服务地址。
<mapName>：发布的地图的名称，如果不设置，默认发布当前存储位置的全部地图。
<tilesetName>：发布瓦片集的名称，不需手动设置。

配置 GDP 地图服务提供者

GDP 地图服务提供者的配置在<provider>节点中进行。具体配置方式如下：

<provider class="com.supermap.services.providers.GDPMapProvider" enabled="true" name="gdpMapProvider-"> 
	<config class="com.supermap.services.providers.GDPMapProviderSetting"> 
		<cacheVersion>5.0</cacheVersion>  
		<filesPath>F:\SuperMap\China_58b994e9-5856-4a10-a0dc-0e0e177d7962\7_0000_0000_192.168.120.42_2014_03_03_14_01_56.zip</filesPath>  
		<dpi>96.0</dpi>  
		<tileSize>256</tileSize>  
		<zoom0ScaleDenator>5.916587109091312E8</zoom0ScaleDenator> 
	</config> 
</provider>

其中<provider>中的 class 标识的是 GDP 服务提供者的实现类，<config>中的 class 标识的是 GDP 服务提供者对应的配置类，即 GDPMapProviderSetting，<config>中的内容对应的是 GDPMapProviderSetting 对应的配置项：

<filesPath>：GDP 瓦片包的路径。
<cacheVersion>：瓦片的版本。
<dpi>：瓦片的 DPI，默认为96。
<tileSize>：瓦片的大小，默认为256。
<zoom0ScaleDenator>：第0级比例尺分母，默认为5.916587109091312E8。
<bounds>：地图范围，默认为：-20037508.3427892440,-20037508.3427892440,20037508.3427892440,20037508.3427892440。
<format>：瓦片的格式，如 png。

配置 MongoDB 地图服务提供者

MongoDB 服务提供者的配置在<provider>节点中进行。具体配置方式如下：

<provider class="com.supermap.services.providers.MongoDBTileProvider" enabled="true" name="mongoDBMapProvider-China"> 
      <config class="com.supermap.services.providers.MongoDBTileProviderSetting"> 
        <serverAdresses> 
          <string>localhost:27017</string> 
        </serverAdresses>  
        <mapName>China</mapName>  
        <tilesetName>1181328118</tilesetName>  
        <database>smtiles</database>  
        <username>iserver</username>  
        <password>iserver</password> 
      </config> 
    </provider>

其中<provider>中的 class 标识的是 MongoDB 服务提供者的实现类，<config>中的 class 标识的是 MongoDB 服务提供者对应的配置类，即 MongoDBTileProviderSetting，<config>中的内容对应的是 MongoDBTileProviderSetting 对应的配置项：

<serverAdresses>：MongoDB 服务器的地址。
<mapName>：发布的地图的名称，如果不设置，默认发布当前存储位置的全部地图。
<tilesetName>：发布瓦片集的名称，不需手动设置。
<database>：用来存储这些地图瓦片的数据库。默认使用名为 smtiles 的数据库。
<username>：具有访问该数据库权限的用户名。
<password>：该用户的密码。

配置 OTS 地图服务提供者

OTS 服务提供者的配置在<provider>节点中进行。具体配置方式如下：

    <provider class="com.supermap.services.providers.OTSTileProvider" enabled="true" name="ots-map"> 
      <config class="com.supermap.services.providers.OTSTileProviderSetting">
        <outputPath>D:\SuperMap\SuperMapiServer8C(2017)\webapps\iserver\output</outputPath>  
        <outputSite>http://{ip}:{port}/iserver/output/</outputSite>  
        <nodeName>cn-hangzhou</nodeName>  
        <instanceName>tileStore</instanceName>  
        <accessKeyId>accessKeyId</accessKeyId>  
        <accessKeySecret>accessKeySecret</accessKeySecret>  
        <fromPublic>true</fromPublic> 
      </config> 
    </provider>

其中<provider>中的 class 标识的是 OTS 服务提供者的实现类，<config>中的 class 标识的是 OTS 服务提供者对应的配置类，即 OTSTileProviderSetting，<config>中的内容对应的是OTSTileProviderSetting 对应的配置项：

<outputPath>：图片的输出路径。
<outputSite>：访问图片的根目录 URI。
<nodeName>：节点名称。阿里云服务节点，为创建实例时选择的地址。
<instanceName>：实例名称。在此处填写在阿里云控制台管理中创建的实例名称。
<accessKeyId>：在阿里云官网的“管理控制台”申请获取的AccessKeyId。
<accessKeySecret>：在阿里云官网的“管理控制台”申请获取的AccessKeySecret。
<fromPublic>：是否公网访问。公网访问时，访问的OTS服务地址为：http://<instanceName>.<nodeName>.ots.aliyuncs.com。非公网访问时，访问的OTS服务地址为：http://<instanceName>.<nodeName>.ots-internal.aliyuncs.com。

配置 SMTiles 地图服务提供者

SMTiles 服务提供者的配置在<provider>节点中进行。具体配置方式如下：

<provider name="smtilesMapProvider1" class="com.supermap.services.providers.SMTilesMapProvider">
        <config class="com.supermap.services.providers.SMTilesMapProviderSetting">
                <filePath>../webapps/iserver/output/sqlite/World_-411043745_256X256_PNG.smtiles</filePath>
        </config>
</provider>

其中<provider>中的 class 标识的是 SMTiles 地图服务提供者的实现类，<config>中的 class 标识的是 SMTiles 地图服务提供者对应的配置类，即 SMTilesMapProviderSetting，<config>中的内容对应的是 SMTilesMapProviderSetting 对应的配置项：

<filePath>：SMTiles 缓存文件的路径。该缓存文件可以是 SuperMap iServer 和 iExpress 生成的 SMTiles 缓存文件。

配置 SVTiles 地图服务提供者

SVTiles 服务提供者的配置在<provider>节点中进行。具体配置方式如下：

<provider name="svtilesMapProvider1" class="com.supermap.services.providers.SVTilesMapProvider">
        <config class="com.supermap.services.providers.SVTilesMapProviderSetting">
                <filePath>../webapps/iserver/output/sqlite/World_1715141636_256X256.svtiles</filePath>
        </config>
</provider>

其中<provider>中的 class 标识的是 SVTiles 地图服务提供者的实现类，<config>中的 class 标识的是 SVTiles 地图服务提供者对应的配置类，即 SVTilesMapProviderSetting，<config>中的内容对应的是 SVTilesMapProviderSetting 对应的配置项：

<filePath>：SVTiles 缓存文件的路径。该缓存文件可以是 SuperMap iServer 和 iExpress 生成的 SVTiles 缓存文件。

配置 UGCV5 地图服务提供者

UGCV5 服务提供者的配置在<provider>节点中进行。具体配置方式如下：

    <provider class="com.supermap.services.providers.UGCV5TileProvider" enabled="true" name="ugcv5-China"> 
      <config class="com.supermap.services.providers.UGCV5TileProviderSetting"> 
        <configFile>../webapps/iserver/output/cache/China/China.sci</configFile> 
      </config> 
    </provider>

其中<provider>中的 class 标识的是 UGCV5 服务提供者的实现类，<config>中的 class 标识的是 UGCV5 服务提供者对应的配置类，即 UGCV5TileProviderSetting，<config>中的内容对应的是 UGCV5TileProviderSetting 对应的配置项：

<configFile>：SuperMap UGC V5 瓦片的配置文件或索引文件（*.sci 或 *.inf）。

配置 WMS 地图服务提供者

配置 WMS 服务提供者在<provider>节点中进行：

<!-- WMS 地图服务提供者示例，使用远程的 WMS 服务作为数据来源。-->
<provider name="wmsMapProvider" class="com.supermap.services.providers.WMSMapProvider">
        <config class="com.supermap.services.providers.WMSMapProviderSetting">
                <serviceRootURL>http://localhost:7070/geoserver/wms</serviceRootURL>
                <username></username>
                <password></password>
                <version>1.1.1</version>
                <reverseLayerOrder>false</reverseLayerOrder>
        </config>
</provider>

其中<provider>中的 class 标识的是 WMS 服务提供者的实现类，<config>中的 class 标识的是 WMS 服务提供者对应的配置类，即 WMSMapProviderSetting ，<config>中的内容是 WMSMapProviderSetting 对应的配置项：

serviceRootURL：WMS 服务的根目录。
username：WMS 服务授权访问的用户名（可选）。
password：WMS 服务授权访问的密码（可选）。
version：WMS 服务的版本号。
reverseLayerOrder：设置图层的顺序是否倒置。

配置 WMTS 地图服务提供者

配置 WMTS 服务提供者在<provider>节点中进行：

<!-- WMTS 地图服务提供者示例，使用远程的 WMTS 服务作为数据来源。-->
<provider name="wmtsMapProvider" class="com.supermap.services.providers.WMTSMapProvider">
        <config class="com.supermap.services.providers.WMTSMapProviderSetting">
                <serviceRootURL>http://server:7070/geoserver/wmts</serviceRootURL>
                <username></username>
                <password></password>
                <version>1.0.0</version>
                <dpi>90.7142857142857</dpi>
                <layers>
                        <com.supermap.services.providers.WMTSMapLayer>
                                <identifier>world:Countries</identifier>
                                <tileMatrixSet>EPSG:4610</tileMatrixSet>
                        </com.supermap.services.providers.WMTSMapLayer>
                        <com.supermap.services.providers.WMTSMapLayer>
                                <identifier>nurc:Img_Sample</identifier> 
                                <tileMatrixSet>EPSG:900913</tileMatrixSet>
                        </com.supermap.services.providers.WMTSMapLayer>
                </layers> 
                <reverseTopLeftCorner>EPSG:4610</reverseTopLeftCorner>
                <reverseBoundingBox>urn:ogc:def:crs:EPSG::4610</reverseBoundingBox>
        <cacheEnabled>true</cacheEnabled>
        <resolutions>0.01903568804664224,0.00951784402332112,......</resolutions> 
        </config>
</provider>

其中<provider>中的 class 标识的是 WMTS 服务提供者的实现类，<config>中的 class 标识的是 WMTS 服务提供者对应的配置类，即 WMTSMapProviderSetting ，<config>中的内容是 WMTSMapProviderSetting 对应的配置项：

<serviceRootURL>：WMTS 服务的根目录。
username：WMTS 服务授权访问的用户名（可选）。
password：WMTS 服务授权访问的密码（可选）。
version：WMTS 服务的版本号（目前支持 1.0.0 版本）。
dpi：WMTS 服务源的 dpi。
layers：WMTS 服务中的图层集合。
reverseTopLeftCorner：iServer 对于 TopLeftCorner 的默认解析规则：TileMatrixSet 使用地理坐标系统，且 TileMatrixSet 的 SupportedCRS 使用 EPSG 命名空间时，按 Y X 的顺序解析 TopLeftCorner；其余情况都按照 X Y 的顺序解析 TopLeftCorner。多个crs之间以英文逗号“,”隔开。若使用的 WMTS 服务的 TopLeftCorner 不满足该规则时，需要把该 TopLeftCorner 对应的 TileMatrixSet 标签下的 Identifier 加入 WMTSMapProvider 的 reverseTopLeftCorner 的配置项里，标识按默认规则相反的坐标顺序解析 TileMatrixSet 的 TopLeftCorner。示例中 Identifier 为 EPSG:4610的 tileMatrixSet，SupportedCRS 为 urn:ogc:def:crs:EPSG::4610，在 geoserver 中 TopLeftCorner 使用 XY 坐标顺序，与 iserver 默认解析规则相反，因此在该配置项下加入了该 layer 的 tileMatrixSet 的 Identifier。
cacheEnabled：是否缓存到本地。默认为 true。
resolutions：WMTS 服务各级别对应的分辨率（可选）。与所选择比例尺集下的 TileMatrix 保持一致，相邻分辨率以逗号隔开，需要填写 TileMartrix 下所有级别对应的分辨率。
reverseBoundingBox：设置需要逆序解析BoundingBox的crs集合，多个crs之间以英文逗号“,”隔开。设置了该参数后，对BoundingBox的解析将按照YX的顺序解析。

配置 Bing Maps 地图服务提供者

BingMaps 服务提供者在<provider>节点中进行。具体配置方式如下：

<provider name="BingMapsMapProvider1" class="com.supermap.services.providers.BingMapsMapProvider">
        <config class="com.supermap.services.providers.BingMapsMapProviderSetting">
                <outputPath>../webapps/iserver/output</outputPath>
                <outputSite>http://localhost:8090/iserver/output/</outputSite>
                <apiKey>fdskjkfdsk</apiKey>
                <bingmapsRootUrl>http://localhost:9876/bingmaps/</bingmapsRootUrl>
                <imagerySet>Road</imagerySet>
                <mapVersion>v1</mapVersion>
                <cacheEnabled>true</cacheEnable>
        </config>
</provider>

其中<provider>中的 class 标识的是 BingMaps 服务提供者的实现类，<config>中的 class 标识的是 BingMaps 服务提供者对应的配置类，即 BingMapsMapProviderSetting，<config>中的内容是 BingMapsMapProviderSetting 对应的配置项：

<outputPath>：图片的输出路径。
<outputSite>：访问图片的根目录 URI。
<apiKey>：设置 BingMaps 的授权 key。访问 BingMaps 地图服务需要申请 key，该 key 由 BingMaps 提供。
<bingmapsRootUrl>：远程 BingMaps 地图服务的出图服务地址。
<imagerySet>：BingMaps 的地图集名称。BingMaps 提供了"Aerial"、"AerialWithLables"、"Birdseye"、"BirdseyeWithLables"、"Road"几种数据集，分别对应不同类型的地图服务。
<mapVersion>：BingMaps 的地图版本，如 "v0"、"v1"。
<cacheEnabled>：是否缓存到本地。为 true 时，访问发布的服务时就可以在本地生成地图缓存，从而可以提高后续服务浏览访问的速度。默认为 true。

配置 Google Maps 地图服务提供者

Google 地图地图服务提供者的配置在<provider>节点中进行。具体配置方式如下：

<provider class="com.supermap.services.providers.GoogleMapsMapProvider" enabled="true" name="googlemap"> 
  <config class="com.supermap.services.providers.GoogleMapsMapProviderSetting"> 
    <outputPath/>  
    <outputSite/>  
    <cacheEnabled>false</cacheEnabled>  
    <googleMapLanguage>zh-cn</googleMapLanguage>  
    <googleMapCryptoKey>abcdefghijklmn=</googleMapCryptoKey>  
    <googleMapClientID>myClientID</googleMapClientID>  
    <googleMapWidth>400</googleMapWidth>  
    <googleMapHeight>400</googleMapHeight>
    <googleProxyAddress>127.0.0.1</googleProxyAddress>		
    <googleProxyPort>8787</googleProxyPort>  
    <useTileImage>true</useTileImage> 
  </config> 
</provider>

其中<provider>中的 class 标识的是 Google 地图服务提供者的实现类，<config>中的 class 标识的是 Google 地图服务提供者对应的配置类，即 GoogleMapsMapProviderSetting，<config>中的内容是 GoogleMapsMapProviderSetting 对应的配置项：

<googleMapClientID>：具有 Google Maps 访问权限的账户。
<googleMapCryptoKey>：该账户的私人密钥。
<googleMapLanguage>：地图中的文本标注所使用的语言。
<googleMapWidth>：每次向 Google Maps 请求瓦片时，瓦片的宽度（像素）。因为每次请求的单张瓦片上可能会有一个Geoogle的水印，所以将瓦片设置大一些可以减少整个视窗中的水印密度。但是，单张瓦片过大可能会影响瓦片获取的效率，因为您应该根据软硬件及网络条件，设置合理的值。
<googleMapHeight>：每次向 Google Maps 请求瓦片时，瓦片的高度（像素）。一般会设置为宽、高相等的瓦片。
<googleProxyAddress>：代理访问 Google Maps 的地址。如果不能正常访问Google Maps，则需要设置此参数。
<googleProxyPort>：代理访问 Google Maps 的端口。如果不能正常访问Google Maps，则需要设置此参数。

配置百度地图服务提供者

百度地图地图服务提供者的配置在<provider>节点中进行。具体配置方式如下：

<provider name="baiduMapProvider1" class="com.supermap.services.providers.BaiduMapProvider">
        <config class="com.supermap.services.providers.BaiduMapProviderSetting">
                <outputPath>../webapps/iserver/output</outputPath>
                <outputSite>http://localhost:8090/iserver/output/</outputSite>
                <mapUrl>http://online0.map.bdimg.com/tile/?qt=tile&x={x}&y={y}&z={z}&styles=pl</mapUrl>
                <mapName>true</mapName> 
                <cacheEnabled>true</cacheEnable>
        </config>
</provider>

其中<provider>中的 class 标识的是百度地图地图服务提供者的实现类，<config>中的 class 标识的是百度地图地图服务提供者对应的配置类，即 BaiduMapProviderSetting，<config>中的内容是 BaiduMapProviderSetting 对应的配置项：

<outputPath>：图片的输出路径。
<outputSite>：访问图片的根目录 URI。
<mapUrl>：地图服务地址应为一个可获取地图切片的地址模板，其中{x},{y},{z}分别表示切片的列号,行号，级别。如：http://online0.map.bdimg.com/tile/?qt=tile&x={x}&y={y}&z={z}&styles=pl
<mapName>：自定义地图名称。当配置了 mapUrl 未配置该参数时，默认为"baidu"。
<cacheEnabled>：是否缓存到本地。为 true 时，访问发布的服务时就可以在本地生成地图缓存，从而可以提高后续服务浏览访问的速度。默认为 true。

配置 OpenStreetMap 地图服务提供者

OpenStreetMap 地图服务提供者的配置在<provider>节点中进行。具体配置方式如下：

<provider name="openStreetMapProvider1" class="com.supermap.services.providers.OpenStreetMapProvider">
        <config class="com.supermap.services.providers.OpenStreetMapProviderSetting">
                <outputPath>../webapps/iserver/output</outputPath>
                <outputSite>http://localhost:8090/iserver/output/</outputSite>
                <mapUrl>http://a.tile.openstreetmap.org/{z}/{x}/{y}.png</mapUrl>
                <mapName>true</mapName> 
                <cacheEnabled>true</cacheEnable>
        </config>
</provider>

其中<provider>中的 class 标识的是 OpenStreetMap 地图服务提供者的实现类，<config>中的 class 标识的是百度地图地图服务提供者对应的配置类，即 OpenStreetMap ProviderSetting，<config>中的内容是 OpenStreetMapProviderSetting 对应的配置项：

<outputPath>：图片的输出路径。
<outputSite>：访问图片的根目录 URI。
<mapUrl>：地图服务地址应为一个可获取地图切片的地址模板，其中{x},{y},{z}分别表示切片的列号,行号，级别。如：http://a.tile.openstreetmap.org/{z}/{x}/{y}.png。
<mapName>：自定义地图名称。当配置了 mapUrl 未配置该参数时，默认为"OSM"。
<cacheEnabled>：是否缓存到本地。为 true 时，访问发布的服务时就可以在本地生成地图缓存，从而可以提高后续服务浏览访问的速度。默认为 true。

配置天地图地图服务提供者

天地图服务提供者的配置在<provider>节点中进行。具体配置方式如下：

<provider name="tiandituMapProvider1" class="com.supermap.services.providers.TiandituMapProvider">
        <config class="com.supermap.services.providers.TiandituMapProviderSetting">
                <outputPath>../webapps/iserver/output</outputPath>
                <outputSite>http://localhost:8090/iserver/output/</outputSite>
                <servicesUrl>http://t5.tianditu.cn</servicesUrl>
                <cacheEnabled>true</cacheEnable>
        </config>
</provider>

其中<provider>中的 class 标识的是天地图服务提供者的实现类，<config>中的 class 标识的是天地图服务提供者对应的配置类，即 TiandituMapProviderSetting，<config>中的内容是 TiandituMapProviderSetting 对应的配置项：

<outputPath>：图片的输出路径。
<outputSite>：访问图片的根目录 URI。
<servicesUrl>：远程天地图地图服务的出图服务地址。格式如下： http://t<number >.tianditu.cn 天地图提供的服务地址 number 值为0-7，如果用户设置 servicesUrl，则使用用户设置的服务地址，否则随机从0-7中选取一个作为 number 的值来构建服务地址。
<cacheEnabled>：是否缓存到本地。为 true 时，访问发布的服务时就可以在本地生成地图缓存，从而可以提高后续服务浏览访问的速度。默认为 true。

配置 ArcGIS REST 地图服务提供者

ArcGIS REST 服务提供者的配置在<provider>节点中进行。配置方式如下：

    <provider class="com.supermap.services.providers.ArcGISRestMapProvider" enabled="true" name="arcgis-Countries2"> 
      <config class="com.supermap.services.providers.ArcGISRestMapProviderSetting"> 
        <restServiceRootURL>http://localhost:6080/arcgis/rest/services/mytest/Countries/MapServer</restServiceRootURL>  
        <cacheEnabled>false</cacheEnabled>  
        <token>_jLYzPo-SEJRXfB3Q-W2EearDDnaIZTqQqUfju4GD8Owd6PIiUVmabUJiSdZeX1V</token>  
        <httpReferer>ISERVER</httpReferer>
      </config> 
    </provider>

其中<provider>中的 class 标识的是 ArcGIS REST 地图服务提供者的实现类，<config>中的 class 标识的是 ArcGIS REST 地图服务提供者对应的配置类，即 ArcGISRestMapProviderSetting，<config>中的内容对应的是 ArcGISRestMapProviderSetting 对应的配置项：

<restServiceRootURL>：ArcGIS REST 服务地址。
<token>：针对具有访问权限限制的待发布服务的 Token 字符串。如果待发布的服务开启了安全控制，且安全认证方式选择了“Token”，则需要提供可用的 Token 字符串。
<httpReferer>：针对具有访问权限限制的待发布服务的 HTTP Referer 字符串。如果待发布的服务开启了安全控制，安全认证方式选择了“Token”，且生成 Token 时填写了 HTTP Referer 时，需要设置该项。

配置 TPK 地图服务提供者

TPK 服务提供者的配置在<provider>节点中进行。配置方式如下：

    <provider class="com.supermap.services.providers.TPKMapProvider" enabled="true" name="tpk-map1"> 
      <config class="com.supermap.services.providers.TPKMapProviderSetting"> 
        <tilePackagePath>../samples/data/map1.tpk</tilePackagePath> 
      </config> 
    </provider>

其中<provider>中的 class 标识的是 TPK 地图服务提供者的实现类，<config>中的 class 标识的是 TPK 地图服务提供者对应的配置类，即 TPKMapProviderSetting，<config>中的内容对应的是 TPKMapProviderSetting 对应的配置项：

<tilePackagePath>：TPK 文件的路径。

配置 GeoPackage 地图服务提供者

GeoPackage 服务提供者的配置在<provider>节点中进行。配置方式如下：

 <provider class="com.supermap.services.providers.GeoPackageMapProvider" enabled="true" name="gpkgMap-map"> 
      <config class="com.supermap.services.providers.GeoPackageMapProviderSetting"> 
        <outputPath>F:\dev\trunk\etc\iserver-debug\src\test\webapps\iserver\output</outputPath>  
        <outputSite>http://localhost:8090/iserver/output/</outputSite>  
        <filePath>E:/data/geopackage/map.gpkg</filePath>  
        <defaultMapPrjCoordSys>0</defaultMapPrjCoordSys>  
        <queryExpectCount>1000</queryExpectCount>  
        <axisPositiveDirection>RightUp</axisPositiveDirection>  
        <originalPoint>-180,-90</originalPoint>
      </config> 
    </provider>

其中<provider>中的 class 标识的是 GeoPackage 地图服务提供者的实现类，<config>中的 class 标识的是 GeoPackage 地图服务提供者对应的配置类，即 GeoPackageMapProviderSetting，<config>中的内容对应的是 GeoPackageMapProviderSetting 对应的配置项：

<outputPath>：图片的输出路径。
<outputSite>：访问图片的根目录 URI。
<filePath>：GeoPackage 文件的路径。
<defaultMapPrjCoordSys>：GeoPackage 文件发布为地图服务后，地图的默认投影。
<queryExpectCount>：期望返回的查询数，默认为 1000 。
<axisPositiveDirection>：坐标轴正方向。包括RightDown 和RightUp。默认为RightDown 。
<originalPoint>：切片原点，格式为{x},{y}。

配置 ZXYTiles 地图服务提供者

ZXYTiles 服务提供者的配置在<provider>节点中进行。具体配置方式如下：

     <provider class="com.supermap.services.providers.ZXYTilesMapProvider" enabled="true" name="zxytest">
      <config class="com.supermap.services.providers.ZXYTilesMapProviderSetting">
        <outputPath>../../webapps/iserver/output</outputPath>  
        <outputSite>http://{ip}:{port}/iserver/output/</outputSite>  
        <filePath>E:/data/ZXYTilesSample.zip</filePath>
    </provider>

其中<provider>中的 class 标识的是 ZXYTiles 地图服务提供者的实现类，<config>中的 class 标识的是 ZXYTiles 地图服务提供者对应的配置类，即 ZXYTilesMapProviderSetting，<config>中的内容对应的是 ZXYTilesMapProviderSetting 对应的配置项：

<outputPath>：图片的输出路径。
<outputSite>：访问图片的根目录 URI。
<filePath>：ZXYTiles文件的路径。

配置 ArcGIS 缓存地图服务提供者

ArcGIS 缓存服务提供者的配置在<provider>节点中进行。具体配置方式如下：

    <provider class="com.supermap.services.providers.ArcGISCacheMapProvider" enabled="true" name="agscache-WorldCitiesPopulation"> 
      <config class="com.supermap.services.providers.ArcGISCacheMapProviderSetting"> 
        <outputPath>../../webapps/iserver/output</outputPath>  
        <outputSite>http://{ip}:{port}/iserver/output/</outputSite>  
        <configFile>E:/data/arcgiscache/sample/World Cities Population/conf.xml</configFile> 
      </config> 
    </provider>

其中<provider>中的 class 标识的是 ArcGIS 缓存地图服务提供者的实现类，<config>中的 class 标识的是 ArcGIS 缓存服务提供者对应的配置类，即 ArcGISCacheMapProviderSetting，<config>中的内容对应的是 ArcGISCacheMapProviderSetting 对应的配置项：

<outputPath>：图片的输出路径。
<outputSite>：访问图片的根目录 URI。
<filePath>：ArcGIS 缓存配置文件的路径（*.xml或*.cdi）。