IMapServerGeoTransformation Interface

Provides access to members that control the export set of geographic transformations.

When To Use

Use IMapServerGeoTransformation when the image output from a map service is to be displayed in a coordinate system where the underlying geographic coordinate system is different than the underlying geographic coordinate system of the DefaultMapDescription.

For example, a given map service may be using a spatial reference system based on GCS_WGS_1984. A client wants to display the map service in a different spatial reference, such as GCS_European_1950. If no GeoTransformation is applied the resulting map image will use the spatial reference of the DefaultMapDescription, GCS_WGS_1984, and will display incorrectly in GCS_European_1950. Features may not "line up" correctly. In order to correctly display these results a GeoTransformation is needed. Applying the correct GeoTransformation ensures the spatial correctness of the result.

A GeoTransformation is not needed if different projected coordinate systems share the same underlying geographic coordinate system. For best results it is optimal for data (layers within the map service), map service and MapServer output to use the same coordinate system.


Name Description
Read/write property GeoTransformation On-the-fly geographic transformations.

IMapServerGeoTransformation.GeoTransformation Property

On-the-fly geographic transformations.

Public Property GeoTransformation As IGeoTransformation
public IGeoTransformation GeoTransformation {get; set;}


GeoTransformation provides access to members that define a geographic (datum) transformation.

Dim pSRFactory As ISpatialReferenceFactory2

pSRFactory = New SpatialReferenceEnvironment

Dim pGeoTrans As IGeoTransformation

pGeoTrans = pSRFactory.CreateGeoTransformation(esriSRGeoTransformation3Type.esriSRGeoTransformation_NAD_1927_To_WGS_1984_30)

pQueryResultOptions.GeoTransformation = pGeoTrans

Classes that implement IMapServerGeoTransformation

Classes Description
MapDescription The Map Description coclass contains settings of a map in the current document.


All the elements in a map layer have a specific geographic location and extent that enables them to be located on or near the earth's surface. The ability to accurately describe geographic locations is critical in both mapping and GIS.

Coordinate systems, sometimes known as map projections, provide a common basis for communication about a particular place or area on the earth's surface. There are two types of coordinate systems�geographic and projected.

A geographic coordinate system uses a three-dimensional spherical surface to define locations on the earth. It includes an angular unit of measure, a prime meridian, and a datum (based on a spheroid). In a geographic coordinate system a point is referenced by its longitude and latitude values.

A projected coordinate system is defined on a flat, two-dimensional surface. Unlike a geographic coordinate system, a projected coordinate system has constant lengths, angles, and areas across the two dimensions. A projected coordinate system is always based on a geographic coordinate system that is based on a sphere or spheroid.

Coordinate systems enable you to integrate datasets within maps as well as to perform various integrated analytical operations such as overlaying data layers from disparate sources and coordinate systems.

IMapServerGeoTransformation provides access to methods that help ensure the proper geographic alignment of MapServer image output.

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.