User Tools

Site Tools


thinkgeo.mapsuite.core.decimaldegreeshelper

This is an old revision of the document!


ThinkGeo.MapSuite.Core.DecimalDegreesHelper

<!– Class –> 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

Members Summary

Public Constructors

Name Parameters DeclaringType Summary

Protected Constructors

Name Parameters DeclaringType Summary

Public Methods

Name Parameters DeclaringType Summary
Public MethodStatic MemberConvertFromMgrs String Convert the MGRS string to latitude and longitude
Public MethodStatic MemberConvertToMgrs Double, Double Convert the input latitude and longitude to MGRS string
Public MethodEquals Object Object
Public MethodStatic MemberGetDecimalDegreeFromDegreesMinutesSeconds Int32, Int32, Double This method returns a decimal degree value based on a set of degrees, minutes, and seconds.
Public MethodStatic MemberGetDecimalDegreeFromDegreesMinutesSeconds String This method returns a decimal degree value based on a string containing degrees, minutes, and seconds.
Public MethodStatic MemberGetDecimalDegreeFromDegreesMinutesSeconds DegreesMinutesSeconds This method returns a decimal degree value based on a degree, minute and second structure.
Public MethodStatic MemberGetDegreesMinutesSecondsFromDecimalDegree Double This method returns a degrees, minutes and seconds structure from a decimal degree value.
Public MethodStatic MemberGetDegreesMinutesSecondsStringFromDecimalDegree Double This method returns a string representation in degrees, minutes and seconds from a decimal degree value.
Public MethodStatic MemberGetDegreesMinutesSecondsStringFromDecimalDegree Double, Int32 This method returns a string representation in degrees, minutes and seconds from a decimal degree value and a specified precision.
Public MethodStatic MemberGetDegreesMinutesSecondsStringFromDecimalDegreePoint PointShape This method returns a string representation in degrees, minutes and seconds from a decimal degree value.
Public MethodStatic MemberGetDegreesMinutesSecondsStringFromDecimalDegreePoint PointShape, Int32 This method returns a string representation in degrees, minutes and seconds from a decimal degree value.
Public MethodStatic MemberGetDegreesMinutesSecondsStringFromDecimalDegreePoint Feature, Int32 This method returns a string representation in degrees, minutes and seconds from a decimal degree value.
Public MethodStatic MemberGetDegreesMinutesSecondsStringFromDecimalDegreePoint Feature This method returns a string representation in degrees, minutes and seconds from a decimal degree value.
Public MethodStatic MemberGetDegreesMinutesStringFromDecimalDegreePoint Feature, Int32 This method returns a string representation in degrees and minutes from a decimal degree point.
Public MethodStatic MemberGetDegreesMinutesStringFromDecimalDegreePoint PointShape, Int32 This method returns a string representation in degrees and minutes from a decimal degree point.
Public MethodStatic MemberGetDegreesMinutesStringFromDecimalDegreePoint PointShape This method returns a string representation in degrees and minutes from a decimal degree point.
Public MethodStatic MemberGetDegreesMinutesStringFromDecimalDegreePoint Feature This method returns a string representation in degrees and minutes from a decimal degree point.
Public MethodStatic MemberGetDistanceFromDecimalDegrees Feature, Feature, DistanceUnit This method returns the distance between two decimal degree points.
Public MethodStatic MemberGetDistanceFromDecimalDegrees Double, Double, Double, Double, DistanceUnit This method returns the distance between two decimal degree points.
Public MethodStatic MemberGetDistanceFromDecimalDegrees PointShape, PointShape, DistanceUnit This method returns the distance between two decimal degree points.
Public MethodGetHashCode Object
Public MethodStatic MemberGetLatitudeDifferenceFromDistance Double, DistanceUnit Calculate the amount of longitude change given a certain distance and longitude.
Public MethodStatic MemberGetLongitudeDifferenceFromDistance Double, DistanceUnit, Double Calculate the amount of longitude change given a certain distance and latitude.
Public MethodGetType Object
Public MethodToString Object

Protected Methods

Name Parameters DeclaringType Summary
Protected MethodFinalize Object
Protected MethodMemberwiseClone Object

