Skip To Content

Image service parameters

There are many standard parameters for an image service whose defaults are sufficient for most ArcGIS Server services. These include the pooling options and several others. However, due to the nature of raster and image data, there are some parameters that can affect the speed of an image service, data that can be downloaded, querying, and many other options.

Some parameters are necessary when specific capabilities have been enabled. For example, if the Download capability is enabled, the download parameters should be modified. This also applies to the Catalog, Editing, and Mensuration capabilities.

Parameters to control the image data

The image service parameters are divided into several sections; each section is dependent on the input for the image service. Most of these parameters are specific to image services serving mosaic datasets and only a few affect an image service created from raster datasets or layers. Many mosaic dataset-related parameters are set when you create the mosaic dataset. Although some can be altered by server administrators, they cannot to exceed the maximums you have set in the mosaic dataset properties. For example, if you limit the allowed mosaic methods to only three of the methods, the administrator cannot add a fourth method. Or, if you set the maximum number of downloadable items, the administrator can reduce the number but not increase this number.

If you change the parameters of the mosaic dataset to exceed or limit a value, such as the maximum size of requests, you need to republish it as an image service for the server to read the modified values. If you only stop and start the image service, the changed properties in the mosaic dataset will not be included, whereas if you change the properties of the image service, you only need to stop and start the image service for the changes to take effect.

General

These display the name and location of the image service. This is applicable to all inputs.

Parameters

The following image parameters affect the image that users see:

ParameterDescription

Allow Copy

Allow Download Raster geoprocessing service tool to access the image service.

Allow Analysis

Allow geoprocessing service tools inside the Raster Analysis toolbox to access the image service.

Maximum image size per request

The maximum number of pixel rows and columns that the server allows in a client request.

If the client’s request exceeds this value, none of the pixels will be returned.

Applicable to all inputs.

Default resampling method

The resampling method used in the request. The methods include the following:

  • Nearest Neighbor (recommended for discrete data)
  • Bilinear Interpolation (recommended for continuous data)
  • Cubic Convolution (recommended for continuous data)
  • Majority (recommended for discrete data)

Applicable to all inputs.

Allowed compression methods

The allowable compression methods for the image service. There are three possible compression types available:

  • NONE
  • JPEG
  • LERC
  • LZ77

A default JPEG Quality and LERC Tolerance can be set on the Configure Allow List dialog box.

The client can then choose which allowable compression method to use for transmission. This can be set on the Display tab on the Layer Properties dialog box.

This parameter is applicable only to clients that access image services via the SOAP GetImage method, for example, ArcGIS Desktop and applications built with ArcObjects.

For clients accessing services via REST, compression is applied automatically based on the requested format type, regardless of the defined compression methods.

Return JPGPNG as JPG

When a user requests the image using the JPGPNG format, if there is transparency, a PNG is returned; otherwise, a JPG is returned. The PNG is often much larger than the JPG and thus can take longer to transmit. If transparency is not necessary and you want to be sure the image service is always transmitted using a smaller image size, check this box.

Applicable to all inputs.

Has live data

When new rasters are added to the mosaic dataset of an image service, the image service information such as source resolution, spatial extent, multidimensional information, and time extent may become outdated. You can restart the service to reflect data changes. However, if you cannot incur any down time, select this option to reflect data changes without restarting the service.

This property is only exposed in ArcGIS Server Manager and the ArcGIS REST API.

Alternatively, run the Refresh Service command to refresh an ArcGIS image service to reflect back-end data changes.

Maximum samples count

This generates sample point locations, pixel values, and corresponding spatial resolutions of the source data for a given geometry. By default, the maximum number of sample locations is 1,000.

Cache control max age

When clients send requests to an ArcGIS Image Server to display an image service, the response from the server is typically cached by the browser and reused for a certain period of time. This behavior helps ArcGIS Image Server achieve the best possible display performance for your image service. However, depending on how your image service and its associated data are used in applications, you may consider adjusting the length of time the browser will use a response in its cache.

ArcGIS Image Server image service responses include an entity tag (ETag) and a Cache-Control header. The ETag header value is a unique identifier of the response. The Cache-Control header has a max-age value that provides information to the browser regarding the maximum time period for which it can reuse a response from the browser's cache. This is controlled by this property.

When a request is repeated and the maximum age of the cache has not expired, the browser uses the cached response without sending the request to the server. If the maximum age has expired, the browser must send the request to the server and set an IF-NONE-MATCH header with an associated ETag value corresponding to the response in its cache. ArcGIS Image Server evaluates the request and uses the ETag value to determine if the response has changed. If the response from the server is different from the copy on the browser, the server sends a completely new response to the browser. If the response is identical to the copy on the browser, the server alerts the browser to continue to use the response in its cache.

