====== ThinkGeo.MapSuite.Core.DecimalDegreesHelper ======

{{section>upgrade_map_suite_to_10.0}}

This class contains a static routine for converting between degree-minute-second measurement and decimal degree measurement. In essense, it is a routine for converting from a non-decimal degree unit to decimal degree unit distance.
===== Inheritance Hierarchy =====
  *System.Object
    ***ThinkGeo.MapSuite.Core.DecimalDegreesHelper**
===== Members Summary =====
==== Public Constructors ====
==== Protected Constructors ====
==== Public Methods ====
** {{wiki:PublicMethod.gif|}} ToString() **

  * //N/A//
== Remarks ==
  * //N/A//

== Return Value ==
  * Type:String
  * Description:N/A

== Parameters ==
<div newline></div>
** {{wiki:PublicMethod.gif|}} Equals(Object) **

  * //N/A//
== Remarks ==
  * //N/A//

== Return Value ==
  * Type:Boolean
  * Description:N/A

== Parameters ==
  * //obj//
    * Type:Object
    * Description:N/A

<div newline></div>
** {{wiki:PublicMethod.gif|}} GetHashCode() **

  * //N/A//
== Remarks ==
  * //N/A//

== Return Value ==
  * Type:Int32
  * Description:N/A

== Parameters ==
<div newline></div>
** {{wiki:PublicMethod.gif|}} GetType() **

  * //N/A//
== Remarks ==
  * //N/A//

== Return Value ==
  * Type:Type
  * Description:N/A

== Parameters ==
<div newline></div>
** {{wiki:PublicMethod.gif|}}{{wiki:Static.gif|}} GetDegreesMinutesStringFromDecimalDegreePoint(Feature,Int32) **

  * //This method returns a string representation in degrees and minutes from a decimal degree point.//
== Remarks ==
  * //N/A//

== Return Value ==
  * Type:String
  * Description:This method returns a string representation in degrees and minutes from a decimal degree point.

== Parameters ==
  * //point//
    * Type:[[ThinkGeo.MapSuite.Core.Feature|Feature]]
    * Description:The feature you want to convert.

  * //decimals//
    * Type:Int32
    * Description:Number of decimals for the Minutes value

<div newline></div>
** {{wiki:PublicMethod.gif|}}{{wiki:Static.gif|}} GetDegreesMinutesStringFromDecimalDegreePoint(Feature) **

  * //This method returns a string representation in degrees and minutes from a decimal degree point.//
== Remarks ==
  * //N/A//

== Return Value ==
  * Type:String
  * Description:This method returns a string representation in degrees and minutes from a decimal degree point.

== Parameters ==
  * //point//
    * Type:[[ThinkGeo.MapSuite.Core.Feature|Feature]]
    * Description:The point you want to convert.

<div newline></div>
** {{wiki:PublicMethod.gif|}}{{wiki:Static.gif|}} GetDegreesMinutesStringFromDecimalDegreePoint(PointShape) **

  * //This method returns a string representation in degrees and minutes from a decimal degree point.//
== Remarks ==
  * //N/A//

== Return Value ==
  * Type:String
  * Description:This method returns a string representation in degrees and minutes from a decimal degree point.

== Parameters ==
  * //pointShape//
    * Type:[[ThinkGeo.MapSuite.Core.PointShape|PointShape]]
    * Description:N/A

<div newline></div>
** {{wiki:PublicMethod.gif|}}{{wiki:Static.gif|}} GetDegreesMinutesStringFromDecimalDegreePoint(PointShape,Int32) **

  * //This method returns a string representation in degrees and minutes from a decimal degree point.//
== Remarks ==
  * //N/A//

== Return Value ==
  * Type:String
  * Description:This method returns a string representation in degrees and minutes from a decimal degree point.

== Parameters ==
  * //pointShape//
    * Type:[[ThinkGeo.MapSuite.Core.PointShape|PointShape]]
    * Description:N/A

  * //decimals//
    * Type:Int32
    * Description:Number of decimals for the Minutes value

