====== ThinkGeo.MapSuite.WindowsPhoneCore.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.WindowsPhoneCore.DecimalDegreesHelper]] ===== Members Summary ===== ==== Public Constructors ==== ^ Name ^ Parameters ^ DeclaringType ^ Summary ^ ==== Protected Constructors ==== ^ Name ^ Parameters ^ DeclaringType ^ Summary ^ ==== Public Methods ==== ^ Name ^ Parameters ^ DeclaringType ^ Summary ^ | {{wiki:PublicMethod.gif|Public Method}}[[#Equals(Object)|Equals]] | Object | Object | | | {{wiki:PublicMethod.gif|Public Method}}{{wiki:Static.gif|Static Member}}[[#GetDecimalDegreeFromDegreesMinutesSeconds(String)|GetDecimalDegreeFromDegreesMinutesSeconds]] | String | | This method returns a decimal degree value based on a string containing degrees, minutes, and seconds. | | {{wiki:PublicMethod.gif|Public Method}}{{wiki:Static.gif|Static Member}}[[#GetDecimalDegreeFromDegreesMinutesSeconds(DegreesMinutesSeconds)|GetDecimalDegreeFromDegreesMinutesSeconds]] | [[ThinkGeo.MapSuite.WindowsPhoneCore.DegreesMinutesSeconds|DegreesMinutesSeconds]] | | This method returns a decimal degree value based on a degree, minute and second structure. | | {{wiki:PublicMethod.gif|Public Method}}{{wiki:Static.gif|Static Member}}[[#GetDecimalDegreeFromDegreesMinutesSeconds(Int32, Int32, Double)|GetDecimalDegreeFromDegreesMinutesSeconds]] | Int32, Int32, Double | | This method returns a decimal degree value based on a set of degrees, minutes, and seconds. | | {{wiki:PublicMethod.gif|Public Method}}{{wiki:Static.gif|Static Member}}[[#GetDegreesMinutesSecondsFromDecimalDegree(Double)|GetDegreesMinutesSecondsFromDecimalDegree]] | Double | | This method returns a degrees, minutes and seconds structure from a decimal degree value. | | {{wiki:PublicMethod.gif|Public Method}}{{wiki:Static.gif|Static Member}}[[#GetDegreesMinutesSecondsStringFromDecimalDegree(Double, Int32)|GetDegreesMinutesSecondsStringFromDecimalDegree]] | Double, Int32 | | This method returns a string representation in degrees, minutes and seconds from a decimal degree value and a specified precision. | | {{wiki:PublicMethod.gif|Public Method}}{{wiki:Static.gif|Static Member}}[[#GetDegreesMinutesSecondsStringFromDecimalDegree(Double)|GetDegreesMinutesSecondsStringFromDecimalDegree]] | Double | | This method returns a string representation in degrees, minutes and seconds from a decimal degree value. | | {{wiki:PublicMethod.gif|Public Method}}{{wiki:Static.gif|Static Member}}[[#GetDegreesMinutesSecondsStringFromDecimalDegreePoint(Feature, Int32)|GetDegreesMinutesSecondsStringFromDecimalDegreePoint]] | [[ThinkGeo.MapSuite.WindowsPhoneCore.Feature|Feature]], Int32 | | This method returns a string representation in degrees, minutes and seconds from a decimal degree value. | | {{wiki:PublicMethod.gif|Public Method}}{{wiki:Static.gif|Static Member}}[[#GetDegreesMinutesSecondsStringFromDecimalDegreePoint(Feature)|GetDegreesMinutesSecondsStringFromDecimalDegreePoint]] | [[ThinkGeo.MapSuite.WindowsPhoneCore.Feature|Feature]] | | This method returns a string representation in degrees, minutes and seconds from a decimal degree value. | | {{wiki:PublicMethod.gif|Public Method}}{{wiki:Static.gif|Static Member}}[[#GetDegreesMinutesSecondsStringFromDecimalDegreePoint(PointShape, Int32)|GetDegreesMinutesSecondsStringFromDecimalDegreePoint]] | [[ThinkGeo.MapSuite.WindowsPhoneCore.PointShape|PointShape]], Int32 | | This method returns a string representation in degrees, minutes and seconds from a decimal degree value. | | {{wiki:PublicMethod.gif|Public Method}}{{wiki:Static.gif|Static Member}}[[#GetDegreesMinutesSecondsStringFromDecimalDegreePoint(PointShape)|GetDegreesMinutesSecondsStringFromDecimalDegreePoint]] | [[ThinkGeo.MapSuite.WindowsPhoneCore.PointShape|PointShape]] | | This method returns a string representation in degrees, minutes and seconds from a decimal degree value. | | {{wiki:PublicMethod.gif|Public Method}}{{wiki:Static.gif|Static Member}}[[#GetDistanceFromDecimalDegrees(Double, Double, Double, Double, DistanceUnit)|GetDistanceFromDecimalDegrees]] | Double, Double, Double, Double, [[ThinkGeo.MapSuite.WindowsPhoneCore.DistanceUnit|DistanceUnit]] | | This method returns the distance between two decimal degree points. | | {{wiki:PublicMethod.gif|Public Method}}{{wiki:Static.gif|Static Member}}[[#GetDistanceFromDecimalDegrees(PointShape, PointShape, DistanceUnit)|GetDistanceFromDecimalDegrees]] | [[ThinkGeo.MapSuite.WindowsPhoneCore.PointShape|PointShape]], [[ThinkGeo.MapSuite.WindowsPhoneCore.PointShape|PointShape]], [[ThinkGeo.MapSuite.WindowsPhoneCore.DistanceUnit|DistanceUnit]] | | This method returns the distance between two decimal degree points. | | {{wiki:PublicMethod.gif|Public Method}}{{wiki:Static.gif|Static Member}}[[#GetDistanceFromDecimalDegrees(Feature, Feature, DistanceUnit)|GetDistanceFromDecimalDegrees]] | [[ThinkGeo.MapSuite.WindowsPhoneCore.Feature|Feature]], [[ThinkGeo.MapSuite.WindowsPhoneCore.Feature|Feature]], [[ThinkGeo.MapSuite.WindowsPhoneCore.DistanceUnit|DistanceUnit]] | | This method returns the distance between two decimal degree points. | | {{wiki:PublicMethod.gif|Public Method}}[[#GetHashCode()|GetHashCode]] | | Object | | | {{wiki:PublicMethod.gif|Public Method}}{{wiki:Static.gif|Static Member}}[[#GetLatitudeDifferenceFromDistance(Double, DistanceUnit, Double)|GetLatitudeDifferenceFromDistance]] | Double, [[ThinkGeo.MapSuite.WindowsPhoneCore.DistanceUnit|DistanceUnit]], Double | | Calculate the amount of longitude change given a certain distance and longitude. | | {{wiki:PublicMethod.gif|Public Method}}{{wiki:Static.gif|Static Member}}[[#GetLongitudeDifferenceFromDistance(Double, DistanceUnit, Double)|GetLongitudeDifferenceFromDistance]] | Double, [[ThinkGeo.MapSuite.WindowsPhoneCore.DistanceUnit|DistanceUnit]], Double | | Calculate the amount of longitude change given a certain distance and latitude. | | {{wiki:PublicMethod.gif|Public Method}}[[#GetType()|GetType]] | | Object | | | {{wiki:PublicMethod.gif|Public Method}}[[#ToString()|ToString]] | | Object | | ==== Protected Methods ==== ^ Name ^ Parameters ^ DeclaringType ^ Summary ^ | {{wiki:ProtectedMethod.gif|Protected Method}}[[#Finalize()|Finalize]] | | Object | | | {{wiki:ProtectedMethod.gif|Protected Method}}[[#MemberwiseClone()|MemberwiseClone]] | | 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 ===== ==== Equals(Object) ==== === Return Value === ^ Return Type ^ Description ^ | Boolean | | === Parameters === ^ Name ^ Type ^ Description ^ | obj | Object | | [[#Public Methods|Go Back]] ==== 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 === ^ Return Type ^ Description ^ | Double | This method returns a decimal degree value based on a string containing degrees, minutes, and seconds. | === Parameters === ^ Name ^ Type ^ Description ^ | degreesMinutesSeconds | String | This parameter represents the degrees, minutes and seconds in a string. | [[#Public Methods|Go Back]] ==== 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 === ^ Return Type ^ Description ^ | Double | This method returns a decimal degree value based on a degree, minute and second structure. | === Parameters === ^ Name ^ Type ^ Description ^ | degreesMinutesSeconds | [[ThinkGeo.MapSuite.WindowsPhoneCore.DegreesMinutesSeconds|DegreesMinutesSeconds]] | This structure represents the degrees, minutes and seconds. | [[#Public Methods|Go Back]] ==== 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 === ^ Return Type ^ Description ^ | Double | This method returns a decimal degree value based on a set of degrees, minutes, and seconds. | === Parameters === ^ Name ^ Type ^ Description ^ | degrees | Int32 | This parameter represents the degree component of the degrees, minutes and seconds. | | minutes | Int32 | This parameter represents the minute component of the degrees, minutes and seconds. | | seconds | Double | This parameter represents the second component of the degrees, minutes and seconds. | [[#Public Methods|Go Back]] ==== 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 === ^ Return Type ^ Description ^ | [[ThinkGeo.MapSuite.WindowsPhoneCore.DegreesMinutesSeconds|DegreesMinutesSeconds]] | This method returns a degrees, minutes and seconds structure from a decimal degree value. | === Parameters === ^ Name ^ Type ^ Description ^ | decimalDegreesValue | Double | The decimal degree value you want to convert. | [[#Public Methods|Go Back]] ==== GetDegreesMinutesSecondsStringFromDecimalDegree(Double, Int32) ==== 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 | This method returns a string representation in degrees, minutes and seconds from a decimal degree value. | === Parameters === ^ Name ^ Type ^ Description ^ | decimalDegreesValue | Double | The number of decimal degree to convert. | | decimals | Int32 | The number of float decision for the second. | [[#Public Methods|Go Back]] ==== GetDegreesMinutesSecondsStringFromDecimalDegree(Double) ==== 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 | This method returns a string representation in degrees, minutes and seconds from a decimal degree value. | === Parameters === ^ Name ^ Type ^ Description ^ | decimalDegreesValue | Double | The number of decimal degrees to convert. | [[#Public Methods|Go Back]] ==== GetDegreesMinutesSecondsStringFromDecimalDegreePoint(Feature, Int32) ==== 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 | This method returns a string representation in degrees, minutes and seconds from a decimal degree value. | === Parameters === ^ Name ^ Type ^ Description ^ | point | [[ThinkGeo.MapSuite.WindowsPhoneCore.Feature|Feature]] | The feature whose decimal degrees to convert. | | decimalPlaces | Int32 | The number of decimal degree to convert. | [[#Public Methods|Go Back]] ==== GetDegreesMinutesSecondsStringFromDecimalDegreePoint(Feature) ==== 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 | This method returns a string representation in degrees, minutes and seconds from a decimal degree value. | === Parameters === ^ Name ^ Type ^ Description ^ | point | [[ThinkGeo.MapSuite.WindowsPhoneCore.Feature|Feature]] | The feature whose decimal degrees to convert. | [[#Public Methods|Go Back]] ==== GetDegreesMinutesSecondsStringFromDecimalDegreePoint(PointShape, Int32) ==== 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 | This method returns a string representation in degrees, minutes and seconds from a decimal degree value. | === Parameters === ^ Name ^ Type ^ Description ^ | pointShape | [[ThinkGeo.MapSuite.WindowsPhoneCore.PointShape|PointShape]] | The point of decimal degree to convert. | | decimals | Int32 | The number of decimal degree to convert. | [[#Public Methods|Go Back]] ==== GetDegreesMinutesSecondsStringFromDecimalDegreePoint(PointShape) ==== 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' 29//E 36º 20' 42//N". === Return Value === ^ Return Type ^ Description ^ | String | This method returns a string representation in degrees, minutes and seconds from a decimal degree value. | === Parameters === ^ Name ^ Type ^ Description ^ | pointShape | [[ThinkGeo.MapSuite.WindowsPhoneCore.PointShape|PointShape]] | The point you want to convert. | [[#Public Methods|Go Back]] ==== GetDistanceFromDecimalDegrees(Double, Double, Double, Double, DistanceUnit) ==== 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 | This method returns the distance between two decimal degree points in the unit specified by the returningUnit parameter. | === Parameters === ^ Name ^ Type ^ Description ^ | fromLongitude | Double | This is the from longitude value. | | fromLatitude | Double | This is the from latitude value. | | toLongitude | Double | This is the to longitude value. | | toLatitude | Double | This is the to latitude value. | | returningUnit | [[ThinkGeo.MapSuite.WindowsPhoneCore.DistanceUnit|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. | [[#Public Methods|Go Back]] ==== GetDistanceFromDecimalDegrees(PointShape, PointShape, DistanceUnit) ==== 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 | This method returns the distance between two decimal degree points in the unit specified by the returningUnit parameter. | === Parameters === ^ Name ^ Type ^ Description ^ | fromPoint | [[ThinkGeo.MapSuite.WindowsPhoneCore.PointShape|PointShape]] | The point shape you will measure from. | | toPoint | [[ThinkGeo.MapSuite.WindowsPhoneCore.PointShape|PointShape]] | The point shape you will measure to. | | returningUnit | [[ThinkGeo.MapSuite.WindowsPhoneCore.DistanceUnit|DistanceUnit]] | The unit you would like your results back in, such as miles or kilometers. | [[#Public Methods|Go Back]] ==== GetDistanceFromDecimalDegrees(Feature, Feature, DistanceUnit) ==== 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 | This method returns the distance between two decimal degree points in the unit specified by the returningUnit parameter. | === Parameters === ^ Name ^ Type ^ Description ^ | fromPointFeature | [[ThinkGeo.MapSuite.WindowsPhoneCore.Feature|Feature]] | The feature you will measure from. | | toPointFeature | [[ThinkGeo.MapSuite.WindowsPhoneCore.Feature|Feature]] | The feature you will measure to. | | returningUnit | [[ThinkGeo.MapSuite.WindowsPhoneCore.DistanceUnit|DistanceUnit]] | The unit you would like your results back in, such as miles or kilometers. | [[#Public Methods|Go Back]] ==== GetHashCode() ==== === Return Value === ^ Return Type ^ Description ^ | Int32 | | === Parameters === ^ Name ^ Type ^ Description ^ [[#Public Methods|Go Back]] ==== GetLatitudeDifferenceFromDistance(Double, DistanceUnit, Double) ==== Calculate the amount of longitude change given a certain distance and longitude. === Return Value === ^ Return Type ^ Description ^ | Double | Double representing the distance. | === Parameters === ^ Name ^ Type ^ Description ^ | distance | Double | The distance over which you would like to know the change in longitude. | | distanceUnit | [[ThinkGeo.MapSuite.WindowsPhoneCore.DistanceUnit|DistanceUnit]] | The unit the distance is in, such as miles or kilometers. | | longitude | Double | The longitude on the globe that the distance is measured at. | [[#Public Methods|Go Back]] ==== GetLongitudeDifferenceFromDistance(Double, DistanceUnit, Double) ==== Calculate the amount of longitude change given a certain distance and latitude. === Return Value === ^ Return Type ^ Description ^ | Double | Double representing the distance. | === Parameters === ^ Name ^ Type ^ Description ^ | distance | Double | The distance over which you would like to know the change in longitude. | | distanceUnit | [[ThinkGeo.MapSuite.WindowsPhoneCore.DistanceUnit|DistanceUnit]] | The unit the distance is in, such as miles or kilometers. | | latitude | Double | The latitude on the globe that the distance is measured at. | [[#Public Methods|Go Back]] ==== GetType() ==== === Return Value === ^ Return Type ^ Description ^ | Type | | === Parameters === ^ Name ^ Type ^ Description ^ [[#Public Methods|Go Back]] ==== ToString() ==== === Return Value === ^ Return Type ^ Description ^ | String | | === Parameters === ^ Name ^ Type ^ Description ^ [[#Public Methods|Go Back]] ===== Protected Methods ===== ==== Finalize() ==== === Return Value === ^ Return Type ^ Description ^ | Void | | === Parameters === ^ Name ^ Type ^ Description ^ [[#Protected Methods|Go Back]] ==== MemberwiseClone() ==== === Return Value === ^ Return Type ^ Description ^ | Object | | === Parameters === ^ Name ^ Type ^ Description ^ [[#Protected Methods|Go Back]] ===== Public Properties ===== ===== Protected Properties ===== ===== Public Events ===== __NOTOC__ [[Category:WindowsPhoneMapSuiteCore]] [[Category:ThinkGeo.MapSuite.WindowsPhoneCore]] [[Category:UpdateDocumentation]]