com.esri.arcgis.geometry
Interface IConversionMGRS

All Superinterfaces:
Serializable
All Known Implementing Classes:
Point

public interface IConversionMGRS
extends Serializable

Provides access to members that allow the use of MGRS.

Description

IConversionMGRS contains methods for converting both Projected Coordinates and Geographic (Lat/Long) Coordinates to and from a string in the Military Grid Reference System (MGRS). The MGRS is based on Universal Transverse Mercator(UTM) projection coordinates. This system is also know as the United States National Grid (USNG) in the United States. A single string can be used to represent any point on the Earth's surface with MGRS/USNG.

Product Availability

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


Method Summary
 String createMGRS(int numDigits, boolean round, int mode)
          Returns the MGRS/USNG description of a point.
 void putCoordsFromMGRS(String mgrs, int mode)
          Creates the coordinates of a point from the MGRS/USNG description.
 

Method Detail

putCoordsFromMGRS

void putCoordsFromMGRS(String mgrs,
                       int mode)
                       throws IOException,
                              AutomationException
Creates the coordinates of a point from the MGRS/USNG description.

Description

Creates the coordinates of a point from the MGRS/USNG string description. The Point being used must already have a defined Spatial Reference. PutCoordsFromMGRS takes two inputs. The first is the MGRS string that you want to convert. The second is the esriMGRSModeEnum and determines which spheroid is used in the conversion since with different spheriods one of the alphabetic values is changed.

esriMGRSModeEnum:

esriMGRSMode_Automatic: the spheroid is choosen for you

esriMGRSMode_NewStyle: the spheroid is treated the as WGS84

esriMGRSMode_NewWith180InZone01:

esriMGRSMode_OldStyle: the spheroid is treated the as Clarke 1866 or Bessel

esriMGRSMode_OldWith180InZone01:

esriMGRSMode_USNG:

Product Availability

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

Parameters:
mgrs - The mgrs (in)
mode - A com.esri.arcgis.geometry.esriMGRSModeEnum constant (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

createMGRS

String createMGRS(int numDigits,
                  boolean round,
                  int mode)
                  throws IOException,
                         AutomationException
Returns the MGRS/USNG description of a point.

Description

This method creates a single string description ini MGRS/USNG for any Point on the Earth's surface. A string variable is needed for storing of this description. CreateMGRS takes three inputs.

The first is the integer number of digits you wish the string to carry.

0: To approximately 100 Kilometers depending on where on earth the point is.

5: To a square meter (This is the standard for MGRS/USNG).

8: To a square millimeter. This is the best precision possible and using a larger number will not result in great precision.

The second input parameter is a boolean that represents rounding.

True: The values of the UTM coordinates will be rounded.

False: The values of the UTM coordinates will be truncated.

The third input is the esriMGRSModeEnum and determines which spheroid is used in the conversion because with different spheriods one of the alphabetic values is changed.

esriMGRSModeEnum:

esriMGRSMode_Automatic: The spheroid from the data's geographic coordinate system is used.

esriMGRSMode_NewStyle: The spheroid is treated the same as WGS84 would be.

esriMGRSMode_NewWith180InZone01: Same as NewStyle but a point at +180 is assumed to be in UTM zone 1, rather than UTM zone 60.

esriMGRSMode_OldStyle: The spheroid is treated the same as Clarke 1866 or Bessel would be.

esriMGRSMode_OldWith180InZone01: Same as OldStyle but a point at +180 is assumed to be in UTM zone 1, rather than UTM zone 60.

esriMGRSMode_USNG: The spheroid is treated the same as WGS84 or GRS80.

Product Availability

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

Parameters:
numDigits - The numDigits (in)
round - The round (in)
mode - A com.esri.arcgis.geometry.esriMGRSModeEnum constant (in)
Returns:
The mgrs
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.