Public Properties

Name Return DeclaringType Summary

Protected Properties

Name Return DeclaringType Summary

Public Events

Name Event Arguments DeclaringType Summary

Public Constructors

Protected Constructors

Public Methods

ConvertFromMgrs(String)

<!– static –> Convert the MGRS string to latitude and longitude

Return Value

Return Type Description
PointShape<!– ThinkGeo.MapSuite.Core.PointShape –> The converted coordinate.

Parameters

Name Type Description
mgrs String<!– System.String –> MGRS string

<!– ThinkGeo.MapSuite.Core.DecimalDegreesHelper –> Go Back

ConvertToMgrs(Double, Double)

<!– static –> Convert the input latitude and longitude to MGRS string

Return Value

Return Type Description
String<!– System.String –> The MGRS corresponding to input latitude and longitude.

Parameters

Name Type Description
longitude Double<!– System.Double –> Longitude coordinate.
latitude Double<!– System.Double –> Latitude coordinate.

<!– ThinkGeo.MapSuite.Core.DecimalDegreesHelper –> Go Back

Equals(Object)

Return Value

Return Type Description
Boolean<!– System.Boolean –>

Parameters

Name Type Description
obj Object<!– System.Object –>

<!– System.Object –> Go Back

GetDecimalDegreeFromDegreesMinutesSeconds(Int32, Int32, Double)

<!– static –> 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

Return Type Description
Double<!– System.Double –> This method returns a decimal degree value based on a set of degrees, minutes, and seconds.

Parameters

Name Type Description
degrees Int32<!– System.Int32 –> This parameter represents the degree component of the degrees, minutes and seconds.
minutes Int32<!– System.Int32 –> This parameter represents the minute component of the degrees, minutes and seconds.
seconds Double<!– System.Double –> This parameter represents the second component of the degrees, minutes and seconds.

<!– ThinkGeo.MapSuite.Core.DecimalDegreesHelper –> Go Back

GetDecimalDegreeFromDegreesMinutesSeconds(String)