<div newline></div>
** {{wiki:PublicMethod.gif|}}{{wiki:Static.gif|}} GetDegreesMinutesSecondsFromDecimalDegree(Double) **

  * //This method returns a degrees, minutes and seconds structure from a decimal degree value.//
== Remarks ==
  * //The method allows you pass in a decimal degree number and return the degree, minute, second as variables passed in on the method call.//

== Return Value ==
  * Type:[[ThinkGeo.MapSuite.Core.DegreesMinutesSeconds|DegreesMinutesSeconds]]
  * Description:This method returns a degrees, minutes and seconds structure from a decimal degree value.

== Parameters ==
  * //decimalDegreesValue//
    * Type:Double
    * Description:The decimal degree value you want to convert.

<div newline></div>
** {{wiki:PublicMethod.gif|}}{{wiki:Static.gif|}} GetDegreesMinutesSecondsStringFromDecimalDegree(Double) **

  * //This method returns a string representation in degrees, minutes and seconds from a decimal degree value.//
== Remarks ==
  * //Example: If you enter 75.358 as the number of decimal degrees, the result would be 75 degrees, 21 minutes, 28 seconds. Thus, the return string would be 75?21' 28".//

== Return Value ==
  * Type:String
  * Description:This method returns a string representation in degrees, minutes and seconds from a decimal degree value.

== Parameters ==
  * //decimalDegreesValue//
    * Type:Double
    * Description:The number of decimal degrees to convert.

<div newline></div>
** {{wiki:PublicMethod.gif|}}{{wiki:Static.gif|}} GetDegreesMinutesSecondsStringFromDecimalDegree(Double,Int32) **

  * //This method returns a string representation in degrees, minutes and seconds from a decimal degree value and a specified precision.//
== Remarks ==
  * //Example: If you enter 75.358 as the number of decimal degree and 12 as decimals, the result would be 75 degrees, 21 minutes, 28.80000000015 seconds. Thus, the return string would be 75?21' 28.80000000015".//

== Return Value ==
  * Type:String
  * Description:This method returns a string representation in degrees, minutes and seconds from a decimal degree value.

== Parameters ==
  * //decimalDegreesValue//
    * Type:Double
    * Description:The number of decimal degree to convert.

  * //decimals//
    * Type:Int32
    * Description:The number of float decision for the second.

<div newline></div>
** {{wiki:PublicMethod.gif|}}{{wiki:Static.gif|}} GetDegreesMinutesSecondsStringFromDecimalDegreePoint(PointShape) **

  * //This method returns a string representation in degrees, minutes and seconds from a decimal degree value.//
== Remarks ==
  * //Passing in a point will return the point's location represented in degrees, minutes, and seconds. For example, if the point's location in decimal degrees is (75.358, 36.345), the actual returned string would be "75?21' 29''E  36?20' 42''N".//

== Return Value ==
  * Type:String
  * Description:This method returns a string representation in degrees, minutes and seconds from a decimal degree value.

== Parameters ==
  * //pointShape//
    * Type:[[ThinkGeo.MapSuite.Core.PointShape|PointShape]]
    * Description:The point you want to convert.

<div newline></div>
** {{wiki:PublicMethod.gif|}}{{wiki:Static.gif|}} GetDegreesMinutesSecondsStringFromDecimalDegreePoint(PointShape,Int32) **

  * //This method returns a string representation in degrees, minutes and seconds from a decimal degree value.//
== Remarks ==
  * //None//

== Return Value ==
  * Type:String
  * Description:This method returns a string representation in degrees, minutes and seconds from a decimal degree value.

== Parameters ==
  * //pointShape//
    * Type:[[ThinkGeo.MapSuite.Core.PointShape|PointShape]]
    * Description:The point of decimal degree to convert.

  * //decimals//
    * Type:Int32
    * Description:The number of decimal degree to convert.

