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 the server to which the service is published. 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.
Share a map image layer using the default configuration
- To share a map image layer, do one of the following:
- Share the map and all 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 menu, and click Share As Web Layer .
The Share As Web Layer pane appears.
- Provide a name for the web layer.
- Complete the Summary and Tags fields.
- Optionally check the Reference registered data check box to reference registered data sources. Selecting Reference registered data enables the option to select the layer type Feature; doing so will include a dependent feature layer.
- For Layer Type, click Map Image.
- Use the Folder menu to specify where the web layer will be stored in your portal content. The web layer is stored in the root of your content by default. Optionally click the browse button to create a folder or choose an existing one. You can also type the name of the desired folder in the text box.
- Use the Server and Folder menu to specify the federated server where the service will be published and the folder on the server where it will be stored. If the folder does not already exist, type the name of the desired folder in the text box. The service is stored in the root folder by default.
- Specify how the web layer will be shared:
- 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.
- 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.
- 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 chose the Using tiles from a cache option when you configured your map image layer, 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 checking 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 sublayers.
- 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 precached images generated at scale levels you define. See Common caching questions for more information.
If a cache with the same name as the new web layer already exists on the target server, the new web layer defaults to Using tiles from a cache, and the existing cache is used. If a cache with the same name as the new web layer does not exist, the web layer, by default, uses Dynamically from the data to draw.
- If an existing cache does not exist, 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 23. When you initialize a new cache, ArcGIS Pro examines the layers in your GIS resource and establishes a default tile image format. 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 22. When you initialize a new cache, ArcGIS Pro examines the layers in your map and establishes a default tile image format. 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 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.
- Use the sliders to set the Levels of Detail option. ArcGIS Pro examines the dependencies in your map or layer and indicates 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.
- 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, you can build the whole cache automatically. This is the default setting.
Cache manually on the server
If the cache is large, it is recommended that you 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.
- Click the Cache directory drop-down arrow to choose the server cache directory where the cache tiles will be stored.
- Check the Allow clients to export cache tiles check box to allow clients to download cache tiles for offline use.
- Specify a value to limit the number of tiles that 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.6.1 and earlier
- The WFS layer is not available.
- The WCS, KML, and validation capabilities are not available.
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.