Configure a vector tile layer

Before you share a vector tile layer, you can configure it to specify the caching method and location, the tiling scheme, the levels of detail to cache, the tiling format, and other properties. This workflow explains how to modify the default configuration of a vector tile layer. To begin the sharing process, set general properties, and finish sharing, see Share a vector tile layer.

  1. If necessary, open the Share As Web Layer pane.

    On the General tab, confirm that Vector Tile is selected.

  2. Click the Configuration tab. If necessary, click the Configure vector tile layer properties tab Configure vector tile layer properties below it.
  3. Under Caching, choose where to build the cache.

    If you share to ArcGIS Enterprise, you can cache on the server or locally. If you share to ArcGIS Online, you can cache online or locally.

    Cache on the server or Cache online

    (The option name depends on your portal.)

    A vector tile layer is shared with an associated feature layer. The feature layer supports editing, querying features outside the current view, and richer statistics. When this option is available, it is the default.

    Cache locally

    A vector tile package (.vtpk) is shared to your portal and used to publish the vector tile layer. An associated feature layer is not published.

    1. If you cache locally, accept the default Temp cache location that is determined by your share and download options settings, or browse to a different location.
    Note:

    If you share a vector tile layer that references registered data to ArcGIS Enterprise, no caching options are presented. The web vector tile layer is cached on the server automatically and associated map image and feature layers are published.

  4. Click the Tiling Scheme drop-down arrow and choose a tiling scheme for your cache.

    The tiling scheme determines the number of levels of detail, the tile dimensions, and the tile origin of the cache. These settings in turn define tile boundaries and must be the same for different web layers used in a web map. The available tiling schemes are described in the following table:

    Option

    Description

    ArcGIS Online/Bing Maps/Google Maps

    The web layer is projected to the WGS 1984 Web Mercator (Auxiliary Sphere) coordinate system. The default tile width and height is 512 by 512 pixels. Scale levels for caching range from zero to 23.

    This is the only tiling scheme available when you share to Portal for ArcGIS 10.4 or 10.4.1.

    WGS 1984 Geographic Coordinate System, Version 2

    The web layer is projected to the WGS 1984 Geographic Coordinate System. The default tile width and height is 512 by 512 pixels. Scale levels for caching range from zero to 22.

    Existing vector tile layer

    The tiling scheme of an existing vector tile layer is used. Browse to a location in your portal and select a vector tile layer. The tiling scheme XML file associated with the layer is downloaded to C:\Users\<user profile>\My Documents\ArcGIS\TilingSchemes\Downloaded.

    Tiling scheme file

    A tiling scheme that you create is used. You can create a tiling scheme XML file with the Generate Map Server Cache Tiling Scheme geoprocessing tool. Additional tiling scheme files can be imported from C:\Program Files\ArcGIS\Pro\Resources\TilingSchemes. Only tiling schemes with scales that double in progression through levels of detail and have 512 by 512 pixel size are supported. The scale defined at level of detail zero must cover the extent of your data.

    Auto-suggest

    This is the default option unless the coordinate system of your map is WGS 1984 Web Mercator (Auxiliary Sphere) or WGS 1984. A tiling scheme is suggested based on the coordinate system of your map. The levels of detail defined in this tiling scheme are valid for a global extent, so any web layers cached using this tiling scheme can be displayed together. Although the tiling scheme is valid for a global extent, only the extent defined in the map properties is cached.

  5. Under Levels of Detail, use the sliders to set the map scales for which tiles are generated.

    A default scale range is provided. Depending on the purpose of your map and the estimated cache size, you may choose not to cache some very large or small scales.

  6. Under Options, choose a Tiling Format.
    Indexed

    Produce tiles based on an index of feature density that optimizes the tile generation and file sizes. This is the default.

    Flat

    Produce regular tiles for each level of detail without regard to feature density. This cache is larger than that produced with an indexed structure.

    Note:

    When vector tiles are generated, a contiguous mesh of square tiles is created for each level of detail (LOD) defined by the tiling scheme. The scale of the tiling scheme must double in progression. For example, if the scale is 1:2,000 at LOD1, it must be 1:1,000 at LOD2, 1:500 at LOD3, and so on. When a flat tiling format is used, a complete set of tiles is generated at each LOD without regard to the density of features in any given area. When an indexed format is used, feature density is evaluated to see whether tiles can be reused. For example, an indexed tiling format does not create tiles at high LODs for an area of empty ocean because the area can be represented acceptably by a tile created for a low LOD. This saves tile creation time, storage space, and drawing speed.

    1. Optionally, if you are caching locally and using an indexed tiling format, select or browse to an Index Polygons dataset.

      If the Index Polygons option is disabled because you are caching on the server, or if no dataset is specified, index polygons are automatically generated and used for this caching process; however, they are not saved and can't be reused.

      Tip:

      You can create an index polygons dataset with the Create Vector Tile Index tool. This is useful if you anticipate processing the same map more than once. The dataset can be viewed as a map layer so you can see how the feature density of your data is evaluated.

  7. Optionally, check the Allow clients to export cache tiles check box to allow clients to download map tiles for offline use.

    When this option is turned on, you can specify a value in the Limit export to box to limit the number of tiles that can be downloaded in a single request.

