Class GeodeticCoordinate

java.lang.Object

org.episteme.natural.earth.coordinates.GeodeticCoordinate

All Implemented Interfaces:

GeometricObject<EarthCoordinate>, Positioned<EarthCoordinate>, EarthCoordinate

public class GeodeticCoordinate
extends Object
implements EarthCoordinate

Represents a point on the Earth defined by latitude, longitude, and height.

Since:

1.0

Author:

Silvere Martin-Michiellot, Gemini AI (Google DeepMind)

Constructor Summary

Constructors

Constructor	Description
GeodeticCoordinate(double latDeg, double lonDeg)	Creates a coordinate from latitude and longitude in degrees (height = 0).
GeodeticCoordinate(double latDeg, double lonDeg, double hMeters)
GeodeticCoordinate(Quantity<Angle> latitude, Quantity<Angle> longitude, Quantity<Length> height, ReferenceEllipsoid ellipsoid)

Method Summary

Modifier and Type	Method	Description
int	ambientDimension()	Returns the dimension of the ambient space containing this object.
String	description()	Returns a human-readable description of this geometric object.
int	dimension()	Returns the intrinsic dimension of this geometric object.
String	getCoordinateSystem()	Returns the coordinate system name (e.g., "WGS84", "UTM", "MGRS").
ReferenceEllipsoid	getEllipsoid()	Returns the reference ellipsoid used by this coordinate.
Quantity<Length>	getHeight()
Quantity<Angle>	getLatitude()
Quantity<Angle>	getLongitude()
Real	getPrimeVerticalRadius()	Calculates the internal radius of curvature in the prime vertical (N).
ECEFCoordinate	toECEF()	Converts to Earth-Centered, Earth-Fixed (ECEF) Cartesian coordinates.
GeodeticCoordinate	toGeodetic()	Converts this coordinate to geodetic (lat/lon/height) form.
String	toString()

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface EarthCoordinate

distanceTo, getPosition

Constructor Details

GeodeticCoordinate

public GeodeticCoordinate(Quantity<Angle> latitude,
 Quantity<Angle> longitude,
 Quantity<Length> height,
 ReferenceEllipsoid ellipsoid)

GeodeticCoordinate

public GeodeticCoordinate(double latDeg,
 double lonDeg,
 double hMeters)

GeodeticCoordinate

public GeodeticCoordinate(double latDeg,
 double lonDeg)

Creates a coordinate from latitude and longitude in degrees (height = 0).

Method Details

getLatitude

public Quantity<Angle> getLatitude()

getLongitude

public Quantity<Angle> getLongitude()

getHeight

public Quantity<Length> getHeight()

getEllipsoid

public ReferenceEllipsoid getEllipsoid()

Description copied from interface: EarthCoordinate

Returns the reference ellipsoid used by this coordinate.

Specified by:

getEllipsoid in interface EarthCoordinate

Returns:

the ellipsoid model

getPrimeVerticalRadius

public Real getPrimeVerticalRadius()

Calculates the internal radius of curvature in the prime vertical (N). N = a / sqrt(1 - e^2 * sin^2(phi))

Returns:

N as Real

toECEF

public ECEFCoordinate toECEF()

Converts to Earth-Centered, Earth-Fixed (ECEF) Cartesian coordinates. Uses Real for all intermediate products to prevent rounding drift.

Specified by:

toECEF in interface EarthCoordinate

Returns:

ECEFCoordinate [X, Y, Z]

getCoordinateSystem

public String getCoordinateSystem()

Description copied from interface: EarthCoordinate

Returns the coordinate system name (e.g., "WGS84", "UTM", "MGRS").

Specified by:

getCoordinateSystem in interface EarthCoordinate

Returns:

the coordinate system identifier

toGeodetic

public GeodeticCoordinate toGeodetic()

Description copied from interface: EarthCoordinate

Converts this coordinate to geodetic (lat/lon/height) form.

Specified by:

toGeodetic in interface EarthCoordinate

Returns:

the geodetic representation

dimension

public int dimension()

Description copied from interface: GeometricObject

Returns the intrinsic dimension of this geometric object.

Examples:

• Point: 0
• Line/Segment: 1
• Plane/Surface: 2
• Volume: 3

Specified by:

dimension in interface EarthCoordinate

Specified by:

dimension in interface GeometricObject<EarthCoordinate>

Returns:

the dimension

ambientDimension

public int ambientDimension()

Description copied from interface: GeometricObject

Returns the dimension of the ambient space containing this object.

For example, a 2D plane in 3D space has dimension=2 but ambientDimension=3.

Specified by:

ambientDimension in interface EarthCoordinate

Specified by:

ambientDimension in interface GeometricObject<EarthCoordinate>

Returns:

the ambient space dimension

description

public String description()

Description copied from interface: GeometricObject

Returns a human-readable description of this geometric object.

Specified by:

description in interface EarthCoordinate

Specified by:

description in interface GeometricObject<EarthCoordinate>

Returns:

description string

toString

public String toString()

Overrides:

toString in class Object