10.2.5: AGSPoint(CoordinateConversion) Category Reference
10.2.5
 All Classes Files Functions Variables Typedefs Enumerations Enumerator Properties Macros Pages
AGSPoint(CoordinateConversion) Category Reference

Description

This category contains methods to convert AGSPoint objects into a variety of string representations and vice-versa.

Defined in:
AGSPoint+CoordinateConversion.h ( ArcGIS library)

Since
10.2

Instance Methods

(NSString *) - decimalDegreesStringWithNumDigits:
 
(NSString *) - degreesDecimalMinutesStringWithNumDigits:
 
(NSString *) - degreesMinutesSecondsStringWithNumDigits:
 
(NSString *) - GARSString
 
(NSString *) - GEOREFStringWithNumDigits:rounding:
 
(NSString *) - MGRSStringWithNumDigits:rounding:addSpaces:
 
(NSString *) - USNGStringWithNumDigits:rounding:addSpaces:
 
(NSString *) - UTMStringWithConversionMode:addSpaces:
 

Class Methods

(AGSPoint *) + pointFromDecimalDegreesString:withSpatialReference:
 
(AGSPoint *) + pointFromDegreesDecimalMinutesString:withSpatialReference:
 
(AGSPoint *) + pointFromDegreesMinutesSecondsString:withSpatialReference:
 
(AGSPoint *) + pointFromGARSString:withSpatialReference:conversionMode:
 
(AGSPoint *) + pointFromGEOREFString:withSpatialReference:
 
(AGSPoint *) + pointFromMGRSString:withSpatialReference:
 
(AGSPoint *) + pointFromUSNGString:withSpatialReference:
 
(AGSPoint *) + pointFromUTMString:withSpatialReference:conversionMode:
 

Method Documentation

- (NSString*) decimalDegreesStringWithNumDigits: (NSInteger)  numDigits

Returns a string with Decimal Degrees (DD) format for the current point.

Parameters
numDigitsThe number of digits to be included in the output string
Returns
The DD string
Since
10.2

Extends class AGSPoint.

- (NSString*) degreesDecimalMinutesStringWithNumDigits: (NSInteger)  numDigits

Returns a string with degrees decimal minute (DDM) format for the current point.

Parameters
numDigitsThe number of digits to be included in the output string
Returns
The DDM string
Since
10.2

Extends class AGSPoint.

- (NSString*) degreesMinutesSecondsStringWithNumDigits: (NSInteger)  numDigits

Returns a string with degrees minutes seconds (DMS) for the current point.

Parameters
numDigitsThe number of digits to be included in the output string
Returns
The DMS string
Since
10.2

Extends class AGSPoint.

- (NSString*) GARSString

Returns a string with Global Area Reference System (GARS) format for the current point.

Returns
The GARS string
Since
10.2

Extends class AGSPoint.

- (NSString*) GEOREFStringWithNumDigits: (NSInteger)  numDigits
rounding: (BOOL)  rounding 

Returns a string with World Geographic Reference system (GEOREF) format for the current point.

Parameters
numDigitsThe number of digits to be included in the output string
roundingWhether the numeric value should be rounded
Returns
The GEOREF string
Since
10.2

Extends class AGSPoint.

- (NSString*) MGRSStringWithNumDigits: (NSInteger)  numDigits
rounding: (BOOL)  rounding
addSpaces: (BOOL)  addSpaces 

Returns a Military Grid Reference System (MGRS) coordinate for the current point. For example : 4Q 612341 2356781

Parameters
numDigitsThe number of digits to be included in the MGRS coordinate
roundingWhether the numeric value should be rounded
addSpacesWhether the MGRS coordinate string should include spaces
Returns
The MGRS coordinate string
Since
10.2

Extends class AGSPoint.

+ (AGSPoint*) pointFromDecimalDegreesString: (NSString *)  decimalDegrees
withSpatialReference: (AGSSpatialReference *)  outputSR 

Returns a point for a given a coordinate notation string in the Decimal Degrees (DD) format, for eg "34.0547 N, 117.1825 W".

Parameters
decimalDegressThe coordinate string.
outputSRThe spatial reference of the point to be returned.
Since
10.2

Extends class AGSPoint.

