Supporting service

SuperMap iPortal supports access to third-party functional services, such as the Web Printing service in SuperMap iServer, as supporting service of iPortal. These supporting services can be used in iPortal's WebApps and functional modules. iPortal administrators can optionally perform the following configurations according to their own business needs:

• Web Printing configuration
• Address Matching Service Configuration
• Search service configuration
• Spatial analysis service configuration
  • Standard spatial analysis service
  • Distributed spatial analysis service
• Model dataset service configuration
• Real-time traffic service configuration

Web Printing configuration

SuperMap iPortal supports the Web Printing configuration in SuperMap iServer , which can realize map printing in DataViz WebApp, and output the produced map as a printable document. The iPortal administrator can complete the Web Printing configuration through the following steps to access the Web Printing function in iServer:

1. Log in to the home page of the portal as an administrator, and click Management > App Center Management > Support Services to enter the Web Printing configuration page
2. Web Printing Url: fill in the address of the connected iServer Web Printing service, the format is: http://<server>:<port>/iserver/services/webprinting/rest/webprinting/v1
3. iPortal Root Url (optional): fill in this the actual root address of iPortal, in the format: http://<server>:<port>/iportal. If this parameter is empty, it means The iServer Web Printing service can directly access the relevant address of this iPortal involved in the print content. If your network environment is more complicated, it is recommended that you perform this configuration
4. Click the "Save" button to complete the Web Printing service configuration

After the configuration is complete, you can use the Web Printing function in DataViz WebApp.

Address Matching Service Configuration

When adding layers in DataViZ WebApp or MapStudio WebApp using file upload, if the source file expresses the location information through addresses, you can parse the city boundaries and address descriptions through the Address Matching Service or Geocoding Service to return the corresponding geographic coordinates and structured address details.

Log in to the home page of the portal as an administrator, and click Management > App Center Management > Support Services to enter the Address Matching Service page, and add an address matching service address or geocoding service key:

• SuperMap iServer Address Matching Service: Fill in the address of the address matching service in SuperMap iServer, for example: http://<server>:<port>/iserver/services/addressmatch-address/restjsr/v1/ address

• SuperMap Online Geocoding Service: Fill in the Key of the geocoding service. Note that you must carry the Key to call the REST API of the geocoding service, and the application address is https://www.supermapol.com/web/mycontent/keys/register

After you finish filling in the application, click “Save” button.

Search service configuration

DataViz  WebApp, or MapStudio WebApp POI serch control, provides the ability to search POI information.

You needs to configure the search service provider as an administrator before using the POI search. Click 'Administration' > 'App Center Management' > 'Support Service', select the "Search Services" Tab page, select the service type and fill in parameters:

• SuperMap iServer REST Data Service: fill in the SuperMap iServer REST data service address and query fields (separated by commas). The address example is as follows: http://<server>:<port>/iserver/services/data-changchun/rest/data/datasources/Changchun/datasets/Hospital

• SuperMap Onine Local  Search Service: Enter the key of SuperMap Online local search service. It should be noted that the requirement of calling REST API of local search service is Key, application address of Key: https://www.supermapol.com/web/mycontent/keys/register

• Elasticsearch Search Service: Fill in the Elasticsearch search service address. You can enter the query fields and coordinates fields (separated by commas). The service address is as follows: http://{ip}:{port}/index/type

Spatial analysis service configuration

DataInsights currently offers two spatial analysis tools: standard spatial analysis and distributed spatial analysis. To use the iServer-based standard spatial analysis tool and distributed spatial analysis tool, you need to configure the analysis service address first.

Standard spatial analysis service

Standard spatial analysis supports client-side spatial analysis and SuperMap iServer-based spatial analysis in two ways, among which, client-side spatial analysis can be used without configuration; iServer-based spatial analysis function requires the use of iServer's spatial analysis tool, and the steps to add iServer analysis server in iPortal are as follows:

Login to the portal home page as administrator, click "Management">"App Center Management">"Support Services", select " Spatial analysis service" tab, and fill in the parameters under "Standard spatial analysis service":

1. Service Address: Enter the iServer spatial analysis service address, for example: http://ip:port/iserver/services/spatialanalyst-xx/restjsr/spatialanalyst
2. Token: If the spatial analysis service published in iServer is protected, you need toenter the token of iServer, to obtain the token, please see: 获取 Token
3. Click the "Save" button to take effect

Distributed spatial analysis service

The distributed spatial analysis function of DataInsights is based on the distributed analysis service of SuperMap iServer, so it is necessary to add a distributed analysis service enabled iServer server with distributed analysis service enabled for distributed spatial analysis of DataInsights.

After opening the distributed analysis service in SuperMap iServer, add iServer distributed analysis server in iPortal, proceed as follows:

Login to the portal home page as administrator, click "Management">"App Center Management">"Support Services", select "Spatial Analysis Service" tab, and fill in the parameters under "Distributed Spatial Analysis Service":

1. Service address: Enter iServer distributed analytics service address, for example：http://ip:port/iserver/services/distributedanalyst/rest/v1/jobs
2. Token: If the distributed analysis service in iServer is protected, you need toenter the token of iServer, to obtain the token, please see: 获取 Token
3. Click the "Save" button to take effect

Note:

1. For distributed spatial analysis of Excel, CSV, and GeoJSON format data, iPortal hosted iServer server, iServer server configured for relational storage, and iServer server for distributed analysis, all three need to be the same SuperMap iServer
2. For distributed analysis of registered HDFS data, iPortal hosted iServer server and the iServer server for distributed analysis, both need to be the same SuperMap iServer

For hosted server configurations, see: hosted servers: For relational storage configurations, see: hosted data storage configuration.

Model dataset service configuration

Log in to the home page of the portal as an administrator, and click Management > App Center Management > Support Services to enter the Model dataset service page:

1. "Model dataset address": fill in the iServer service address of the model dataset, the format is：http://ip:port/iserver/services/{serviceId}/rest/data/datasources/{datasourceName}/datasets/{datasetName};
2. "iServer administrator account name": fill in the iServer service administrator account of the model dataset;
3. "iServer administrator account password":  fill in the iServer service administrator password of the model dataset;
4. "Is cloud native": whether the iServer server of the model dataset is a cloud-native environment;
5. Click the "Save" button to complete the Model dataset service configuration

After the configuration is complete, you can use the Model dataset service in iDesigner 3D WebApp.

Real-time traffic service configuration

Log in to the home page of the portal as an administrator, and click Management > App Center Management > Support Services to enter the Real-time traffic service page:

1. "Get A key": Log in SuperMap Online, request real-time traffic service;
2. "Service Key": fill in service key;
3. Click the "Save" button to complete the real-time traffic service configuration

After the configuration is complete, you can use the real-time traffic service in DataViz WebApp.