agi.foundation.coordinates

(agi.foundation.core-2025r1.jar)

Class UniversalTransverseMercator

java.lang.Object

agi.foundation.coordinates.UniversalTransverseMercator

All Implemented Interfaces:

IEquatable<UniversalTransverseMercator>, ImmutableValueType, ValueType, IEquatableEpsilon<UniversalTransverseMercator>

public final class UniversalTransverseMercator
extends Object
implements IEquatable<UniversalTransverseMercator>, IEquatableEpsilon<UniversalTransverseMercator>, ImmutableValueType

A set of coordinates for specifying locations on the Earth based on a grid of longitude zones as outlined in Defense Mapping Agency Technical Manual (DMA TM) 8358.2, "The Universal Grids: Universal Transverse Mercator (UTM) and Universal Polar Stereographic (UPS)", Edition 1, 18 September 1989.

See Also:

MilitaryGridReferenceSystem, UniversalPolarStereographic

Constructor Summary

Constructors

Constructor and Description
UniversalTransverseMercator() Initializes a new instance.
UniversalTransverseMercator(int zone, PoleIndicator hemisphere, double easting, double northing) Initializes a set of UniversalTransverseMercator coordinates from the provided values.

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object obj) Indicates whether another object is exactly equal to this instance.
static boolean	equals(UniversalTransverseMercator left, UniversalTransverseMercator right) Returns true if the two instances are exactly equal.
boolean	equalsEpsilon(UniversalTransverseMercator other, double epsilon) Indicates whether each coordinate value of another instance of this type is within the required tolerance of the corresponding coordinate value of this instance.
boolean	equalsType(UniversalTransverseMercator other) Indicates whether another instance of this type is exactly equal to this instance.
double	getEasting() Gets the eastward distance of the location into the zone.
PoleIndicator	getHemisphere() Gets the hemisphere of the coordinates.
boolean	getIsUndefined() Gets a value indicating whether or not the Easting (get) and Northing (get) coordinates for this instance have the value Double.NaN, the Zone (get) is not in the correct range, or the Hemisphere (get) is invalid.
double	getNorthing() Gets the northward distance of the location into the zone.
static UniversalTransverseMercator	getUndefined() Gets a set of UniversalTransverseMercator coordinates with Easting (get) and Northing (get) values of Double.NaN, Zone (get) 0, and Hemisphere (get) 0.
int	getZone() Gets the longitude zone of the location.
int	hashCode() Returns a hash code for this instance, which is suitable for use in hashing algorithms and data structures like a hash table.
static boolean	notEquals(UniversalTransverseMercator left, UniversalTransverseMercator right) Returns true if the two instances are not exactly equal.
String	toString() Returns the string representation of the value of this instance.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

UniversalTransverseMercator

public UniversalTransverseMercator()

Initializes a new instance.

UniversalTransverseMercator

public UniversalTransverseMercator(int zone,
                                   @Nonnull
                                   PoleIndicator hemisphere,
                                   double easting,
                                   double northing)

Initializes a set of UniversalTransverseMercator coordinates from the provided values.

Parameters:

zone - The longitude zone indicator.

hemisphere - The hemisphere indicator.

easting - The eastward distance of the location into the zone.

northing - The northward distance of the location into the zone.

Method Detail

getUndefined

@Nonnull
public static UniversalTransverseMercator getUndefined()

Gets a set of UniversalTransverseMercator coordinates with Easting (get) and Northing (get) values of Double.NaN, Zone (get) 0, and Hemisphere (get) 0.

Use IsUndefined (get) to test whether a UniversalTransverseMercator instance is undefined since it will return true if the Easting (get) or Northing (get) values are Double.NaN, the Zone (get) is not in the correct range, or the Hemisphere (get) is invalid.

getZone

public final int getZone()

Gets the longitude zone of the location.

getHemisphere

@Nonnull
public final PoleIndicator getHemisphere()

Gets the hemisphere of the coordinates.

getEasting

public final double getEasting()

Gets the eastward distance of the location into the zone.

getNorthing

public final double getNorthing()

Gets the northward distance of the location into the zone.

equals

public boolean equals(Object obj)

Indicates whether another object is exactly equal to this instance.

Overrides:

equals in class Object

Parameters:

obj - The object to compare to this instance.

Returns:

true if obj is an instance of this type and represents the same value as this instance; otherwise false.

See Also:

Object.hashCode(), HashMap

equalsType

public final boolean equalsType(@Nonnull
                                UniversalTransverseMercator other)

Indicates whether another instance of this type is exactly equal to this instance.

Specified by:

equalsType in interface IEquatable<UniversalTransverseMercator>

Parameters:

other - The instance to compare to this instance.

Returns:

true if other represents the same value as this instance; otherwise false.

equalsEpsilon

public final boolean equalsEpsilon(@Nonnull
                                   UniversalTransverseMercator other,
                                   double epsilon)

Indicates whether each coordinate value of another instance of this type is within the required tolerance of the corresponding coordinate value of this instance.

Specified by:

equalsEpsilon in interface IEquatableEpsilon<UniversalTransverseMercator>

Parameters:

other - The set of UniversalTransverseMercator coordinates to compare to this instance.

epsilon - The limit at which the absolute differences between the coordinate values will not be considered equal.

Returns:

true if the absolute differences are less than or equal to epsilon; otherwise false.

hashCode

public int hashCode()

Returns a hash code for this instance, which is suitable for use in hashing algorithms and data structures like a hash table.

Overrides:

hashCode in class Object

Returns:

A hash code for the current object.

See Also:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

toString

public String toString()

Returns the string representation of the value of this instance.

Overrides:

toString in class Object

Returns:

A string that represents the value of this instance in the form "Zone, Hemisphere, Easting, Northing".

equals

public static boolean equals(@Nonnull
                             UniversalTransverseMercator left,
                             @Nonnull
                             UniversalTransverseMercator right)

Returns true if the two instances are exactly equal.

Parameters:

left - The instance to compare to right.

right - The instance to compare to left.

Returns:

true if left represents the same value as right; otherwise false.

notEquals

public static boolean notEquals(@Nonnull
                                UniversalTransverseMercator left,
                                @Nonnull
                                UniversalTransverseMercator right)

Returns true if the two instances are not exactly equal.

Parameters:

left - The instance to compare to right.

right - The instance to compare to left.

Returns:

true if left does not represent the same value as right; otherwise false.

getIsUndefined

public final boolean getIsUndefined()

Gets a value indicating whether or not the Easting (get) and Northing (get) coordinates for this instance have the value Double.NaN, the Zone (get) is not in the correct range, or the Hemisphere (get) is invalid.