Interface IDistanceConverter

All Superinterfaces:
All Known Implementing Classes:

public interface IDistanceConverter
extends Serializable

Provides access to methods that allow a distance to be converted from one unit system to another.

Product Availability

Available with ArcGIS Desktop.

Method Summary
 double getValue(String val, ISpatialReference pUnits)
          Converts the string value to a double.

Method Detail


double getValue(String val,
                ISpatialReference pUnits)
                throws IOException,
Converts the string value to a double.


GetValue returns a Double value that is a converted distance from the input string. The input string is formatted that combines a distance value and a suffix abbreviation of the distance units. A spatial reference is used to determine the output distance units.

The following list of suffixes can be used:

Metric Units:

Distance Units Abbrev. Meters per Unit Description
Kilometer km 1000 1000 meters exactly
Meter m 1 International meter.
Millimeter mm 0.001 1/1000 meters exactly

Imperial or international units:

Distance Units Abbrev. Meters per Unit Description
Foot ft 0.3048 Standard foot in the US. Also known as international foot or imperial foot that was used in most non-US countries before the metric system.
Mile mi 1609.344 Also referred to a statute mile, equal to 5280 international feet.
Nautical mile nm 1852 The nautical mile is a unit of distance used primarily in sea and in aviation.
Chain ch 20.1168 66 international feet.
Yard yd 0.9144 Three international feet.
Rod rd 5.0292 1/4 chain or 16.5 international feet.
Link lk 0.201168 1/100 international chain or 66/100 international feet.
Inch in 0.0254 1/12 of an international foot.
US survey units:
Distance Units Abbrev. Meters per Unit Description
Survey foot ftus ~0.3048006 The US survey foot is used in the State Plane Coordinate Systems. An exact conversion is accomplished by multiplying US survey feet by the fraction 1200/3937.
Survey mile mius ~1609.347219 5280 survey feet.
Survey chain chus ~20.116840 66 survey feet.
Survey rod rdus ~5.029210 1/4 survey chain.
Survey link lkus ~0.201168 1/100 survey chain.
Survey yard ydus ~0.914402 3 survey feet.

Product Availability

Available with ArcGIS Desktop.

Supported Platforms


val - The val (in)
pUnits - A reference to a com.esri.arcgis.geometry.ISpatialReference (in)
The pVal
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.