Skip To Content

Map image layer

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.

Share a map image layer

  1. 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 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 Publish Web Layer.

    The Share As Web Layer pane appears.

  2. Provide a name for the web layer.
  3. Complete the Summary and Tags fields.
  4. 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.
  5. For Layer Type, click Map Image.
  6. Use the Folder drop-down menu to specify where the web layer will be stored in your portal content. Optionally click the browse button Browse to create a folder or choose an existing one. You can also type the name of the desired folder in the text box.
  7. Use the Server and Folder drop-down menu to specify the federated server where the service will be published and the folder on the server where the service will be stored. If the folder does not already exist, type the name of the desired folder in the text box.
  8. 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.
  9. Optionally, click the Content tab to view the new web layer or layers and associated components.
  10. 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
  11. Once validated, click Publish to share your web layer using the default configuration.
  12. Once the web layer has been successfully published, click the Manage the web layer link to manage the web layer.
Note:

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.

  1. Click the Configuration tab.
  2. 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
    • WMS
  3. Click Configure Web Layer Properties Configure web layer properties to the right of Map Image to access the configurable properties.
  4. By default, Map, Data, and Query are enabled:

    Map

    By default, map is turned on and disabled. This capability allows the Export Map, Generate Renderer, and Generate KML methods to be used.

    Data

    By default, data is turned on. This capability allows the Find, Query, and Query Related Records methods to be used.

    Query

    By default, query is turned on. This capability allows the Identify method to be used.

  5. 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.
  6. 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 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.

  7. The following steps only apply if drawn Using tiles from a cache. If drawn Dynamically from the data, the remaining steps do not apply.
  8. If 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 23. 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 22. 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.

  9. 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.
  10. 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.

  11. Click the Cache directory drop-down arrow to choose in which server cache directory to store the cache tiles.
  12. Select the Allow clients to export cache tiles check box to allow clients to download cache tiles for offline use.
    1. Specify a value to limit how many tiles can be downloaded in a single request using the Limit export to parameter.
  13. At the top of the Configuration tab, click Configure parameters 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.