Skip navigation links
com.supermap.data

Class GeoCoordSys

  • java.lang.Object
    • com.supermap.data.GeoCoordSys

  • public class GeoCoordSys
extends java.lang.Object
    The GeoCoordSys class.

    The geographic coordinate system is composed of Datum, Central Meridian and an angular unit of measure. In GIS, the unit can be degrees, minutes or seconds. The horizontal direction ranges from -180 to 180. The vertical direction ranges from -90 to 90.

    Geographic coordinate uses the longitude and latitude values to refer the position of a point on the earth. The meridians and parallels are usually expressed by degree (or dd mm ss in necessary). The Lon/Lat is expressed through the angle from the Earth's center to the related position in surface. In sphere system, the horizontal parallels are used to express the east and west which also can be named as parallels; and the vertical parallels are used to express the north and south which also can be named as meridians. These grids around the Earth are named as fictitious graticule. The Lon/Lat is expressed through the angle from the Earth's center to the related position in surface.

    • Constructor Detail

      • GeoCoordSys

        public GeoCoordSys()
        Constructs a new GeoCoordSys object.

      • GeoCoordSys

        public GeoCoordSys(GeoCoordSysType type,
                   GeoSpatialRefType spatialRefType)
        Creates a new GeoCoordSys object according to the specified arguments.
        Parameters:
        type - The type of the geographic coordinate system.
        spatialRefType - The type of the spatial reference system. There are three types, they are the planar coordinate system, the geographic coordinate system and the projected coordinate system.

      • GeoCoordSys

        public GeoCoordSys(GeoDatum geoDatum,
                   GeoPrimeMeridian geoPrimeMeridian,
                   GeoSpatialRefType spatialRefType,
                   Unit unit,
                   java.lang.String name)
        Creates a new GeoCoordSys object according to the specified arguments.
        Parameters:
        geoDatum - The spheroid reference datum of the geographic coordinate system.
        geoPrimeMeridian - The central meridian of the geographic coordinate system.
        spatialRefType - The type of the spatial reference system.
        unit - the coordinate unit.
        name - The name of the geographic coordinate system.

      • GeoCoordSys

        public GeoCoordSys(GeoCoordSys geoCoordSys)
        Constructs a new object identical to the given GeoCoordSysobject.
        Parameters:
        geoCoordSys - the specified GeoCoordSys object.

    • Method Detail

      • getName

        public java.lang.String getName()
        Returns the name of the geoCoordSys object.
        Returns:
        the name of the geoCoordSys object.
        Default:
        The default value is"GCS_WGS_1984" .

      • setName

        public void setName(java.lang.String value)
        Sets the name of the geographic coordinate system.
        Parameters:
        value - the name of the geoCoordSys object.

      • getType

        public GeoCoordSysType getType()
        Returns the type of the geographic coordinate system.

        When the geographic coordinate system is defined by user. Users are required to specify datum and central meridian; other values are predefined by SuperMap Objects .Java, users do not need to specify the major radius and flattening of ellipsoid. The units of the geographic coordinate can be degree, minute or second. About the type of the geographic coordinate system, refer to GeoCoordSysType.

        Returns:
        The type of the geographic coordinate system.
        Default:
        The default value is GCS_USER_DEFINE.

      • setType

        public void setType(GeoCoordSysType value)
        Sets the type of the geographic coordinate system.

        When the geographic coordinate system is defined by user. Users are required to specify datum and central meridian; other values are predefined by SuperMap Objects .Java, users do not need to specify the major radius and flattening of ellipsoid. The units of the geographic coordinate can be degree, minute or second. About the type of the geographic coordinate system, refer to GeoCoordSysType.

        Parameters:
        value - The type of the geographic coordinate system.

      • setGeoSpatialRefType

        public void setGeoSpatialRefType(GeoSpatialRefType value)
        Sets the type of the spatial reference system.
        Parameters:
        value - the type of the geographic coordinate system.

      • getGeoDatum

        public GeoDatum getGeoDatum()
        Returns the GeoDatum object.
        Returns:
        the GeoDatum object.
        Default:
        The default value is an empty GeoDatum object.

      • setGeoDatum

        public void setGeoDatum(GeoDatum value)
        Sets the GeoDatum object.
        Parameters:
        value - the GeoDatum object.

      • getGeoPrimeMeridian

        public GeoPrimeMeridian getGeoPrimeMeridian()
        Returns the PrimeMeridian object.
        Returns:
        the PrimeMeridian object.
        Default:
        The default value is an empty GeoPrimeMeridian object.

      • setGeoPrimeMeridian

        public void setGeoPrimeMeridian(GeoPrimeMeridian value)
        Sets the PrimeMeridian object.
        Parameters:
        value - the PrimeMeridian object.

      • getCoordUnit

        public Unit getCoordUnit()
        Returns the unit of the geographic coordinate system.
        Returns:
        the unit of the geographic coordinate system. The default value is DEGREE.

      • setCoordUnit

        public void setCoordUnit(Unit value)
        Sets the units of the geographic coordinate system.
        Parameters:
        value - the unit of the geographic coordinate system.

      • fromXML

        public boolean fromXML(java.lang.String xml)
        Retrieves the GeoCoordSys object with the introduced XML string. Returns true if successful.
        Parameters:
        xml - The specified XML string.
        Returns:
        Returns true, if successful; otherwise, false.

      • toXML

        public java.lang.String toXML()
        Exports the XML string represents the GeoCoordSys object.
        Returns:
        the XML string represents the GeoCoordSys object.

      • dispose

        public void dispose()
        Disposes the resources occupied by the object. After calling this method, this object will not be usable.

      • clone

        public GeoCoordSys clone()
        Perform clone for GeoCoorSys
        Overrides:
        clone in class java.lang.Object
        Returns:
        The clone object of GeoPrimeMeridian
Skip navigation links