Package uk.co.mccombe.mapping
Class Position
java.lang.Object
uk.co.mccombe.mapping.Position
A Position represents the absolute location of a point in 3D space, independent of
any particular Datum, Ellipsoid or type of coordinates. The nature of the internal
representation of this point is deliberately encapsulated and irrelevant. This class
does not override the
toString()
method because a Position needs to be
part of a CoordinateSystem
to have a meaningful String representation.
Instances of this class are immutable.
-
Constructor Summary
ConstructorsConstructorDescriptionCreate a new Position using Lat/Long relative to a specified Ellipsoid and DatumCreates a new instance of Position based on cartesian coordinates relative to the specified Datum. -
Method Summary
Modifier and TypeMethodDescriptionGet the cartesian coordinates of this Position relative to a specified Datumdouble
ellipsoidHeight
(Ellipsoid sphere, Datum datum) Calculate the height of this Position above the specified Ellipsoid.boolean
Compare this Position with another ObjectGet the LatLong of this Position relative to specified Ellipsoid and Datum
-
Constructor Details
-
Position
Creates a new instance of Position based on cartesian coordinates relative to the specified Datum.- Parameters:
point
- XYZ coordinates of this position relative to the specified Datumdatum
- The Datum used as the basis of the cartesian coordinates
-
Position
Create a new Position using Lat/Long relative to a specified Ellipsoid and Datum- Parameters:
geo
- LatLong of the pointellipsoidHeight
- Height above the Ellipsoid of this point (double)sphere
- The Ellipsoid against which this Lat and Lon are defineddatum
- The Datum used to measure the Lat and Lon
-
-
Method Details
-
coords
Get the cartesian coordinates of this Position relative to a specified Datum- Parameters:
datum
- The Datum against which to measure the Position- Returns:
- Cartesian (XYZ) coordinates of this Position
-
toLatLong
Get the LatLong of this Position relative to specified Ellipsoid and Datum- Parameters:
sphere
- The Ellipsoid to use as referencedatum
- The Datum to measure relative to- Returns:
- A LatLong object for this Position
-
ellipsoidHeight
Calculate the height of this Position above the specified Ellipsoid.- Parameters:
sphere
- The Ellipsoid from which to calculate the heightdatum
- The Datum defining the location of the Ellipsoid- Returns:
- The height in metres of this position above the Ellipsoid
-
equals
Compare this Position with another Object
-