Configure associated web feature layer properties

If the vector tile layer has an associated web feature layer, you can configure the feature layer properties. The properties that can be configured depend on your active portal, your software version (if you are sharing to an ArcGIS Enterprise portal), and whether you are referencing data or copying data to the server. See the table in Configure a web feature layer for details.

Follow these steps to configure the properties of the web feature layer.

  1. Click the Configure web layer properties tab Configure web layer properties.
  2. Under Operations, check the Approve for Public Data Collection check box to allow public editing on a web feature layer that copies all data.

    If the web layer is shared with everyone, you must approve the layer for public data collection before you can enable editing.

    This option does not appear when you share a web feature layer that references registered data or share to an ArcGIS Enterprise 10.8.1 or earlier portal.

    Caution:

    If editing is enabled on a layer that is shared with the public, anyone can edit it without signing in to your organization. For optimal performance and to prevent data loss or corruption, disable editing or share the layer only with your organization. For more information, see Allow or prevent editing on public layers.

  3. Check the Enable editing and allow editors to check box to enable web feature layer editing.

    If you are sharing a web feature layer that references registered data to ArcGIS Enterprise, editing is enabled by default. If you are sharing a web feature layer that copies all data to ArcGIS Enterprise, or if you are sharing to ArcGIS Online, editing is not enabled by default.

    If you are sharing to ArcGIS Online, referencing registered data to an ArcGIS Enterprise portal, or copying all data to an ArcGIS Enterprise 10.8.1 or later portal, choose which editing operations are permitted from the following table:

    OptionDescription
    Add

    Editors can add feature geometry and provide attribute values when they create the feature. This option is enabled by default. Once features are created, the Update option must be enabled for editors to modify features or their attributes.

    Delete

    Editors can delete features. This option is enabled by default.

    Update

    When this option is enabled, the Attributes and geometry option is enabled by default, allowing editors to update feature geometry and attributes. Choose Attributes only to allow editors to update attributes for existing features only. They cannot modify feature geometry.

    Note:

    For ArcGIS Enterprise 10.8 or earlier portals, the editing operations are different if you are sharing a web feature layer that copies all data.

    ArcGIS Enterprise versionOptions

    ArcGIS Enterprise 10.6.1 through 10.8

    • Add, update, and delete features
    • Add and update features
    • Add features
    • Update features
    • Update attributes only

    ArcGIS Enterprise 10.4 through 10.6

    • Add, update, and delete features
    • Update feature attributes only
    • Add features only

    The editing options are disabled if you are sharing a vector tile layer that references registered data from a file or mobile geodatabase.

    Caution:

    If you share a web feature layer that references registered data, editing operations cannot be modified through the website for your ArcGIS organization; use ArcGIS Server Manager instead. For more information, see Edit service properties in Server Manager in the ArcGIS Enterprise help.

  4. Check the Enable Sync box to allow users to work with a local copy of the data when they are offline and to synchronize changes when they are online.
  5. Check the Export Data check box to allow others to export the data to different formats.
  6. Check the Apply default to features with z-value check box to allow editors to add or update features through clients that don't allow a z-value to be given.
    1. Use Default z-value when inserting or updating features to set a default z-value.
  7. Check the Allow geometry updates without m-value check box to allow geometry updates to m-enabled features without specifying an m-value.
  8. Optionally, check the Preserve editor tracking info box.

    This option does not appear when you share a vector tile layer that references registered data to ArcGIS Enterprise.

    Note:

    Features created before the layer is shared may store names in editor tracking fields that don't match user names in your ArcGIS organization. For example, they may store a user name from a desktop computer or database. When you subsequently manage the web layer in your portal, you may want to restrict editing privileges so that editors can edit only features they have created themselves. (On the web layer's item details page, on the Settings tab, this option is called What features can editors edit?) If you make this restriction, and if you also chose to preserve editor tracking information, no one in your organization—except administrators—can edit existing features in the web layer because no one is recognized as the creator of those features. This is the main reason to consider not preserving editor tracking information.

    Learn more about editor tracking

