Map image layers support map visualization and vector querying. They can be drawn dynamically by the server or using tiles from a cache.
With ArcGIS Enterprise as your active portal, you can author and share map image layers. When sharing a map image layer, you have the option to reference enterprise data that has been registered with your federated server and can include additional layer types such as WMS. If your organization has multiple federated servers, you can choose which server the service is published to. The privilege to publish server-based layers is required to share a map image layer.
When creating a map, use the guidelines outlined in Author a multiscaled map to ensure optimal performance for your map image layer. Maps that are created in ArcGIS Desktop and imported into ArcGIS Pro should also match these guidelines.
For more information on when to reference registered data, see Introduction to sharing web layers.
Deleting the layer through the ArcGIS Enterprise portal will not delete the underlying service. The service must be deleted separately through ArcGIS Server Manager. For more information, see: Relationships between web services and portal items.
Share a map image layer
- To share a map image layer, do one of the following:
- Share the map and all of its layers as a web layer. On the Share tab, in the Share As group, click Publish Web Layer .
- Share selected layers from the map as a web layer. Select the layers in the Contents pane. Right-click the selected layers, point to the Sharing pull-right menu, and click Share As Web Layer .
The Share As Web Layer pane appears.
- Provide the name for the web layer. By default, the web layer will be saved to My Content. You can save the web layer to a folder in My Content by typing the folder name or clicking the browse button to browse to an existing folder.
Separate the name of the new or existing folder and the web layer name with a backslash, for example, Folder\WebLayerName. For more information, see Specifying a folder.
- For Layer Type, click Map Image.
- If you would like to reference registered data sources, select the Reference registered data check box. Selecting Reference registered data will also enable to option to select the layer type Feature; doing so will include a dependent feature layer.
- Complete the Summary and Tags fields.
- Specify how the web layer will be shared:
- My Content—This option only references content in your personal workspace named My Content. Your content is inaccessible to other users.
- My Organization—This option allows your content to be shared with all authenticated users in the organization.
- Everyone—This option makes your content public. Anyone can access and see it.
- Groups—You can share your content with groups you belong to and their members.
- Optionally, click the Content tab to view the new web layer or layers and associated components.
If you have access to multiple federated servers, you can click the Federated Servers drop-down arrow to choose where the to share the layer.
- Click Analyze to check for any errors or issues. You must resolve all errors. If any issues are discovered, they appear on the Messages tab. Right-click each message to get more information, read the help for the error or warning, and access suggested fixes. Learn more about analyzing GIS resources
- Once validated, click Publish to share your web layer using the default configuration.
- Once the web layer has been successfully published, click the Manage the web layer link to manage the web layer.
If you configured your map image layer to draw Using tiles from a cache, after publishing is complete, use ArcMap to view cache properties and ArcGIS Server manager to view the cache status.
Configure a map image layer
By default, map, data, and query are enabled for map image layers. You can configure your map image layer prior to publishing to allow users to query, find and identify features. You can also configure a number of service level parameters.
- Click the Configuration tab.
- Optionally, include additional layer types and capabilities by clicking the check box next to the layer or capability. For more information, see Additional layers and capabilities.
- Linear Referencing
- Network Analysis
- Version Management
- Click Configure Web Layer Properties to the right of Map Image to access the configurable properties.
- By default, Map, Data, and Query are enabled:
By default, map is turned on and disabled. This capability allows the Export Map, Generate Renderer, and Generate KML methods to be used.
By default, data is turned on. This capability allows the Find, Query, and Query Related Records methods to be used.
By default, query is turned on. This capability allows the Identify method to be used.
- Optionally, turn off Allow per request modification of layer order and symbology. This prevents client applications from changing the behavior or symbology of the sub-layers.
- Choose how the web layer will be drawn:
Dynamically from the data
Retrieve the data and draw it each time it is requested.
Using tiles from a cache
Draw from pre-cached images generated at scale levels you define.
If you select Using tiles from a cache, see Common caching questions.
If a cache with the same name as the new web layer already exists on the target server, the new web layer will default to Using tiles from a cache and the existing cache will be used. If a cache with the same name as the new web layer does not exist, the web layer will by default draw Dynamically from the data.
- If you choose to draw Using tiles from a cache and an existing cache does not exist, additionally choose a Tiling Scheme that defines the scale levels, tile dimensions, and tile origin for the cache. These properties define where tile boundaries will exist and are important to match when overlaying caches. Tiling scheme options include the following:
ArcGIS Online/Bing Maps/Google Maps
This is the default tiling scheme. The coordinate system of the web layer is reprojected on the fly to WGS 1984 Web Mercator (Auxiliary Sphere) to ensure your web tile layer overlays with these online services. The default tile width and height is 256 by 256 pixels. Scale levels for caching range from zero to nineteen. When you initialize a new cache, ArcGIS Pro examines the layers in your GIS resource and selects a default tile image format for you. If your GIS resource contains only vector layers, the default is PNG. If at least one raster layer is detected, the default is MIXED.
WGS 1984 Geographic Coordinate System, Version 2
A tiling scheme based on the WGS 1984 Geographic Coordinate System. The coordinate system of the web layer is reprojected on the fly to WGS 1984 Geographic Coordinate System. The default tile width and height is 256 by 256 pixels. Scale levels for caching range from zero to twenty-two. When you initialize a new cache, ArcGIS Pro examines the layers in your map and selects a default tile image format for you. If your GIS resource contains only vector layers, the default is PNG. If at least one raster layer is detected, the default is MIXED.
Existing cached map/image service
Use an existing hosted or ArcGIS Server web tile layer or an ArcGIS Server image service as the tiling scheme of your web tile layer. When you choose this option, the tiling scheme XML file associated with the existing service is downloaded to C:\Users\USERPROFILE\My Documents\ArcGIS\TilingSchemes\Downloaded. ArcGIS Pro will honor the parameters specified in the existing service, with the exception of antialiasing. Antialiasing options set for the application are used.
Tiling scheme file
Import a custom tiling scheme XML file you have created that contains your preferred scales and settings. Use the Generate Map Server Cache Tiling Scheme geoprocessing tool to create a custom tiling scheme XML file. Additional tiling scheme files can also be imported from C:\Program Files\ArcGIS\Pro\Resources\TilingSchemes. The tile image format will default to PNG if the tile image format is not defined in the tiling scheme file. ArcGIS Pro will honor the parameters specified in the tiling scheme file, with the exception of antialiasing. Antialiasing options set for the application are used.
- If you choose to draw Using tiles from a cache, you can use the sliders to set the Levels of Detail. ArcGIS Pro examines the dependencies in your map or layer and attempts to suggest a minimum and maximum range of scales for caching. Depending on your map or layer, you may want to forego caching some of the extremely large or small scales in your tiling scheme.
- If you choose to draw Using tiles from a cache, additionally choose when and where to build the cache. The default setting is to build the cache automatically on the server. Use the reported Estimated cache size to help you make this choice.
Cache automatically on the server
If the cache is small, it is easiest to build the whole cache automatically. This is the default setting.
Cache manually on the server
If the cache is large, it is wise to build the cache manually in phases, caching the largest scales at selected areas of interest that are most likely to be visited. You can manually build the cache using the Manage Map Server Cache Tiles tool.
- If you choose to draw Using tiles from a cache, optionally click the Cache directory drop-down arrow to choose in which server cache directory to store the cache tiles.
- If you choose to draw Using tiles from a cache, optionally select the Allow clients to export cache tiles check box to allow clients to download cache tiles for offline use.
- If you select Allow clients to export cache tiles, you can specify a value to limit how many tiles can be downloaded in a single request using the Limit export to parameter.
- At the top of the Configuration tab, click Configure parameters to access service level parameters such as Maximum records returned by server and Time zone. For a full list of parameters available, see Configure service parameters.
Considerations when sharing to older portals
Although map image layers can be shared to ArcGIS Enterprise and Portal for ArcGIS 10.4 and later, not all functionality is supported when sharing to each version. Listed below are limitations when sharing to older versions.
ArcGIS Enterprise 10.5.1 and earlier and Portal for ArcGIS 10.4.1 and earlier
- The linear referencing capability is not available.
- The network analysis capability is not available.
- The version management capability is not available.
Portal for ArcGIS 10.4.1 and earlier
- Map image layers cannot be drawn using tile from a cache.