<!– static –> 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 === ^ Return Type ^ Description ^ | Double<!– System.Double –> | This method returns a decimal degree value based on a string containing degrees, minutes, and seconds. | === Parameters === ^ Name ^ Type ^ Description ^ | degreesMinutesSeconds | String<!– System.String –> | This parameter represents the degrees, minutes and seconds in a string. | <!– ThinkGeo.MapSuite.Core.DecimalDegreesHelper –> Go Back ==== GetDecimalDegreeFromDegreesMinutesSeconds(DegreesMinutesSeconds) ==== <!– static –> 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 === ^ Return Type ^ Description ^ | Double<!– System.Double –> | This method returns a decimal degree value based on a degree, minute and second structure. | === Parameters === ^ Name ^ Type ^ Description ^ | degreesMinutesSeconds | DegreesMinutesSeconds<!– ThinkGeo.MapSuite.Core.DegreesMinutesSeconds –> | This structure represents the degrees, minutes and seconds. | <!– ThinkGeo.MapSuite.Core.DecimalDegreesHelper –> Go Back ==== GetDegreesMinutesSecondsFromDecimalDegree(Double) ==== <!– static –> 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 === ^ Return Type ^ Description ^ | DegreesMinutesSeconds<!– ThinkGeo.MapSuite.Core.DegreesMinutesSeconds –> | This method returns a degrees, minutes and seconds structure from a decimal degree value. | === Parameters === ^ Name ^ Type ^ Description ^ | decimalDegreesValue | Double<!– System.Double –> | The decimal degree value you want to convert. | <!– ThinkGeo.MapSuite.Core.DecimalDegreesHelper –> Go Back ==== GetDegreesMinutesSecondsStringFromDecimalDegree(Double) ==== <!– static –> This method returns a string representation in degrees, minutes and seconds from a decimal degree value. === Overloads === This overload allows you to specify the 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 === ^ Return Type ^ Description ^ | String<!– System.String –> | This method returns a string representation in degrees, minutes and seconds from a decimal degree value. | === Parameters === ^ Name ^ Type ^ Description ^ | decimalDegreesValue | Double<!– System.Double –> | The number of decimal degrees to convert. | <!– ThinkGeo.MapSuite.Core.DecimalDegreesHelper –> Go Back ==== GetDegreesMinutesSecondsStringFromDecimalDegree(Double, Int32) ==== <!– static –> This method returns a string representation in degrees, minutes and seconds from a decimal degree value and a specified precision. === Overloads === This overload allows you to specify the decimal degree value along with the precision of the returned value. === 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 === ^ Return Type ^ Description ^ | String<!– System.String –> | This method returns a string representation in degrees, minutes and seconds from a decimal degree value. | === Parameters === ^ Name ^ Type ^ Description ^ | decimalDegreesValue | Double<!– System.Double –> | The number of decimal degree to convert. | | decimals | Int32<!– System.Int32 –> | The number of float decision for the second. | <!– ThinkGeo.MapSuite.Core.DecimalDegreesHelper –> Go Back ==== GetDegreesMinutesSecondsStringFromDecimalDegreePoint(PointShape) ==== <!– static –> This method returns a string representation in degrees, minutes and seconds from a decimal degree value. === Overloads === This overload allows you to pass in a point shape to be converted. === 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 === ^ Return Type ^ Description ^ | String<!– System.String –> | This method returns a string representation in degrees, minutes and seconds from a decimal degree value. | === Parameters === ^ Name ^ Type ^ Description ^ | pointShape | PointShape<!– ThinkGeo.MapSuite.Core.PointShape –> | The point you want to convert. | <!– ThinkGeo.MapSuite.Core.DecimalDegreesHelper –> Go Back ==== GetDegreesMinutesSecondsStringFromDecimalDegreePoint(PointShape, Int32) ==== <!– static –> This method returns a string representation in degrees, minutes and seconds from a decimal degree value. === Overloads === This overload allows you to pass in a point shape to be converted, along with the precision of the returned value. === Return Value === ^ Return Type ^ Description ^ | String<!– System.String –> | This method returns a string representation in degrees, minutes and seconds from a decimal degree value. | === Parameters === ^ Name ^ Type ^ Description ^ | pointShape | PointShape<!– ThinkGeo.MapSuite.Core.PointShape –> | The point of decimal degree to convert. | | decimals | Int32<!– System.Int32 –> | The number of decimal degree to convert. | <!– ThinkGeo.MapSuite.Core.DecimalDegreesHelper –> Go Back ==== GetDegreesMinutesSecondsStringFromDecimalDegreePoint(Feature, Int32) ==== <!– static –> This method returns a string representation in degrees, minutes and seconds from a decimal degree value. === Overloads === This overload allows you to pass in a feature to be converted, along with the precision of the returned value. === Return Value === ^ Return Type ^ Description ^ | String<!– System.String –> | This method returns a string representation in degrees, minutes and seconds from a decimal degree value. | === Parameters === ^ Name ^ Type ^ Description ^ | point | Feature<!– ThinkGeo.MapSuite.Core.Feature –> | The feature whose decimal degrees to convert. | | decimalPlaces | Int32<!– System.Int32 –> | The number of decimal degree to convert. | <!– ThinkGeo.MapSuite.Core.DecimalDegreesHelper –> Go Back ==== GetDegreesMinutesSecondsStringFromDecimalDegreePoint(Feature) ==== <!– static –> This method returns a string representation in degrees, minutes and seconds from a decimal degree value. === Overloads === This overload allows you to pass in a feature to be converted, along with the precision of the returned value. === Return Value === ^ Return Type ^ Description ^ | String<!– System.String –> | This method returns a string representation in degrees, minutes and seconds from a decimal degree value. | === Parameters === ^ Name ^ Type ^ Description ^ | point | Feature<!– ThinkGeo.MapSuite.Core.Feature –> | The feature whose decimal degrees to convert. | <!– ThinkGeo.MapSuite.Core.DecimalDegreesHelper –> Go Back ==== GetDegreesMinutesStringFromDecimalDegreePoint(Feature, Int32) ==== <!– static –> This method returns a string representation in degrees and minutes from a decimal degree point. === Overloads === This overload allows you to pass in a point shape to be converted. === Return Value === ^ Return Type ^ Description ^ | String<!– System.String –> | This method returns a string representation in degrees and minutes from a decimal degree point. | === Parameters === ^ Name ^ Type ^ Description ^ | point | Feature<!– ThinkGeo.MapSuite.Core.Feature –> | The feature you want to convert. | | decimals | Int32<!– System.Int32 –> | Number of decimals for the Minutes value | <!– ThinkGeo.MapSuite.Core.DecimalDegreesHelper –> Go Back ==== GetDegreesMinutesStringFromDecimalDegreePoint(PointShape, Int32) ==== <!– static –> This method returns a string representation in degrees and minutes from a decimal degree point. === Overloads === This overload allows you to pass in a point shape to be converted. === Return Value === ^ Return Type ^ Description ^ | String<!– System.String –> | This method returns a string representation in degrees and minutes from a decimal degree point. | === Parameters === ^ Name ^ Type ^ Description ^ | pointShape | PointShape<!– ThinkGeo.MapSuite.Core.PointShape –> | | | decimals | Int32<!– System.Int32 –> | Number of decimals for the Minutes value | <!– ThinkGeo.MapSuite.Core.DecimalDegreesHelper –> Go Back ==== GetDegreesMinutesStringFromDecimalDegreePoint(PointShape) ==== <!– static –> This method returns a string representation in degrees and minutes from a decimal degree point. === Overloads === This overload allows you to pass in a point shape to be converted. === Return Value === ^ Return Type ^ Description ^ | String<!– System.String –> | This method returns a string representation in degrees and minutes from a decimal degree point. | === Parameters === ^ Name ^ Type ^ Description ^ | pointShape | PointShape<!– ThinkGeo.MapSuite.Core.PointShape –> | | <!– ThinkGeo.MapSuite.Core.DecimalDegreesHelper –> Go Back ==== GetDegreesMinutesStringFromDecimalDegreePoint(Feature) ==== <!– static –> This method returns a string representation in degrees and minutes from a decimal degree point. === Overloads === This overload allows you to pass in a point shape to be converted. === Return Value === ^ Return Type ^ Description ^ | String<!– System.String –> | This method returns a string representation in degrees and minutes from a decimal degree point. | === Parameters === ^ Name ^ Type ^ Description ^ | point | Feature<!– ThinkGeo.MapSuite.Core.Feature –> | The point you want to convert. | <!– ThinkGeo.MapSuite.Core.DecimalDegreesHelper –> Go Back ==== GetDistanceFromDecimalDegrees(Feature, Feature, DistanceUnit) ==== <!– static –> This method returns the distance between two decimal degree points. === Overloads === This overload allows you to pass in two point shapes. === Return Value === ^ Return Type ^ Description ^ | Double<!– System.Double –> | This method returns the distance between two decimal degree points in the unit specified by the returningUnit parameter. | === Parameters === ^ Name ^ Type ^ Description ^ | fromPointFeature | Feature<!– ThinkGeo.MapSuite.Core.Feature –> | The feature you will measure from. | | toPointFeature | Feature<!– ThinkGeo.MapSuite.Core.Feature –> | The feature you will measure to. | | returningUnit | DistanceUnit<!– ThinkGeo.MapSuite.Core.DistanceUnit –> | The unit you would like your results back in, such as miles or kilometers. | <!– ThinkGeo.MapSuite.Core.DecimalDegreesHelper –> Go Back ==== GetDistanceFromDecimalDegrees(Double, Double, Double, Double, DistanceUnit) ==== <!– static –> This method returns the distance between two decimal degree points. === Overloads === This overload allows you to pass in the from and to latitude and longitude values. === Return Value === ^ Return Type ^ Description ^ | Double<!– System.Double –> | This method returns the distance between two decimal degree points in the unit specified by the returningUnit parameter. | === Parameters === ^ Name ^ Type ^ Description ^ | fromLongitude | Double<!– System.Double –> | This is the from longitude value. | | fromLatitude | Double<!– System.Double –> | This is the from latitude value. | | toLongitude | Double<!– System.Double –> | This is the to longitude value. | | toLatitude | Double<!– System.Double –> | This is the to latitude value. | | returningUnit | DistanceUnit<!– ThinkGeo.MapSuite.Core.DistanceUnit –> | 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. | <!– ThinkGeo.MapSuite.Core.DecimalDegreesHelper –> Go Back ==== GetDistanceFromDecimalDegrees(PointShape, PointShape, DistanceUnit) ==== <!– static –> This method returns the distance between two decimal degree points. === Overloads === This overload allows you to pass in two point shapes. === Return Value === ^ Return Type ^ Description ^ | Double<!– System.Double –> | This method returns the distance between two decimal degree points in the unit specified by the returningUnit parameter. | === Parameters === ^ Name ^ Type ^ Description ^ | fromPoint | PointShape<!– ThinkGeo.MapSuite.Core.PointShape –> | The point shape you will measure from. | | toPoint | PointShape<!– ThinkGeo.MapSuite.Core.PointShape –> | The point shape you will measure to. | | returningUnit | DistanceUnit<!– ThinkGeo.MapSuite.Core.DistanceUnit –> | The unit you would like your results back in, such as miles or kilometers. | <!– ThinkGeo.MapSuite.Core.DecimalDegreesHelper –> Go Back ==== GetHashCode() ==== === Return Value === ^ Return Type ^ Description ^ | Int32<!– System.Int32 –> | | === Parameters === ^ Name ^ Type ^ Description ^ <!– System.Object –> Go Back ==== GetLatitudeDifferenceFromDistance(Double, DistanceUnit) ==== <!– static –> Calculate the amount of longitude change given a certain distance and longitude. === Return Value === ^ Return Type ^ Description ^ | Double<!– System.Double –> | Double representing the distance. | === Parameters === ^ Name ^ Type ^ Description ^ | distance | Double<!– System.Double –> | The distance over which you would like to know the change in longitude. | | distanceUnit | DistanceUnit<!– ThinkGeo.MapSuite.Core.DistanceUnit –> | The unit the distance is in, such as miles or kilometers. | <!– ThinkGeo.MapSuite.Core.DecimalDegreesHelper –> Go Back ==== GetLongitudeDifferenceFromDistance(Double, DistanceUnit, Double) ==== <!– static –> Calculate the amount of longitude change given a certain distance and latitude. === Return Value === ^ Return Type ^ Description ^ | Double<!– System.Double –> | Double representing the distance. | === Parameters === ^ Name ^ Type ^ Description ^ | distance | Double<!– System.Double –> | The distance over which you would like to know the change in longitude. | | distanceUnit | DistanceUnit<!– ThinkGeo.MapSuite.Core.DistanceUnit –> | The unit the distance is in, such as miles or kilometers. | | latitude | Double<!– System.Double –> | The latitude on the globe that the distance is measured at. | <!– ThinkGeo.MapSuite.Core.DecimalDegreesHelper –> Go Back ==== GetType() ==== === Return Value === ^ Return Type ^ Description ^ | Type<!– System.Type –> | | === Parameters === ^ Name ^ Type ^ Description ^ <!– System.Object –> Go Back ==== ToString() ==== === Return Value === ^ Return Type ^ Description ^ | String<!– System.String –> | | === Parameters === ^ Name ^ Type ^ Description ^ <!– System.Object –> Go Back ===== Protected Methods ===== ==== Finalize() ==== === Return Value === ^ Return Type ^ Description ^ | Void<!– System.Void –> | | === Parameters === ^ Name ^ Type ^ Description ^ <!– System.Object –> Go Back ==== MemberwiseClone() ==== === Return Value === ^ Return Type ^ Description ^ | Object<!– System.Object –> | | === Parameters === ^ Name ^ Type ^ Description ^ <!– System.Object –> Go Back ===== Public Properties ===== ===== Protected Properties ===== ===== Public Events ===== NOTOC MapSuiteCore ThinkGeo.MapSuite.Core UpdateDocumentation

thinkgeo.mapsuite.core.decimaldegreeshelper.1440040128.txt.gz · Last modified: 2015/09/17 08:58 (external edit)