Configure parameters

If you are sharing a vector tile layer with an associated feature layer, complete the following steps to configure parameters. For more information, see Service parameters.

  1. At the top of the pane, under the Configuration tab, click Configure Parameters Configure parameters.
  2. Under Properties, specify a value for Maximum records returned by server.

    This property appears if you are sharing to ArcGIS Enterprise. It specifies the number of records that can be returned by a user query. A large number may result in slower performance. The default value is 2,000.

  3. Optionally, under Date Fields, click the Time zone of the data drop-down arrow and choose the time zone in which your date values are stored.

    If your layer contains date fields, specifying the time zone allows date and time values to be converted correctly when users interact with the web feature layer. This setting does not appear when you share a web feature layer that copies all data to an ArcGIS Enterprise 10.5 or earlier portal.

    Note:

    If you don't specify a time zone, date values are assumed to be stored in UTC.

    1. If you choose a time zone other than UTC (coordinated universal time) and you want the time zone to account for daylight saving time, check Adjust For Daylight Saving.
  4. If you selected a time zone other than None (Assumed UTC), optionally click the Preferred time zone for display drop-down arrow and choose a time zone for ArcGIS Pro to use when displaying queries from the web feature layer.

    ArcGIS Pro will display date fields in UTC if no preferred time zone is specified. This setting does not appear when you share a web feature layer that copies all data to an ArcGIS Enterprise 11.0 or earlier portal.

    1. If you choose a preferred time zone other than None (Assumed UTC) and you want the preferred time zone to account for daylight saving time, check Adjust For Daylight Saving.
  5. Optionally, under Settings, uncheck the Ensure map is set to allow assignment of unique IDs check box. If the box is checked (the default), the map is analyzed to confirm that the Allow assignment of unique numeric IDs for sharing web layers option in Map Properties is enabled. If the box is unchecked, the analyzer is skipped. If the option in Map Properties is not enabled, unique IDs are automatically assigned to layers and tables when the web layer is published.

    Note:

    Checking the check box does not automatically enable any option in Map Properties. Authoring the map with assigned layer and table IDs ensures they remain static if the contents or layer ordering in your map change. When overwriting the web layer, assigned IDs must match existing service sublayer IDs to maintain references to them in web maps.

    Learn more about assigning layer IDs

  6. Optionally, check the Use symbol types compatible with all clients check box to convert ArcGIS Pro symbols to web symbols that can be rendered by all applications, including most older clients.

    When the box is unchecked, 2D point, line, and polygon symbols are preserved as ArcGIS Pro symbols, also known as Esri Cartographic Information Model (CIM) symbols. Alternate symbols used in feature layers are also preserved. Uncheck the box if your web layer will be used in newer client applications that support rendering CIM symbols, such as ArcGIS API for JavaScript 4.x. CIM symbols appear downgraded in older clients, such as Map Viewer Classic.

    This option is checked by default when sharing to ArcGIS Enterprise 11.0 or earlier.

    This option does not appear when sharing to ArcGIS Enterprise 10.8 or earlier. For these portal versions, ArcGIS Pro symbols are automatically converted to web symbols.

Related topics