To fully leverage the capabilities of vector tiles service V2, such as multi-style browsing, multi-level filtering, and high-performance rendering, iServer provides three types of properties modules—style, data, and cache—offering full-chain management functionality. This section will introduce the specific configuration process and precautions.

Operation Steps

Function Entry:

• service managementHome‐>Services‐>service managementtab‐>Specify vector tiles service V2

Operation Instructions:

（1）Style Configuration

After the service was published finished, you can directly use the default styles provided by iServer for browsing. However, in addition to the styles configured during publishing, you may want to add other styles or edit and modify the configured styles. In this case, you can use the style configuration capability. Style configuration supports adding styles, editing styles, deleting styles, and browsing styles. Details are as follows:

• Add Style: Supports adding style templates and style files through the Add Style button in the upper-left corner of the interface.
  • Add Style Template: You can select one or more from the style template list provided by Style Management to add.
  • Add Style File: You can add styles exported by the "Map Export as WebMap" tool in iDesktopX 2026 and above, as well as Mapbox standard styles. The datasets and fields used in the style must be consistent with the datasets and attribute fields selected in the dataset settings step. In addition, you can set a custom name for the style during the adding process. If not set, the file name of the style file will be used by default.
• Edit Style: Supports editing styles through the Edit operation behind each style in the service style list.
  • Edit Style Template: You can edit the layer and field mapping for style templates set during service publishing or added during style configuration. For usage details, see Layer Mapping.
  • Edit Style File: You can perform data mapping and rendering style editing for style files set during service publishing or added during style configuration.
    • Data Mapping: Refers to binding the data source used in the style file with the database used by the current service. Click One-Click Mapping to complete. After you add a style file in the style configuration function, it is recommended to perform this operation.
    • Rendering Style Editing: When you need to modify the rendering style of the map, such as colors, please use this function to edit. You can directly modify the JSON file through the interface.
  • In addition, each style in the service style list supports name setting. Click the edit button after the name to enter a custom name. This custom name will be used in subsequent service usage. If not set, the original name in the list will still be used.
• Delete Style: Supports deleting a specified style through the Delete operation behind each style in the service style list.
• After completing all the above modifications, click Save in the upper-right corner of the interface to apply the results to the service.
• Browse Styles: Supports previewing maps with different styles in OpenLayers representation through the Preview operation behind each style in the service style list.

（2）Data Configuration

To control the visible range of data and optimize tile generation efficiency, iServer provides SQL condition filtering and attribute field selection functions, supporting adding corresponding conditions to published datasets. Specific operations are as follows:

• On the iServer service details-Provider tab, perform the following configurations:
  • Buffer Range: Set the tile buffer range. Each tile expands outward according to the set range value, meaning the generated tiles include data within the buffer range. The purpose of setting the buffer range is to ensure seamless connections between adjacent tiles during browsing. The default value is 16, in pixels.
  • Thinning Display: Supports checking. iServer will thin out geometric objects at small scales to improve display performance. If unchecked, it means no thinning. By default, it is unchecked.
• On the iServer service details-Data tab, click Add Data and perform the following configurations:
  • Dataset: Select the dataset for which you need to add data conditions. The selected dataset will be used as a layer for mapping. If not added, no dataset will be available for map rendering.
  • Filter Options: Filter out the required feature objects from the selected dataset based on filter conditions. This setting takes effect for all styles in the service. Supports filter expressions conforming to SQL statement specifications. Expressions can contain multiple conditions, for example: dlbm='011' or dlbm='013'.
  • Attribute Fields: Supports selecting attribute fields to be included in tiles from the selected dataset. These fields can be used for queries. If not selected, the generated tiles will not contain attribute information. This setting takes effect for all styles in the service.
  • After configuration completed, click OK. After the pop-up window closes, click Save.
• In addition, you can also edit the data info configured during service publishing or in service details by clicking the Edit operation behind the service data list. The editable content is the same as the Add Data function. Note: If vector pre-cache has already been generated for the service, you need to clear the existing cache and regenerate it for the current settings to take effect.

You can also delete existing data in the service by clicking the Delete operation behind the service data list. Note: If data is deleted, layers mapped to that dataset in styles will not be able to render.

After completing all the above modifications, click Save in the upper-right corner of the interface to apply the results to the service.

（3）Cache Configuration

To ensure high-performance map rendering, iServer provides a series of caching mechanisms for vector tiles service V2. You can configure them as needed. Details are as follows:

• On the iServer service details-Cache tab, perform the following configurations:
  • Enable Caching: Enabled by default. When enabled, the service will prioritize using raster and vector pre-caches under the specified storage location. If pre-caches do not exist, dynamic caching will be performed to ensure map rendering performance.
  • Vector Storage Location: Currently only supports ./output/MVT.
  • Vector Pre-cache: Will display the vector cache levels that already exist locally (including dynamic cache and pre-cache).
  • Raster Storage Location: Currently only supports ./output/cache.
  • Raster Pre-cache: Will display the raster cache levels that already exist locally by style (including dynamic cache and pre-cache).

Precautions

• The uploaded style file package (*.zip) should satisfy the following directory structure:

Root Directory/
├─ WebMap.json
├─ sprites/
└─ fonts/

• When the map contains datasets with large data volumes, it is recommended to create pre-caches first; otherwise, it will affect rendering performance and results.
• When a service configured with style templates needs to be migrated to another iServer, please copy the entire %iServer_HOME%/webapps/iserver/web-inf/config/vectorstyles/template directory to the corresponding directory of the new iServer.

Related Topics

• Overview of Next-Generation Vector Tiles Service
• publish services
• Pre-cache Generation
• Use Services