<div newline></div>
** {{wiki:PublicMethod.gif|}}{{wiki:Static.gif|}} GetDegreesMinutesSecondsStringFromDecimalDegreePoint(Feature,Int32) **

  * //This method returns a string representation in degrees, minutes and seconds from a decimal degree value.//
== Remarks ==
  * //None//

== Return Value ==
  * Type:String
  * Description:This method returns a string representation in degrees, minutes and seconds from a decimal degree value.

== Parameters ==
  * //point//
    * Type:[[ThinkGeo.MapSuite.Core.Feature|Feature]]
    * Description:The feature whose decimal degrees to convert.

  * //decimalPlaces//
    * Type:Int32
    * Description:The number of decimal degree to convert.

<div newline></div>
** {{wiki:PublicMethod.gif|}}{{wiki:Static.gif|}} GetDegreesMinutesSecondsStringFromDecimalDegreePoint(Feature) **

  * //This method returns a string representation in degrees, minutes and seconds from a decimal degree value.//
== Remarks ==
  * //None//

== Return Value ==
  * Type:String
  * Description:This method returns a string representation in degrees, minutes and seconds from a decimal degree value.

== Parameters ==
  * //point//
    * Type:[[ThinkGeo.MapSuite.Core.Feature|Feature]]
    * Description:The feature whose decimal degrees to convert.

<div newline></div>
** {{wiki:PublicMethod.gif|}}{{wiki:Static.gif|}} GetDecimalDegreeFromDegreesMinutesSeconds(String) **

  * //This method returns a decimal degree value based on a string containing degrees, minutes, and seconds.//
== Remarks ==
  * //If you pass in "75?21' 28''" as a string, then the result will be 75.35777777784.//

== Return Value ==
  * Type:Double
  * Description:This method returns a decimal degree value based on a string containing degrees, minutes, and seconds.

== Parameters ==
  * //degreesMinutesSeconds//
    * Type:String
    * Description:This parameter represents the degrees, minutes and seconds in a string.

<div newline></div>
** {{wiki:PublicMethod.gif|}}{{wiki:Static.gif|}} GetDecimalDegreeFromDegreesMinutesSeconds(DegreesMinutesSeconds) **

  * //This method returns a decimal degree value based on a degree, minute and second structure.//
== Remarks ==
  * //If you pass in 75, 21 and 28, the result passed back will be 75.2577777778.//

== Return Value ==
  * Type:Double
  * Description:This method returns a decimal degree value based on a degree, minute and second structure.

== Parameters ==
  * //degreesMinutesSeconds//
    * Type:[[ThinkGeo.MapSuite.Core.DegreesMinutesSeconds|DegreesMinutesSeconds]]
    * Description:This structure represents the degrees, minutes and seconds.

<div newline></div>
** {{wiki:PublicMethod.gif|}}{{wiki:Static.gif|}} GetDecimalDegreeFromDegreesMinutesSeconds(Int32,Int32,Double) **

  * //This method returns a decimal degree value based on a set of degrees, minutes, and seconds.//
== Remarks ==
  * //If you pass in 75, 21 and 28, the result passed back will be 75.2577777778.//

== Return Value ==
  * Type:Double
  * Description:This method returns a decimal degree value based on a set of degrees, minutes, and seconds.

== Parameters ==
  * //degrees//
    * Type:Int32
    * Description:This parameter represents the degree component of the degrees, minutes and seconds.

  * //minutes//
    * Type:Int32
    * Description:This parameter represents the minute component of the degrees, minutes and seconds.

  * //seconds//
    * Type:Double
    * Description:This parameter represents the second component of the degrees, minutes and seconds.

<div newline></div>
** {{wiki:PublicMethod.gif|}}{{wiki:Static.gif|}} GetDistanceFromDecimalDegrees(PointShape,PointShape,DistanceUnit) **

  * //This method returns the distance between two decimal degree points.//
== Remarks ==
  * //None//

== Return Value ==
  * Type:Double
  * Description:This method returns the distance between two decimal degree points in the unit specified by the returningUnit parameter.