+ (AGSPoint*) pointFromDegreesDecimalMinutesString: (NSString *)  ddm
withSpatialReference: (AGSSpatialReference *)  outputSR 

Returns a point for a given coordinate notation string in the Degrees Decimal Minutes (DDM) format, for eg "7 5.123 N 94 17.765 E".

Parameters
ddmThe coordinate string.
outputSRThe spatial reference of the point to be returned.
Since
10.2

Extends class AGSPoint.

+ (AGSPoint*) pointFromDegreesMinutesSecondsString: (NSString *)  degreesMinutesSeconds
withSpatialReference: (AGSSpatialReference *)  outputSR 

Returns a point for a given coordinate notation string in the Degrees Minutes Seconds (DMS) format, for eg "34 2 2.8 N, 117 53 24.66 E"

Parameters
degreesMinutesSecondsThe coordinate string.
outputSRThe spatial reference of the point to be returned.
Since
10.2

Extends class AGSPoint.

+ (AGSPoint*) pointFromGARSString: (NSString *)  gars
withSpatialReference: (AGSSpatialReference *)  outputSR
conversionMode: (AGSGARSConversionMode conversionMode 

Returns a point for a given coordinate notation string in the Global Area Reference System (GARS) format, for eg "421LA37".

Parameters
garsThe coordinate string.
outputSRThe spatial reference of the point to be returned.
conversionModeA value determining whether the returned map point will represent the lower left or center of the cell, quadrant or area.
Since
10.2

Extends class AGSPoint.

+ (AGSPoint*) pointFromGEOREFString: (NSString *)  georef
withSpatialReference: (AGSSpatialReference *)  outputSR 

Returns a point for a given coordinate notation string in the Geographic Reference system (GEOREF) format, for eg "QJAA0000000000".

Parameters
georefThe coordinate string.
outputSRThe spatial reference of the point to be returned.
Since
10.2

Extends class AGSPoint.

+ (AGSPoint*) pointFromMGRSString: (NSString *)  mgrs
withSpatialReference: (AGSSpatialReference *)  outputSR 

Returns a point for a given MGRS coordinate string, for eg "36RTJ1059034722575904" or "4Q 612341 2356781"

Parameters
mgrsThe coordinate string. Can contain spaces.
outputSRThe spatial reference of the point to be returned.
Returns
A point from the MGRS coordinate
Since
10.2

Extends class AGSPoint.

+ (AGSPoint*) pointFromUSNGString: (NSString *)  usng
withSpatialReference: (AGSSpatialReference *)  outputSR 

Returns a point for a given coordinate notation string in the United States National Grid (USNG) format, for eg "32Q PH 04609324 11793556".

Parameters
usngThe coordinate string.
outputSRThe spatial reference of the point to be returned.
Since
10.2

Extends class AGSPoint.

+ (AGSPoint*) pointFromUTMString: (NSString *)  utm
withSpatialReference: (AGSSpatialReference *)  outputSR
conversionMode: (AGSUTMConversionMode conversionMode 

Returns a point for a given coordinate notation string in the Universal Transverse Mercator (UTM) format, for eg "31N1660210000000".

Parameters
utmThe coordinate string.
outputSRThe spatial reference of the point to be returned.
conversionModeA value indicating whether the coordinate string contains North or South Hemisphere indicators.
Since
10.2

Extends class AGSPoint.

- (NSString*) USNGStringWithNumDigits: (NSInteger)  numDigits
rounding: (BOOL)  rounding
addSpaces: (BOOL)  addSpaces 

Returns a string with United States National Grid (USNG) format for the current point.

Parameters
numDigitsThe number of digits to be included in the output string
roundingWhether the numeric value should be rounded
addSpacesWhether the coordinate string should include spaces
Returns
The USNG string
Since
10.2

Extends class AGSPoint.

- (NSString*) UTMStringWithConversionMode: (AGSUTMConversionMode conversionMode
addSpaces: (BOOL)  addSpaces 

Returns a string with Universal Transverse Mercator (UTM) format for the current point.

Parameters
conversionModeThe mode to use during conversion
addSpacesWhether the coordinate string should include spaces
Returns
the UTM string
Since
10.2

Extends class AGSPoint.