Map image layers support map visualization and vector querying. They can be drawn dynamically by the server or using tiles from a cache. Map image layers are appropriate for visualizing data on top of basemaps.
If your active portal is Portal for ArcGIS 10.4 or later, you can author and share map image layers that are stored as items in your active portal. When sharing a map image layer, you have the option to reference enterprise data and can include additional layer types such as WMS. If your organization has multiple federated servers, you can choose where to share the 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 ArcMap 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
- 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 and click Share As Web Layer.
The Share 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 within My Content by typing the folder name or click to browse to an existing 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 show 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 from the Portal for ArcGIS website.
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, select additional layer types. Currently, WMS is supported but cannot be configured during the sharing process. For more information on modifying WMS properties see: Accessing WMS service properties in Manager.
- 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 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 from the Portal for ArcGIS website.
- 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.