Cartesian.ConvertGeodeticToCartesian(Double, Double, Double, Double, Double, Double, Double, Double, String) Method

Converts a Geodetic coordinate to a Cartesian coordinate on the user defined reference ellipsoid.

Parameters

semiMajorAxisAInM

a semi major axis A (in meters) of the user defined reference ellipsoid

inverseFlattening

an inverse flattening of the user defined reference ellipsoid

latInDeg

the latitude (in decimal degrees) of the original Geodetic coordinate

lonInDeg

the longitude (in decimal degrees) of the original Geodetic coordinate

hInM

the height (in meters) of the original Geodetic coordinate

xInM

X (in meters) of the final Cartesian coordinate, passed by reference (out)

yInM

Y (in meters) of the final Cartesian coordinate, passed by reference (out)

zInM

Z (in meters) of the final Cartesian coordinate, passed by reference (out)

errorMessage

an error message, passed by reference (out), that contains detailed error / warning information

Return Value

true - if the conversion succeeded, false - if the conversion failed

Remarks

The function verifies validity of the input arguments before running the conversion. The valid latitude is a real number in the range from -90.0 (inclusive) to 90.0 (inclusive). The valid longitude is a real number in the range from -180.0 (inclusive) to 180.0 (inclusive).

Example

This sample shows how to call the Cartesian.ConvertGeodeticToCartesian method from C# code:

 string errorMessage = String.Empty;
 
 double semiMajorAxisA = 6378137;
 double inverseFlattening = 298.257223563;

 double latInDeg = 38.889139;
 double lonInDeg = -77.049;
 double hInM = 100;
 
 double xInM = Double.NaN;
 double yInM = Double.NaN;
 double zInM = Double.NaN;

 if (Cartesian.ConvertGeodeticToCartesian(semiMajorAxisAInM, inverseFlattening, latInDeg, lonInDeg, hInM, out xInM, out yInM, out zInM, out errorMessage))
 {
     Console.WriteLine("Conversion succeeded.");
     Console.WriteLine("X, in m: " + xInM.ToString());
     Console.WriteLine("Y, in m: " + yInM.ToString());
     Console.WriteLine("Z, in m: " + zInM.ToString());
 }
 else
 {
     Console.WriteLine("Conversion failed. " + errorMessage);
 }
 

See Also

Cartesian Class | ApsGis Namespace | Cartesian.ConvertGeodeticToCartesian Overload List