FRAMES | NO FRAMES Description | Parameters | Examples | Response
KML Image (for Image Services)
URL http://<imageservice-url>/kml/image.kmz
Parent Resource Image Service
Required Capability Image


The KML Image resource represents a ground overlay document wrapped in a KMZ file. When using an Image Service, KML Regions are not supported.

For more information about kml as an output option, see KML support.

Resource Hierarchy

Map Tile


Parameter Details
size Description: The size (width * height) of the exported image in pixels. If the size is not specified, an image with a default size of 400 * 400 will be exported.

Syntax: <width>, <height>

format Description: The format of the exported image. The default format is png.

Values: png | png8 | png24 | jpg | bmp | gif
pixelType The pixel type, also known as data type, pertains to the type of values stored in the raster, such as signed integer, unsigned integer, or floating point. Integers are whole numbers, whereas floating points have decimals.

Values: C128 | C64 | F32 | F64 | S16 | S32 | S8 | U1 | U16 | U2 | U32 | U4 | U8 | UNKNOWN
noData The pixel value representing no information.

interpolation The resampling process of extrapolating the pixel values while transforming the raster dataset when it undergoes warping or when it changes coordinate space.

Values: RSP_BilinearInterpolation | RSP_CubicConvolution | RSP_Majority | RSP_NearestNeighbor
compressionQuality Controls how much loss the image will be subjected to by the compression algorithm. Valid value ranges of compression quality are from 0 to 100.

bandIds If there are multiple bands, you can specify a single band to export, or you can change the band combination (red, green, blue) by specifying the band number.

mosaicProperties Controls what mosaic operation will be used to create the displayed raster from an image service. MosaicProperties is an XML formatted string.



<MosaicMethod>ByAttribute</MosaicMethod> <TileOrderField>Month</TileOrderField> <TileOrderBase>6</TileOrderBase>

viewpointProperties The view point properties determine the desired viewing angle of a theoretical observer and subsequently the ordering of rasters in a given data frame extent. ViewpointProperties is an XML formatted string.


<ViewPointDefShiftX>0</ViewPointDefShiftX> <ViewPointDefShiftY>0</ViewPointDefShiftY> <ViewPointX>4489898.428</ViewPointX> <ViewPointY>5478905.02941413</ViewPointY>

Example Usage

Example 1: Request a KML ground overlay document for an image service.


KML Response Example

Below is a typical response KML document wrapped in an example KMZ response:

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="">