Class UTMCoord


  • public class UTMCoord
    extends java.lang.Object
    This immutable class holds a set of UTM coordinates along with it's corresponding latitude and longitude.
    • Constructor Detail

      • UTMCoord

        public UTMCoord​(double latitude,
                        double longitude,
                        int zone,
                        Hemisphere hemisphere,
                        double easting,
                        double northing)
        Create an arbitrary set of UTM coordinates with the given values.
        Parameters:
        latitude - the latitude double.
        longitude - the longitude double.
        zone - the UTM zone - 1 to 60.
        hemisphere - the hemisphere, either Hemisphere.N of Hemisphere.S.
        easting - the easting distance in meters
        northing - the northing distance in meters.
        Throws:
        java.lang.IllegalArgumentException - if latitude or longitude is null.
    • Method Detail

      • fromLatLon

        public static UTMCoord fromLatLon​(double latitude,
                                          double longitude)
        Create a set of UTM coordinates from a pair of latitude and longitude for the given Globe.
        Parameters:
        latitude - the latitude double.
        longitude - the longitude double.
        Returns:
        the corresponding UTMCoord.
        Throws:
        java.lang.IllegalArgumentException - if latitude or longitude is null, or the conversion to UTM coordinates fails.
      • fromUTM

        public static UTMCoord fromUTM​(int zone,
                                       Hemisphere hemisphere,
                                       double easting,
                                       double northing)
        Create a set of UTM coordinates for the given Globe.
        Parameters:
        zone - the UTM zone - 1 to 60.
        hemisphere - the hemisphere, either Hemisphere.N of Hemisphere.S.
        easting - the easting distance in meters
        northing - the northing distance in meters.
        Returns:
        the corresponding UTMCoord.
        Throws:
        java.lang.IllegalArgumentException - if the conversion to UTM coordinates fails.
      • getLatitude

        public double getLatitude()
      • getLongitude

        public double getLongitude()
      • getZone

        public int getZone()
      • getHemisphere

        public Hemisphere getHemisphere()
      • getEasting

        public double getEasting()
      • getNorthing

        public double getNorthing()
      • toString

        @NonNull
        public java.lang.String toString()
        Overrides:
        toString in class java.lang.Object