

PREV CLASS NEXT CLASS  FRAMES NO FRAMES  
SUMMARY: NESTED  FIELD  CONSTR  METHOD  DETAIL: FIELD  CONSTR  METHOD 
public interface IConversionMGRS
Provides access to members that allow the use of MGRS.
IConversionMGRS contains methods for converting both projected and geographic (lat/lon) coordinates to and from a string in the Military Grid Reference System (MGRS). The MGRS is based on Universal Transverse Mercator(UTM) coordinates. A simplified version of MGRS is used in the United States National Grid (USNG). A single string can be used to represent any point on the Earth's surface with MGRS/USNG.
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 

void putCoordsFromMGRS(String mgrs, int mode) throws IOException, AutomationException
Creates the coordinates of a point from the MGRS/USNG string description. MGRS stands for military grid reference system while USNG is the United States National Grid. The Point being used must already have a defined spatial reference. The coordinate system cannot be unknown. PutCoordsFromMGRS takes two inputs. The first is the MGRS string that you want to convert. The second is the esriMGRSModeEnum and determines how to handle the geographic coordinate system of the spatial reference. Certain older geographic coordinate systems will cause one of the letters of the string to be shifted. This process makes it easier to identify coordinates that are based on a nonWGS84 datum.
esriMGRSModeEnum:
esriMGRSMode_Automatic: the geographic coordinate system is handled for you
esriMGRSMode_NewStyle: the geographic coordinate system is treated as if it is WGS84
esriMGRSMode_NewWith180InZone01: the geographic coordinate system is treated as if it is WGS84 and a point at 180E will be forced into UTM zone 1.
esriMGRSMode_OldStyle: the geographic coordinate system is treated as if it is an older nonWGS84 datum, particularly one that is based on the Clarke 1866 or Bessel spheroids.
esriMGRSMode_OldWith180InZone01: the geographic coordinate system is treated as if it is an older nonWGS84 datum, particularly one that is based on the Clarke 1866 or Bessel spheroids and a point at 180E will be forced into UTM zone 1.
esriMGRSMode_USNG: USNG does not differentiate between older and newer geographic coordinate systems.
mgrs
 The mgrs (in)mode
 A com.esri.arcgis.geometry.esriMGRSModeEnum constant (in)
IOException
 If there are interop problems.
AutomationException
 If the ArcObject component throws an exception.String createMGRS(int numDigits, boolean round, int mode) throws IOException, AutomationException
This method creates a single string description in MGRS/USNG for any Point on the Earth's surface. A string variable is needed to store this alphanumeric string. MGRS stands for military grid reference system while USNG is the United States National Grid. CreateMGRS takes three inputs.
The first is the integer number of digits you wish the string to carry and controls the precision.
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 greater 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 second is the esriMGRSModeEnum and determines how to handle the geographic coordinate system of the spatial reference. Certain older geographic coordinate systems will cause one of the letters of the string to be shifted. This process makes it easier to identify coordinates that are based on a nonWGS84 datum.
esriMGRSModeEnum:
esriMGRSMode_Automatic: the geographic coordinate system is handled for you
esriMGRSMode_NewStyle: the geographic coordinate system is treated as if it is WGS84
esriMGRSMode_NewWith180InZone01: the geographic coordinate system is treated as if it is WGS84 and a point at 180E will be forced into UTM zone 1.
esriMGRSMode_OldStyle: the geographic coordinate system is treated as if it is an older nonWGS84 datum, particularly one that is based on the Clarke 1866 or Bessel spheroids.
esriMGRSMode_OldWith180InZone01: the geographic coordinate system is treated as if it is an older nonWGS84 datum, particularly one that is based on the Clarke 1866 or Bessel spheroids and a point at 180E will be forced into UTM zone 1.
esriMGRSMode_USNG: USNG does not differentiate between older and newer geographic coordinate systems.
numDigits
 The numDigits (in)round
 The round (in)mode
 A com.esri.arcgis.geometry.esriMGRSModeEnum constant (in)
IOException
 If there are interop problems.
AutomationException
 If the ArcObject component throws an exception.


PREV CLASS NEXT CLASS  FRAMES NO FRAMES  
SUMMARY: NESTED  FIELD  CONSTR  METHOD  DETAIL: FIELD  CONSTR  METHOD 