== Parameters ==
  * //fromPoint//
    * Type:[[ThinkGeo.MapSuite.Core.PointShape|PointShape]]
    * Description:The point shape you will measure from.

  * //toPoint//
    * Type:[[ThinkGeo.MapSuite.Core.PointShape|PointShape]]
    * Description:The point shape you will measure to.

  * //returningUnit//
    * Type:[[ThinkGeo.MapSuite.Core.DistanceUnit|DistanceUnit]]
    * Description:The unit you would like your results back in, such as miles or kilometers.

<div newline></div>
** {{wiki:PublicMethod.gif|}}{{wiki:Static.gif|}} GetDistanceFromDecimalDegrees(Feature,Feature,DistanceUnit) **

  * //This method returns the distance between two decimal degree points.//
== Remarks ==
  * //None//

== Return Value ==
  * Type:Double
  * Description:This method returns the distance between two decimal degree points in the unit specified by the returningUnit parameter.

== Parameters ==
  * //fromPointFeature//
    * Type:[[ThinkGeo.MapSuite.Core.Feature|Feature]]
    * Description:The feature you will measure from.

  * //toPointFeature//
    * Type:[[ThinkGeo.MapSuite.Core.Feature|Feature]]
    * Description:The feature you will measure to.

  * //returningUnit//
    * Type:[[ThinkGeo.MapSuite.Core.DistanceUnit|DistanceUnit]]
    * Description:The unit you would like your results back in, such as miles or kilometers.

<div newline></div>
** {{wiki:PublicMethod.gif|}}{{wiki:Static.gif|}} GetDistanceFromDecimalDegrees(Double,Double,Double,Double,DistanceUnit) **

  * //This method returns the distance between two decimal degree points.//
== Remarks ==
  * //None//

== Return Value ==
  * Type:Double
  * Description:This method returns the distance between two decimal degree points in the unit specified by the returningUnit parameter.

== Parameters ==
  * //fromLongitude//
    * Type:Double
    * Description:This is the from longitude value.

  * //fromLatitude//
    * Type:Double
    * Description:This is the from latitude value.

  * //toLongitude//
    * Type:Double
    * Description:This is the to longitude value.

  * //toLatitude//
    * Type:Double
    * Description:This is the to latitude value.

  * //returningUnit//
    * Type:[[ThinkGeo.MapSuite.Core.DistanceUnit|DistanceUnit]]
    * Description:This is the distance unit you would like to use in the return value. For example, if you select miles as your returningUnit, then the distance will be returned in miles.

<div newline></div>
** {{wiki:PublicMethod.gif|}}{{wiki:Static.gif|}} GetLongitudeDifferenceFromDistance(Double,DistanceUnit,Double) **

  * //Calculate the amount of longitude change given a certain distance and latitude.//
== Remarks ==
  * //None//

== Return Value ==
  * Type:Double
  * Description:Double representing the distance.

== Parameters ==
  * //distance//
    * Type:Double
    * Description:The distance over which you would like to know the change in longitude.

  * //distanceUnit//
    * Type:[[ThinkGeo.MapSuite.Core.DistanceUnit|DistanceUnit]]
    * Description:The unit the distance is in, such as miles or kilometers.

  * //latitude//
    * Type:Double
    * Description:The latitude on the globe that the distance is measured at.

<div newline></div>
** {{wiki:PublicMethod.gif|}}{{wiki:Static.gif|}} GetLatitudeDifferenceFromDistance(Double,DistanceUnit) **

  * //Calculate the amount of longitude change given a certain distance and longitude.//
== Remarks ==
  * //None//

== Return Value ==
  * Type:Double
  * Description:Double representing the distance.

== Parameters ==
  * //distance//
    * Type:Double
    * Description:The distance over which you would like to know the change in longitude.

  * //distanceUnit//
    * Type:[[ThinkGeo.MapSuite.Core.DistanceUnit|DistanceUnit]]
    * Description:The unit the distance is in, such as miles or kilometers.

