Hosted imagery layer settings

You can alter certain settings on a hosted imagery layer. The following sections describe how the layer owner, or an administrator, can manage the settings for a hosted imagery layer and the data it contains.

Manage the item page

As the owner of a hosted imagery layer, or an administrator, you can change the name, thumbnail, summary, description, terms of use, sharing settings, folder, tags, and credits of hosted imagery layer items. An administrator can change the owner of a hosted imagery layer.

Note:

On the tabs in the Content page, additional information about the imagery layers can be viewed with the type attributes. For imagery layers, you can see the following attributes within parentheses:

  • hosted—Indicates that the imagery layer is hosted in ArcGIS Online.
  • collection—Indicates that it is a dynamic imagery layer with an image collection.
  • multidimensional—Indicates that the imagery layer is multidimensional and can be configured with the multidimensional settings in Map Viewer.

These imagery type attributes allow you to locate imagery layers within your organization quickly.

  1. Sign in to your organization and open the item page for the hosted imagery layer.
  2. On the Overview tab, click the Edit button next to the property you want to change.
  3. Change the property and click Save.

Note:

You cannot share dynamic imagery layer items with the public. Even if you have privileges to share data publicly, the option to share dynamic imagery layers using the Everyone (public) option is not available.

Manage general settings

As the owner of a hosted imagery layer, or an administrator, you can modify the content status, delete protection setting, and extent of the layer.

  1. Sign in to your organization and open the item page for the hosted imagery layer.
  2. On the Settings tab, select Mark as Deprecated if necessary to discourage the use of this item.
  3. Optionally, check the box to prevent the item from being accidentally deleted.
  4. To set an extent to make the layer searchable by location, click Edit Extent.
  5. When finished, click Save.

Manage dynamic imagery layer settings

Hosted dynamic imagery layers have additional settings such as default resampling, compression, mosaic methods, and mensuration that can be modified by an administrator or owner of the dynamic imagery layer.

Caution:

These settings are only available with dynamic imagery layers with the Image Collection layer configuration.

Modify image request options

You can modify the limitations on the size of the imagery that is queried or displayed when rendering an imagery layer. For example, increase the size of the request to display a larger area of imagery. Follow these steps to modify the portions of the imagery layer that can be queried and displayed in the map:

  1. Sign in to your organization and open the item page for the hosted dynamic imagery layer.
  2. Click the Settings tab.
  3. Scroll to the Imagery Layer (hosted) section.
  4. Optionally, modify one of the following settings:
    Tip:

    These settings control the visualization and the ability to use the imagery layer in raster analysis. The settings here control how much can be processed in the raster analysis tool or function. For example, if the processing extent of the raster analysis tool exceeds the maximum rows and columns, the tool will fail. These settings can improve the performance of the imagery layer, so consider the performance when modifying.

    • Maximum columns per request—The maximum number of columns that the server allows in a client request. If the client’s request exceeds this value, none of the pixels will be returned.
      Note:

      The request size limit for the ArcGIS Online dynamic image service is set to 4,000 x 4,000 pixels or smaller. You can adjust the size of the Maximum columns per request value, but this parameter setting will revert to 4,000 pixels if you specified more than 4,000 columns.

    • Maximum rows per request—The maximum number of rows that the server allows in a client request. If the client’s request exceeds this value, none of the pixels will be returned.
      Note:

      The request size limit for the ArcGIS Online dynamic image service is set to 4,000 x 4,000 pixels or smaller. You can adjust the size of the Maximum columns per rows value, but this parameter will revert to 4,000 pixels if you specified more than 4,000 rows.

    • Maximum samples count—This generates sample point locations, pixel values, and corresponding spatial resolutions of the source data for a specified geometry. By default, the maximum number of sample locations is 1,000.
  5. When finished, click Save.

Set the default resampling method

The default resampling method determines how pixels are displayed when the imagery layer is added to a map. For example, you can change the resampling method from Bilinear Interpolation to Nearest Neighbor if most of the imagery in the collection is categorical. Follow these steps to change the default resampling method for imagery display:

  1. Sign in to your organization and open the item page for the hosted dynamic imagery layer.
  2. Click the Settings tab.
  3. Scroll to the Imagery Layer (hosted) section and select one of the following options for the Default resampling method setting:
    • Nearest Neighbor—Recommended for discrete data
    • Bilinear Interpolation—Recommended for continuous data
    • Cubic Convolution—Recommended for continuous data
    • Majority—Recommended for discrete data
  4. When finished, click Save.

Choose the compression options

