com.esri.arcgis.carto
Interface IMapServerGeoTransformation

All Superinterfaces:
Serializable
All Known Implementing Classes:
MapDescription

public interface IMapServerGeoTransformation
extends Serializable

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

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.

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.

Product Availability

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


Method Summary
 IGeoTransformation getGeoTransformation()
          On-the-fly geographic transformations.
 void setGeoTransformationByRef(IGeoTransformation transformations)
          On-the-fly geographic transformations.
 

Method Detail

setGeoTransformationByRef

void setGeoTransformationByRef(IGeoTransformation transformations)
                               throws IOException,
                                      AutomationException
On-the-fly geographic transformations.

Product Availability

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

Parameters:
transformations - A reference to a com.esri.arcgis.geometry.IGeoTransformation (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getGeoTransformation

IGeoTransformation getGeoTransformation()
                                        throws IOException,
                                               AutomationException
On-the-fly geographic transformations.

Remarks

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

Product Availability

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

Returns:
A reference to a com.esri.arcgis.geometry.IGeoTransformation
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.