<div newline></div>
** {{wiki:PublicMethod.gif|}}{{wiki:Static.gif|}} ConvertToMgrs(Double,Double) **

  * //Convert the input latitude and longitude to MGRS string//
== Remarks ==
  * //N/A//

== Return Value ==
  * Type:String
  * Description:The MGRS corresponding to input latitude and longitude.

== Parameters ==
  * //longitude//
    * Type:Double
    * Description:Longitude coordinate.

  * //latitude//
    * Type:Double
    * Description:Latitude coordinate.

<div newline></div>
** {{wiki:PublicMethod.gif|}}{{wiki:Static.gif|}} ConvertFromMgrs(String) **

  * //Convert the MGRS string to latitude and longitude//
== Remarks ==
  * //N/A//

== Return Value ==
  * Type:[[ThinkGeo.MapSuite.Core.PointShape|PointShape]]
  * Description:The converted coordinate.

== Parameters ==
  * //mgrs//
    * Type:String
    * Description:MGRS string

<div newline></div>
==== Protected Methods ====
** {{wiki:ProtectedMethod.gif|}} Finalize() **

  * //N/A//
== Remarks ==
  * //N/A//

== Return Value ==
  * Type:Void
  * Description:N/A

== Parameters ==
<div newline></div>
** {{wiki:ProtectedMethod.gif|}} MemberwiseClone() **

  * //N/A//
== Remarks ==
  * //N/A//

== Return Value ==
  * Type:Object
  * Description:N/A

== Parameters ==
<div newline></div>
** {{wiki:ProtectedMethod.gif|}}{{wiki:Static.gif|}} GetDegreesMinutesStringFromDecimalDegree(Double) **

  * //N/A//
== Remarks ==
  * //N/A//

== Return Value ==
  * Type:String
  * Description:N/A

== Parameters ==
  * //decimalDegreesValue//
    * Type:Double
    * Description:N/A

<div newline></div>
** {{wiki:ProtectedMethod.gif|}}{{wiki:Static.gif|}} GetDegreesMinutesStringFromDecimalDegree(Double,Int32) **

  * //N/A//
== Remarks ==
  * //N/A//

== Return Value ==
  * Type:String
  * Description:N/A

== Parameters ==
  * //decimalDegreesValue//
    * Type:Double
    * Description:N/A

  * //decimals//
    * Type:Int32
    * Description:N/A

<div newline></div>
** {{wiki:ProtectedMethod.gif|}}{{wiki:Static.gif|}} GetLatitudeFromDistanceAndDegree(Double,Double,Double,DistanceUnit,Double) **

  * //N/A//
== Remarks ==
  * //N/A//

== Return Value ==
  * Type:Double
  * Description:N/A

== Parameters ==
  * //fromLongitude//
    * Type:Double
    * Description:N/A

  * //fromLatitude//
    * Type:Double
    * Description:N/A

  * //distance//
    * Type:Double
    * Description:N/A

  * //distanceUnit//
    * Type:[[ThinkGeo.MapSuite.Core.DistanceUnit|DistanceUnit]]
    * Description:N/A

  * //degree//
    * Type:Double
    * Description:N/A

<div newline></div>
** {{wiki:ProtectedMethod.gif|}}{{wiki:Static.gif|}} GetLongitudeFromDistanceAndDegree(Double,Double,Double,DistanceUnit,Double) **

  * //N/A//
== Remarks ==
  * //N/A//

== Return Value ==
  * Type:Double
  * Description:N/A

== Parameters ==
  * //fromLongitude//
    * Type:Double
    * Description:N/A

  * //fromLatitude//
    * Type:Double
    * Description:N/A

  * //distance//
    * Type:Double
    * Description:N/A

  * //distanceUnit//
    * Type:[[ThinkGeo.MapSuite.Core.DistanceUnit|DistanceUnit]]
    * Description:N/A

  * //degree//
    * Type:Double
    * Description:N/A

<div newline></div>
** {{wiki:ProtectedMethod.gif|}}{{wiki:Static.gif|}} GetGreatCircle(PointShape,PointShape,Int32) **

  * //N/A//
