Configure 3D Service Provider

SuperMap iServer supports the following types of 3D service providers:

Configure UGC 3D Provider
Configuring REST 3D service providers
Configure MongoDB 3D Service Provider
Configure Local 3D Realspace Provider
Configure 3D Tiles Realspace Provider.
Configure OSS 3D Tiles Cache Service Provider (obsolete)
Configure S3 3D Tiles Cache Service Provider
Configure UGCV5 (MVT) 3D Service Provider

Configure UGC 3D Provider

Configure a UGC 3D provider as follows:

<!-- Local 3D service provider -->
<provider class="com.supermap.services.providers.UGCRealspaceProvider" name="3DProvider">
        <config class="com.supermap.services.providers.UGCRealspaceProviderSetting">
                <workspacePath>../../samples/data/Realspace/RealspaceSample.sxwu</workspacePath>
                <xmlParse>false</xmlParse>
        </config>
</provider>

The class in < provider > identifies the implementation class of UGC 3D service providers, and the class in < config > identifies the implementation class of UGC 3D service providers. Class identifies the configuration class corresponding to UGC 3D service providers, that is, UGCRealspaceProviderSetting , and the content in < config > is the corresponding configuration item.

< workspacePath > represents the path to the workspace used by the service providers. In addition, the workspace path supports reading from environment variables and the system config file. It can be written as:

<workspacePath>${datapath1}/World.sxwu</workspacePath>

For detailed instructions, please refer to：Preset Local Workspace Path

Configuring REST 3D service providers

Configure a REST 3D service providers as follows:

<!-- REST 3D Service Provider -->
<provider class="com.supermap.services.providers.RestRealspaceProvider" enabled="true" name="rest3DProvider-test">
        <config class="com.supermap.services.providers.RestRealspaceProviderSetting">
                <restServiceRootURL>http://localhost:8090/iserver/services/3D-sample/rest</restServiceRootURL>
                <restProviderCacheConfig>
                        <maxElementsInMemory>1</maxElementsInMemory>
                        <maxSizeOnDisk>2048</maxSizeOnDisk>
                        <timeToLiveSeconds>0</timeToLiveSeconds>
                        <timeToIdleSeconds>0</timeToIdleSeconds>
                </restProviderCacheConfig>
                <useCache>true</useCache>
        </config>
</provider>

The class in < provider > identifies the implementation class of the rest 3D service providers, and the class in < config > identifies the configuration class corresponding to the REST 3D service provider, that is, RestRealspaceProviderSetting , and the content in < config > is the corresponding configuration item. Including:

< restServiceRootURL >: REST three-dimensional service address, pointing to the root resource path of the service, such as http://localhost:8090/iserver/services/3D-sample/rest.
< useCache >: Enable caching. The default is true. After the cache is turned on, the The REST request will be cached locally, and the next time the same request is received, it will be read directly in the cache without sending it to the server.
< restProviderCacheConfig >: The storage settings that service providers request to cache in memory, including:
< maxElementsInMemory >: The maximum number of request records allowed to be stored in memory. 0 means no limit; 1 means no memory cache. The default is 1. If not 1, the request record is stored in memory first.
< maxSizeOnDisk >: Maximum disk capacity. The unit is MB, and the default size is 2048 MB.
< timeToLiveSeconds >: Set the upper limit of cache survival time, and the cache will be cleared automatically after timeout. It is calculated from the creation of the record, and the unit is second. The default is 0, which means that the cache is permanently alive.
< timeToIdleSeconds >: Set the upper limit of cache idle time, and the cache will be cleared automatically after timeout. Calculated from the last time it was accessed, in seconds. The default is 0, which means the cache is permanently alive.
< token >: When security mechanisms are enabled, accessing protected REST resources requires providing a Token.

Configure MongoDB 3D Service Provider

Configure a MongoDB 3D service providers as follows:

<!-- MongoDB 3D service provider-->
<provider class="com.supermap.services.providers.MongoDBRealspaceProvider" enabled="true" name="mongoDB3DProvider-scene"> 
      <config class="com.supermap.services.providers.MongoDBRealspaceProviderSetting"> 
        <serverAdresses> 
          <string>192.168.120.47:27017</string> 
        </serverAdresses>  
        <database>smtiles</database>  
        <username>iserver</username>  
        <password>iserver</password>  
        <tilesetNames> 
          <string>1181328118</string> 
        </tilesetNames> 
      </config> 
 </provider>

