User Tools

Site Tools


thinkgeo.mapsuite.core.decimaldegreeshelper

ThinkGeo.MapSuite.Core.DecimalDegreesHelper

Note: The page was created before Map Suite 10. Map Suite 10.0 organized many classes into new namespaces and assemblies as well as had a few minor breaks in compatibility. The majority of previously built code should work without modification assuming the new namespaces are added. For guidance on upgrading your existing code, please check out MapSuite 10 Upgrade Guide.

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

ToString()

  • N/A
Remarks
  • N/A
Return Value
  • Type:String
  • Description:N/A
Parameters

Equals(Object)

  • N/A
Remarks
  • N/A
Return Value
  • Type:Boolean
  • Description:N/A
Parameters
  • obj
    • Type:Object
    • Description:N/A

GetHashCode()

  • N/A
Remarks
  • N/A
Return Value
  • Type:Int32
  • Description:N/A
Parameters

GetType()

  • N/A
Remarks
  • N/A
Return Value
  • Type:Type
  • Description:N/A
Parameters

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:Feature
    • Description:The feature you want to convert.
  • decimals
    • Type:Int32
    • Description:Number of decimals for the Minutes value

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:Feature
    • Description:The point you want to convert.

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

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
  • decimals
    • Type:Int32
    • Description:Number of decimals for the Minutes value

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
  • 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.

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.

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.

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' 29E 36?20' 42N”.
Return Value
  • Type:String
  • Description:This method returns a string representation in degrees, minutes and seconds from a decimal degree value.
Parameters
  • pointShape
    • Description:The point you want to convert.

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
    • Description:The point of decimal degree to convert.
  • decimals
    • Type:Int32
    • Description:The number of decimal degree to convert.

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:Feature
    • Description:The feature whose decimal degrees to convert.
  • decimalPlaces
    • Type:Int32
    • Description:The number of decimal degree to convert.

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:Feature
    • Description:The feature whose decimal degrees to convert.

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.

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

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.

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
    • Description:The point shape you will measure from.
  • toPoint
    • Description:The point shape you will measure to.
  • returningUnit
    • Description:The unit you would like your results back in, such as miles or kilometers.

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:Feature
    • Description:The feature you will measure from.
  • toPointFeature
    • Type:Feature
    • Description:The feature you will measure to.
  • returningUnit
    • Description:The unit you would like your results back in, such as miles or kilometers.

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
    • 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.

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
    • 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.

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
    • Description:The unit the distance is in, such as miles or kilometers.

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.

ConvertFromMgrs(String)

  • Convert the MGRS string to latitude and longitude
Remarks
  • N/A
Return Value
  • Description:The converted coordinate.
Parameters
  • mgrs
    • Type:String
    • Description:MGRS string

Protected Methods

Finalize()

  • N/A
Remarks
  • N/A
Return Value
  • Type:Void
  • Description:N/A
Parameters

MemberwiseClone()

  • N/A
Remarks
  • N/A
Return Value
  • Type:Object
  • Description:N/A
Parameters

GetDegreesMinutesStringFromDecimalDegree(Double)

  • N/A
Remarks
  • N/A
Return Value
  • Type:String
  • Description:N/A
Parameters
  • decimalDegreesValue
    • Type:Double
    • Description:N/A

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

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
  • degree
    • Type:Double
    • Description:N/A

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
  • degree
    • Type:Double
    • Description:N/A

GetGreatCircle(PointShape,PointShape,Int32)

  • N/A
Remarks
  • N/A
Return Value
Parameters
  • count
    • Type:Int32
    • Description:N/A

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

GetNearestPointFromPointShapeDecimalDegreesLine(Double,Double,Double,Double,PointShape)

  • N/A
Remarks
  • N/A
Return Value
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

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

GetYFromDegreeOnSphere(Double,DistanceUnit)

  • N/A
Remarks
  • N/A
Return Value
  • Type:Double
  • Description:N/A
Parameters
  • degreeY
    • Type:Double
    • Description:N/A

AmendDegrees(String)

  • N/A
Remarks
  • N/A
Return Value
  • Type:String
  • Description:N/A
Parameters
  • degreesMinutesSeconds
    • Type:String
    • Description:N/A

Public Properties

Protected Properties

Public Events

thinkgeo.mapsuite.core.decimaldegreeshelper.txt · Last modified: 2017/03/16 21:59 (external edit)