== Remarks ==
  * //N/A//

== Return Value ==
  * Type:[[ThinkGeo.MapSuite.Core.MultilineShape|MultilineShape]]
  * Description:N/A

== Parameters ==
  * //fromPoint//
    * Type:[[ThinkGeo.MapSuite.Core.PointShape|PointShape]]
    * Description:N/A

  * //toPoint//
    * Type:[[ThinkGeo.MapSuite.Core.PointShape|PointShape]]
    * Description:N/A

  * //count//
    * Type:Int32
    * Description:N/A

<div newline></div>
** {{wiki:ProtectedMethod.gif|}}{{wiki:Static.gif|}} GetDistanceFromDecimalDegreesLine(Double,Double,Double,Double,PointShape,DistanceUnit) **

  * //N/A//
== Remarks ==
  * //N/A//

== Return Value ==
  * Type:Double
  * Description:N/A

== Parameters ==
  * //fromPointX//
    * Type:Double
    * Description:N/A

  * //fromPointY//
    * Type:Double
    * Description:N/A

  * //toPointX//
    * Type:Double
    * Description:N/A

  * //toPointY//
    * Type:Double
    * Description:N/A

  * //pointShape//
    * Type:[[ThinkGeo.MapSuite.Core.PointShape|PointShape]]
    * Description:N/A

  * //lengthUnit//
    * Type:[[ThinkGeo.MapSuite.Core.DistanceUnit|DistanceUnit]]
    * Description:N/A

<div newline></div>
** {{wiki:ProtectedMethod.gif|}}{{wiki:Static.gif|}} GetNearestPointFromPointShapeDecimalDegreesLine(Double,Double,Double,Double,PointShape) **

  * //N/A//
== Remarks ==
  * //N/A//

== Return Value ==
  * Type:[[ThinkGeo.MapSuite.Core.PointShape|PointShape]]
  * Description:N/A

== Parameters ==
  * //fromPointX//
    * Type:Double
    * Description:N/A

  * //fromPointY//
    * Type:Double
    * Description:N/A

  * //toPointX//
    * Type:Double
    * Description:N/A

  * //toPointY//
    * Type:Double
    * Description:N/A

  * //pointShape//
    * Type:[[ThinkGeo.MapSuite.Core.PointShape|PointShape]]
    * Description:N/A

<div newline></div>
** {{wiki:ProtectedMethod.gif|}}{{wiki:Static.gif|}} GetXFromDegreeOnSphere(Double,Double,DistanceUnit) **

  * //N/A//
== Remarks ==
  * //N/A//

== Return Value ==
  * Type:Double
  * Description:N/A

== Parameters ==
  * //degreeX//
    * Type:Double
    * Description:N/A

  * //degreeY//
    * Type:Double
    * Description:N/A

  * //distanceUnit//
    * Type:[[ThinkGeo.MapSuite.Core.DistanceUnit|DistanceUnit]]
    * Description:N/A

<div newline></div>
** {{wiki:ProtectedMethod.gif|}}{{wiki:Static.gif|}} GetYFromDegreeOnSphere(Double,DistanceUnit) **

  * //N/A//
== Remarks ==
  * //N/A//

== Return Value ==
  * Type:Double
  * Description:N/A

== Parameters ==
  * //degreeY//
    * Type:Double
    * Description:N/A

  * //distanceUnit//
    * Type:[[ThinkGeo.MapSuite.Core.DistanceUnit|DistanceUnit]]
    * Description:N/A

<div newline></div>
** {{wiki:ProtectedMethod.gif|}}{{wiki:Static.gif|}} AmendDegrees(String) **

  * //N/A//
== Remarks ==
  * //N/A//

== Return Value ==
  * Type:String
  * Description:N/A

== Parameters ==
  * //degreesMinutesSeconds//
    * Type:String
    * Description:N/A

<div newline></div>
==== Public Properties ====
==== Protected Properties ====
==== Public Events ====