The class in < provider > identifies the implementation class of MongoDB 3D service provider, and the class in < config > identifies the configuration class corresponding to the MongoDB 3D service provider, that is, MongoDBRealspaceProviderSetting . The content in < config > is the corresponding configuration item. Including:

< serveradresses >: MongoDB service address.
< tilesetNames >: An array of slice sets. If the parameter is null, publish MongoDB All 3D tilesets in the database.
< database >: The database used to store the map tiles. The default is to use the name smtiles The database for.
< username >: The user with permission to access the database.
< password >: The password for the user.

Configure Local 3D Realspace Provider

Configure a local 3D realspace provider as follows:

<!-- 3D Slice Cache Service Provider-->
<provider class="com.supermap.services.providers.LocalRealspaceProvider" enabled="true" name="local3DCache-osgb"> 
      <config class="com.supermap.services.providers.LocalRealspaceProviderSetting"> 
        <configFile>..../samples/Data/3D_Cache/osgb/jinjiang_Compressed-test.scp</configFile>
        <isMultiInstance>false</isMultiInstance>
        <clipregions> 
          <com.supermap.services.components.commontypes.georegion3d> 
            <id>0</id>  
            <points class="com.supermap.services.components.commontypes.Point3D-array"> 
              <com.supermap.services.components.commontypes.point3d> 
                <x>121.0</x>  
                <y>38.0</y>  
                <z>-6.0</z> 
              </com.supermap.services.components.commontypes.point3d>  
              <com.supermap.services.components.commontypes.point3d> 
                <x>121.0</x>  
                <y>38.0</y>  
                <z>-48.0</z> 
              </com.supermap.services.components.commontypes.point3d>  
              <com.supermap.services.components.commontypes.point3d> 
                <x>121.0</x>  
                <y>38.0</y>  
                <z>-49.0</z> 
              </com.supermap.services.components.commontypes.point3d> 
            </points>  
            <parts> 
              <int>3</int> 
            </parts>  
            <type>REGION3D</type>  
            <rotationx>0.0</rotationx>  
            <rotationy>0.0</rotationy>  
            <rotationz>0.0</rotationz>  
            <scalex>0.0</scalex>  
            <scaley>0.0</scaley>  
            <scalez>0.0</scalez> 
          </com.supermap.services.components.commontypes.georegion3d> 
        </clipregions> 
      </config> 
 </provider>

The class in < provider > identifies the implementation class of the local 3D realspace provider, and the class in < config > identifies the configuration class corresponding to the 3D slice caching service provider, that is, LocalRealspaceProviderSetting, and the content in < config > is the corresponding configuration item. Including:

< configFile >: Path to config path.
< isMultiInstance >: Whether multiple instances are supported.
< clipregions >: Clipe regions.
< rotation X >: The rotation angle of the 3D geometric object along the X axis, in degrees.
< rotationY >: The rotation angle of the 3D geometric object along the Y axis, in degrees.
< rotationZ >: The rotation angle of the 3D geometric object along the Z axis, in degrees.
< scalex >: The scaling of 3D geometric objects along the X axis.
< scaley >: The scaling of 3D geometric objects along the Y axis.
< scalez >: The scaling of 3D geometric objects along the Z axis.

Configure 3D Tiles Realspace Provider.

Configure a 3D tiles realspace provider:

<!--3DTiles caching service provider-->
<provider class="com.supermap.services.providers.ThreeDTilesRealspaceProvider" enabled="true" name="ThreeDTilesCache-attribute"> 
      <config class="com.supermap.services.providers.ThreeDTilesRealspaceProviderSetting"> 
        <configFile>E:/test-data/pointHanging/NewDGN/attribute.json</configFile>
        <isMultiInstance>false</isMultiInstance>
      </config> 
 </provider>

The class in < provider > identifies the implementation class of the 3dtiles realspace provider, and The class in < config > identifies the configuration class corresponding to the 3DTiles caching service provider, that is, ThreeDTilesRealspaceProviderSetting. The content in < config > is the corresponding configuration item. Including:

< configFile >: Path to config path.
< isMultiInstance >: Whether multiple instances are supported.

Configure OSS 3D Tiles Cache Service Provider (obsolete)

Configure an OSS 3D tiles cache service providers:

<!-- 3D tiles cache service provider-->
<provider class="com.supermap.services.providers.OssRealspaceProvider" enabled="true" name="oss3DCache-233232"> 
      <config class="com.supermap.services.providers.OssRealspaceProviderSetting"> 
        <configPath>Config.scp</configPath>
        <ossWebsite>http://oss-cn-beijing.aliyuncs.com</ossWebsite>
        <bucketName>233232</bucketName>
        <accessKeyId>LTAI4G8HxYSCzAsbSuperMap</accessKeyId>
        <accessKeySecret>GQDvAQ2UXkjrwrtVo0cOVX1SuperMap</accessKeySecret>
        <isMultiInstance>false</isMultiInstance>
        <cacheKey>SuperMapUXkjrwrtVo0</cacheKey> 
      </config> 
 </provider>

The class in < provider > identifies the implementation class of 3D tiles cache service providers, and the class in < config > identifies the configuration class corresponding to the OSS 3D tile caching service provider, namely OssRealspaceProviderSetting. The content in < config > is the corresponding configuration item. Including:

< configPath >: The path to the config path.
< ossWebsite >: The storage address of the OSS object to be published, such as the http://oss-cn-beijing.aliyuncs.com.
< bucketName >: the name of the OSS storage space to be published
< accessKeyId >: Required for obtaining the authorization of the Alibaba Cloud product OpenAPI interface ID
< accessKeySecret >: Secret required to obtain OpenAPI interface authorization for Alibaba Cloud products
< isMultiInstance >: Whether multiple instances are supported.
< cacheKey >: The key for the config path.

Configure S3 3D Tiles Cache Service Provider

Configure an S3 3D tiles cache service providers:

<!-- S3 3D tile caching service provider-->
<provider class="com.supermap.services.providers.SuperMapTilesRealspaceProvider" enabled="true" name="s33DCache-sichuanImage-2"> 
      <config class="com.supermap.services.providers.SuperMapTilesRealspaceProviderSetting"> 
        <configFile>/sct/sichuan_Image/sichuan_Image.sci3d</configFile>
        <s3ConnectionInfo>
          <endpoint>http://172.16.1.1:9090</endpoint>
          <region>us-east-1</region>
          <accessKey>minioadmin</accessKey>
          <secretKey>minioadmin</secretKey>
        </s3ConnectionInfo>
        <cacheKey>123456</cacheKey>
        <isMultiInstance>false</isMultiInstance> 
      </config> 
 </provider>

The class in < provider > identifies the implementation class of S3 3D tiles cache service providers, and the class in < config > Class identifies the configuration class corresponding to S3 3D tiles cache service providers, namely SuperMapTilesRealspaceProviderSetting . The content in < config > is the corresponding configuration item. Including:

< s3ConnectionInfo >: The connection info for the S3 object store.
< accessKey >: Access key ID. The unique identifier associated with the private access key; the access key The ID is used with the private access key to cryptographically sign the request.
< secretKey >: The private access key used in conjunction with the access key ID to cryptographically sign the request, identify the sender, and prevent the request from being modified.
< region >: The region where the Bucket is located in the object storage service. When the storage type is This parameter is required for Amazon S3 object storage.
< endpoint >: The endpoint node is the area domain name of the object storage service in different areas, which is used to process the access requests of their respective areas. Such as http(s)://obs.cn-north-4.myhuaweicloud.com. If MinIO is used, TCP should be used when configuring the domain name port.
< configFile >: Path to the tile config file in the object store, such as/supermap/world/world.sci3d, where the first level of the directory is the bucket (Bucket) name
< cachekey >: 3D cache key.
< isMultiInstance >: Whether multiple instances are supported.

Configure UGCV5 (MVT) 3D Service Provider

Configure a UGCV5 (MVT) 3D service providers:

<!--UGCV5 (MVT) 3D service provider-->
<provider class="com.supermap.services.providers.MVTTileRealspaceProvider" enabled="true" name="3Dmvt-ShiJieDiTuDay"> 
      <config class="com.supermap.services.providers.ThreeDTilesRealspaceProviderSetting"> 
        <configFile>F:/World Map_Day/World Map_Day.sci</configFile>
        <isMultiInstance>false</isMultiInstance>
      </config> 
 </provider>

The class in < provider > identifies the implementation class of UGCV5 (MVT) 3D service providers, and the class in < config > identifies the configuration class corresponding to the UGCV5 (MVT) 3D service provider, that is, ThreeDTilesRealspaceProviderSetting . The content in < config > is the corresponding configuration item. Including:

< configFile >: Path to UGCV5 tile config file, e.g. F:/World Map_Day/World Map_Day.sci
< isMultiInstance >: Whether multiple instances are supported.