ArcObjects Library Reference (Carto)  

IMapServerGeoTransformation Interface

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

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

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.

 

Members

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

CoClasses that implement IMapServerGeoTransformation

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

Remarks

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.