As an ArcGIS Server administrator, you can define this property to specify how long a browser is allowed to use a cached response. By mitigating the need for ArcGIS Image Server to send a full response, you allow your browser caches to be more efficient, help optimize your applications, and save network bandwidth.

The default value for image services is 12 hours (43,200 seconds). This means that if a request is repeated within 12 hours, the browser uses the response from its cache. This value works well for most applications.

For image services with frequently changing datasets or symbology, a value such as 5 minutes (300 seconds) is recommended. In applications with animations or time-aware data, consider increasing the value to give your application a smoother animation experience.

This property is only exposed in ArcGIS Server Manager and the ArcGIS REST API.

Directory

You can choose the output directory where you want the server to create temporary files. If you don't specify the output directory, the ArcGIS Image Server only returns images as MIME data. By specifying an output directory, the returned images are also accessible via a URL address.

sliceId

Added at 10.9. The slice ID of the multidimensional raster. This parameter is available if the image service uses ArcObjects11 or ArcObjectsRasterRendering as the service provider.

Syntax

sliceId=<slice ID>

Example

sliceId=1

time

Added at 10.9. The time instant or time extent of the raster to be sampled. This parameter is only valid if the image service supports time.

Syntax


//Time instant
time=<timeInstant>

//Time extent (for time extens where <startTime> or <endtime>, but not both, are null)
time=<startTime>, <endTime>
Note:

A null value specified for start time or end time represents infinity for start or end time, respectively.

Example


//Time instant (1 Jan 2008 00:00:00 GMT)
time=1199145600000

//Time extent (1 Jan 2008 00:00:00 GMT to 1 Jan 2009 00:00:00 GMT)
time=1199145600000, 1230768000000

Parameters to control the image service catalog

The Catalog parameters only apply when publishing a mosaic dataset as an image service. 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.

Mosaicking parameters

ParameterDescription

Maximum number of rasters per mosaic

The maximum number of rasters that can be mosaicked per request. This prevents the server from needing to open and perform 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.

Applicable to a mosaic dataset only.

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

Applicable to a mosaic dataset only.

Catalog parameters

These parameters only apply when the Catalog capability is checked.

ParameterDescription

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.

Applicable to the mosaic dataset only.

Raster metadata level

The metadata that will be transmitted to the client. The options are as follows:

  • Basic—Metadata of the raster
  • Full—Metadata of the raster and the raster functions that are applied to the raster
  • None—No metadata

Applicable to the mosaic dataset only.

Allowed fields

A list of 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.

Applicable to the mosaic dataset only.

Reference image

The reference raster dataset, mosaic dataset, or raster layer used to georeference the source raster dataset. For additional information, see Compute Tie Points in the ArcGIS REST API.

Download parameters

When allowing downloads on an image service, be sure to check the Download capability on the Imaging property page. Also, in addition to the properties below, be sure to configure the output directories on the Parameters properties page.

These parameters affect the load on the server and the access users have to the source images.

ParameterDescription

Maximum number of items downloadable per request

The maximum number of rasters that a user can download at one time.

Applicable to a mosaic dataset only.

Maximum download size per request

The total number of megabytes (MB) that can be downloaded at one time.

Applicable to a mosaic dataset only.

Allow downloading metadata files

Allows clients to download metadata files associated with the images.

This property is only exposed in ArcGIS Server Manager and the ArcGIS REST API.

Manage downloaded directories

Allows you to map the physical directories where the images are located to a virtual directory where the image URLs will be mapped.

When allowing download, it is critical that the service uses a directory that points to the source rasters of the mosaic dataset. This prevents a huge performance bottleneck that would otherwise occur as the service copies files from the mosaic dataset source directory to the server output directory.

The virtual directory provides web applications' access to files created by the ArcGIS Image Server via a URL address. The virtual directory should point to the same disk location as the output directory. You must create the virtual directory in your web server and link it to the physical directory on disk. Refer to your web server documentation on how to create virtual directories.

Applicable to a mosaic dataset only.

Parameters to control image service content

Editing parameters

If an image service is created from a mosaic dataset, you can configure the image service to act as a repository for your clients by allowing clients to add their raster data to the mosaic dataset. Once added, the same clients can edit the properties of the data they added or remove it.