Compressing raster data improves performance over a network. Follow these steps to specify the allowed compression types:

  1. Sign in to your organization and open the item page for the hosted dynamic imagery layer.
  2. Click the Settings tab.
  3. Scroll to the Imagery Layer (hosted) section and check the check boxes to allow one or more of the following options for the Allowed compressions setting:
    • None—No compression will occur.
    • JPEG—Lossy compression that uses the public JPEG compression algorithm. If you choose JPEG, you can also specify the Default JPEG compression quality setting. The valid compression quality value range is from 0 to 100, with 75 being the default. This compression can be used for JPEG and TIFF formats and geodatabases.
    • LZ77—Lossless compression that preserves all raster cell values.
    • LERC—Lossless or lossy compression that divides the raster into a number of pixel blocks—in which each pixel can be quantized and bit stuffed—based on a number of block statistics, including the maximum error allowed.
  4. When finished, click Save.

Change the raster function template

Dynamic imagery layers can be rendered using raster function templates, which process pixel values on the fly to generate a display showing the results.

Raster function templates can provide different preset visualization options for the user to choose when using the imagery layer. For example, if a raster function template is added to display the imagery layer in a different band combination such as a false color composite, the user can switch between the processing templates without having to change the band combination manually.

To allow raster functions and specify the raster function templates that can be used for rendering, follow the steps below:

  1. Sign in to your organization and open the item page for the hosted dynamic imagery layer.
  2. Click the Settings tab.
  3. Scroll to the Imagery Layer (hosted) section and check the Allow function check box to allow users to access the raster function templates associated with the layer.
  4. Click the Choose Raster Function Template button to launch the raster function template browser.
  5. Browse to the raster function template to add as rendering options for the dynamic imagery layer, and click the Select button.

    If you choose more than one raster function template, you can set one as the default template.

  6. When finished, click Save.

Specify mosaic options

If the imagery layer was generated from a mosaic dataset or a collection of images, you can modify the mosaic or catalog properties of the imagery layer. These parameters control or limit the access users have to metadata and the catalog fields, as well as limit the requests for records from the mosaic dataset tables. These parameters can affect the load on the server. The more you allow a user to view and query, the greater the draw on the server.

To modify the mosaic or catalog properties of the dynamic imagery layer, complete the following steps:

  1. Sign in to your organization and open the item page for the hosted dynamic imagery layer.
  2. Click the Settings tab.
  3. Scroll to the Imagery Layer (hosted) section and check the Catalog check box.
  4. Optionally, modify one or more of the following settings:

    Maximum number of rasters per mosaic

    The maximum number of rasters that can be mosaicked per request. This prevents the server from opening and performing processing on large numbers of rasters for a single request.

    If the client's request requires more than this number of rasters to be accessed, only this number of rasters are accessed. None of the pixels for the additional rasters are returned, potentially causing gaps in the resulting image. It is recommended that overviews be built so that the client does not end up with gaps in the display.

    Maximum number of records returned per request

    The maximum limit of the number of records transmitted per transaction. If a user’s request exceeds this value, the image returned uses the maximum allowed rasters.

    Allowed fields

    The fields in the attribute table that are transmitted to the client. Uncheck the fields that you don't want a client to view or use in a query.

    Allowed mosaic methods

    The allowable mosaic methods for the image service. The possible mosaic methods are as follows:

    • Closest To Center
    • North-West
    • Lock Raster
    • By Attribute
    • Closest To Nadir
    • Closest To Viewpoint
    • Seamline
    • None

    If you choose By Attribute, you can specify the Mosaic method sort field setting and the base Sort value setting.

  5. When finished, click Save.

Allow mensuration types

To allow image mensuration on the imagery layer, including tools to measure point, distance, area, and feature height from an image, complete the following steps:

  1. Sign in to your organization and open the item page for the hosted dynamic imagery layer.
  2. Click the Settings tab.
  3. Scroll to the Imagery Layer (hosted) section and check the Mensuration check box to allow users to perform measurements in the imagery layer.
  4. Check the check boxes to allow one or more of the following mensuration options:
    • None—No mensuration can be performed.
    • Basic—The basic mensuration operations can be performed: point, distance, area, and centroid.
    • Base-Top Height—Height measurement can be performed from the base of an object to the top of the object. Measurements are assumed to be perpendicular to the base; the line being measured along the building must have its endpoint directly above the start point. Measurements will not be as accurate for objects that taper or lean from the base.
    • Base-Top Shadow Height—Height measurement can be performed from the base of the object to the top of the object's shadow on the ground. The point in the shadow must represent a point on the visible object that is perpendicular to the base.
    • Top-Top Shadow Height—Height measurement can be performed from the top of the object to the top of the objects's shadow on the ground. The measurement points on the object and its shadow must represent the same point. This tool is useful for obtaining the height of an object on the top of a structure, for example, if there is a smaller room than the dimensions of the building or a tower on the top. You can identify the top point of this feature in the image and identify the same point in the shadow.
    • 3D—The 3D mensuration operations can be performed: 3D point, 3D distance, 3D area, 3D centroid, and volume.
  5. When finished, click Save.