Module org.arakhne.afc.gis.giscore
Package org.arakhne.afc.gis.coordinate

Enum MapMetricProjection

  • All Implemented Interfaces:
    Serializable, Comparable<MapMetricProjection>
    public enum MapMetricProjection
extends Enum<MapMetricProjection>
    This class defines the supported map metric projections in the GIS API.

    A map metric projection is any method of representing the surface of a sphere or other three-dimensional body on a plane. Map metric projections are necessary for creating maps. All map metric projections distort the surface in some fashion. Depending on the purpose of the map, some distortions are acceptable and others are not; therefore different map projections exist in order to preserve some properties of the sphere-like body at the expense of other properties. There is no limit to the number of possible map metric projections.

    Details on the algorithms are in NTG_71.pdf.

    Since:
    14.0
    Version:
    17.0 2020-01-04 14:41:53
    Author:
    Stéphane GALLAND
    See Also:
    "./doc-files/NTG_71.pdf"
    Maven Group Id:
    org.arakhne.afc.gis
    Maven Artifact Id:
    giscore

    • Enum Constant Detail

      • FRANCE_LAMBERT_2

        public static final MapMetricProjection FRANCE_LAMBERT_2
        France Lambert II.

      • FRANCE_LAMBERT_2_EXTENDED

        public static final MapMetricProjection FRANCE_LAMBERT_2_EXTENDED
        Extended France Lambert II.

      • FRANCE_LAMBERT_3

        public static final MapMetricProjection FRANCE_LAMBERT_3
        France Lambert III.

      • FRANCE_LAMBERT_4

        public static final MapMetricProjection FRANCE_LAMBERT_4
        France Lambert IV.

      • FRANCE_LAMBERT_93

        public static final MapMetricProjection FRANCE_LAMBERT_93
        France Lambert 93.

    • Method Detail

      • values

        public static MapMetricProjection[] values()
        Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows: 
        for (MapMetricProjection c : MapMetricProjection.values())
    System.out.println(c);
        Returns:
        an array containing the constants of this enum type, in the order they are declared

      • valueOf

        public static MapMetricProjection valueOf​(String name)
        Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)
        Parameters:
        name - the name of the enum constant to be returned.
        Returns:
        the enum constant with the specified name
        Throws:
        IllegalArgumentException - if this enum type has no constant with the specified name
        NullPointerException - if the argument is null

      • getDefault

        @Pure
public static MapMetricProjection getDefault()
        Replies the default map metric projection.
        Returns:
        the default projection, never null.

      • convertTo

        @Pure
public abstract Point2d convertTo​(MapMetricProjection newProjection,
                                  Point2D<?,​?> point)
        Convert the given point from the current map projection to the given map projection.
        Parameters:
        newProjection - is the target projection.
        point - is the point to convert in the current project.
        Returns:
        the point converted into the target projection; never null.

      • convertToGeodesicPosition

        @Pure
public abstract GeodesicPosition convertToGeodesicPosition​(Point2D<?,​?> point)
        Convert the given point in the current map projection into a GPS point.
        Parameters:
        point - is the point to convert.
        Returns:
        the GPS position.

      • convertFromGeodesicPosition

        @Pure
public abstract Point2d convertFromGeodesicPosition​(GeodesicPosition gpsPoint)
        Convert the given GPS point into a point in the current map projection.
        Parameters:
        gpsPoint - is the Geodesic point to convert.
        Returns:
        the projection position.