These parameters apply when the Editing capability is checked. Editing cannot be used when serving a referenced mosaic dataset.

ParameterDescription

Manage dynamic image workspaces

The directory location, accessible from the server and the mosaic dataset, where the raster data is uploaded and stored. This must be set; otherwise, the editing operations cannot be used by the service.

Applicable to a mosaic dataset only.

Manage service workspaces

A folder that contains raster data that can be added to the image service mosaic dataset. Rasters can be added from many sources, including a file, folder, raster catalog, table, or web service.

Editor Info

Choose to add a realm to the user name when applying edits so they can be tracked. When you access a secured image service, ArcGIS Server remembers the user's name and their edits. ArcGIS Server also appends any realm that has been configured on the image service.

Applicable to the mosaic dataset only (with editor tracking enabled on the mosaic dataset).

Operations allowed on items added by other users

  • Update—Allows clients to update the properties of the raster dataset they added to the image service.
  • Delete—Allows clients to remove a raster item from an image service.

Applicable to a mosaic dataset only (with editor tracking enabled on the mosaic dataset).

Allowed types for add

Choose one or more raster types from which clients can pick when adding raster data to an image service.

Applicable to a mosaic dataset only.

Manage custom types

If you need clients to add data not defined by the basic raster types, you can select one or more raster-type files (.art).

Raster-type files can be created and edited in the Add Rasters To Mosaic Dataset tool by opening the raster type's properties and saving the file.

Applicable to a mosaic dataset only.

Parameters to control on-the-fly processing

Function parameters

Functions allow the image service data to be processed by the server to provide specific products to the client. Some functions are exposed directly, such as Hillshade and Slope; however, all the functions that can be applied to the raster data in ArcGIS Desktop can be exposed to clients using raster function templates. The following parameters control the on-the-fly, server-side processing using functions that will be exposed to clients:

ParameterDescription

Allow client specified rendering rules

If checked, clients can access and control the server-side rendering and processing. If unchecked, clients cannot access and request any server-side rendering.

Applicable to all inputs.

Convert Colormap to RGB

If your raster dataset has a colormap, you can choose to publish it as an RGB image, thereby applying the colormap to the image. This impacts the pixel values since the values will be changed from a single value and associated colormap to a three-band pixel value. To retain the colormap and allow a user to query the pixel based on its colormap, don't select this option.

This applies to raster datasets with a colormap or when using a raster dataset layer or mosaic dataset using the Colormap function.

Applicable to all inputs.

Manage raster function templates

You can provide one or more function chains that can be used to process the data in the image service. When provided, these functions are applied on the server and the result is transmitted to the user or application.

These function chains are created in the Raster Function Template Editor and saved as .rft.xml files, created in ArcGIS Desktop, that can be applied to the image service.

These are provided to allow web applications to perform various on-the-fly processing on the data in the image service.

You can choose a default function chain that is applied whenever the image service is used. This is especially useful when using an image service with data that looks better when it is stretched. ArcGIS Desktop applies a stretch, but web applications typically cannot; therefore, you can be sure it will always look best if you define the stretch using a function chain.

Learn more about server-side processing

Applicable to all inputs.

Parameters to control image mensuration

Mensuration parameters

ArcGIS provides a set of tools for image mensuration, including tools to measure point, distance, area, and height from an image. You can choose whether you want the image service to participate in the ArcGIS image mensuration.

These are applicable to all inputs.

ParameterDescription

Allowed mensuration methods

These allowed methods are derived from the source's mensuration capabilities and listed as part of the dataset's properties. They determine the mensuration tools that can be used with the image service.

  • BasicThe Distance, Area, Point Location, and Centroid Location mensuration tools can be used. These tools will be available with all the other options, except None.
  • 3D—The measurements made using the tools available with the Basic option can be modified using a DEM.
  • Height—The sensor model exists for datasets within the mosaic dataset; therefore, the Height: Using Base To Top mensuration tool can be used.
  • Shadow—The sensor model and sun angle information exists for datasets within the mosaic dataset; therefore, the Height: Using Base To Top, Height: Using Base To Top Shadow, and Height: Using Top To Top Shadow mensuration tools can be used.
  • None—The user will not be able to use the mensuration tools in ArcGIS with this dataset.

Applicable to all inputs.

Elevation source

If there is a preferred and available elevation source that should be used when mensurating, you can point to it here. This allows a user to make measurements in 3D.

Valid elevation sources include raster datasets, image service SOAP URLs, and image service layers. If the elevation image service requires authentication, use an image service layer.

Applicable to all inputs.