com.supermap.data

类 PrjCoordSys

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


  • public class PrjCoordSys
    extends java.lang.Object

    投影坐标系类。

    投影坐标系统由地图投影方式、投影参数、坐标单位和地理坐标系组成。SuperMap iMobile for Android 中提供了很多预定义的投影系统,用户可以直接使用,此外,用户还可以定制自己投影系统。

    投影坐标系是定义在二维平面上的,不同于地理坐标系用经纬度定位地面点,投影坐标系是用 X、Y 坐标来定位的。每一个投影坐标系都基于一个地理坐标系。

    • 构造器详细资料

      • PrjCoordSys

        public PrjCoordSys()
        构造一个新的 PrjCoordSys 对象。
      • PrjCoordSys

        public PrjCoordSys(int EPSGCode)
        构造一个新的 PrjCoordSys 对象。
      • PrjCoordSys

        public PrjCoordSys(PrjCoordSysType type)
        根据指定的参数来构造一个 PrjCoordSys 的新对象。
        参数:
        type - 投影坐标系类型。
      • PrjCoordSys

        public PrjCoordSys(GeoCoordSys geoCoordSys,
                           Projection projection,
                           PrjParameter prjParameter,
                           java.lang.String name)
        根据指定的参数来构造一个 PrjCoordSys 的新对象。
        参数:
        geoCoordSys - 投影坐标系所基于的地理坐标系。
        projection - 投影方式。投影方式如等角圆锥投影、等距方位投影等等。
        prjParameter - 投影参数。
        name - 投影坐标系名称。
      • PrjCoordSys

        public PrjCoordSys(PrjCoordSys prjCoordSys)
        根据给定的 PrjCoordSys 对象构造一个与其完全相同的新对象。
        参数:
        prjCoordSys - 指定的 PrjCoordSys 对象。
    • 方法详细资料

      • isSame

        public boolean isSame(PrjCoordSys prjCoordSys)
        左边是否相同
        参数:
        prjCoordSys - 投影坐标系
        返回:
        boolean
      • getName

        public java.lang.String getName()
        返回投影坐标系对象的名称。
        返回:
        投影坐标系对象的名称。
        Default:
        默认值为 "User Define"。
      • setName

        public void setName(java.lang.String value)
        设置投影坐标系对象的名称。该方法仅在坐标系类型为投影坐标系和地理坐标系时有效。
        参数:
        value - 投影坐标系对象的名称。
      • getType

        public PrjCoordSysType getType()
        返回投影坐标系类型。

        当投影坐标系类型为自定义时,用户需另外指定地理坐标系、投影方法、坐标单位以及投影参数;其余的值为 SuperMap Object Java 系统预定义,用户不必指定其他参数。

        返回:
        投影坐标系类型。
        Default:
        默认值为 PrjCoordSysType.PCS_USER_DEFINED。
      • setType

        public void setType(PrjCoordSysType value)
        设置投影坐标系类型。

        当投影坐标系类型为自定义时,用户需另外指定地理坐标系、投影方法、坐标单位以及投影参数;其余的值为 SuperMap Object Java 系统预定义,用户不必指定其他参数。

        参数:
        value - 投影坐标系类型。
      • getGeoCoordSys

        public GeoCoordSys getGeoCoordSys()
        返回投影坐标系的地理坐标系统对象。每个投影系都要依赖于一个地理坐标系。
        返回:
        投影坐标系的地理坐标系统对象。
        Default:
        默认值为空的 GeoCoordSys 对象。
      • setGeoCoordSys

        public void setGeoCoordSys(GeoCoordSys value)
        设置投影坐标系的地理坐标系统对象。每个投影系都要依赖于一个地理坐标系。该方法仅在坐标系类型为投影坐标系和地理坐标系时有效。
        参数:
        value - 投影坐标系的地理坐标系统对象。
      • getProjection

        public Projection getProjection()
        返回投影坐标系统的投影方式。投影方式如等角圆锥投影、等距方位投影等等。
        返回:
        投影坐标系统的投影方式。
        Default:
        默认值为空的 Projection 对象。
      • setProjection

        public void setProjection(Projection value)
        设置投影坐标系统的投影方式。投影方式如等角圆锥投影、等距方位投影等等。该方法仅在坐标系类型为投影坐标系时有效。
        参数:
        value - 投影坐标系统的投影方式。
      • getPrjParameter

        public PrjParameter getPrjParameter()
        返回投影坐标系统对象的投影参数。
        返回:
        投影坐标系统对象的投影参数。
        Default:
        默认值为空的 PrjParameter
      • setPrjParameter

        public void setPrjParameter(PrjParameter value)
        设置投影坐标系统对象的投影参数。该方法仅在坐标系类型为投影坐标系时有效。
        参数:
        value - 投影坐标系统对象的投影参数。
      • getCoordUnit

        public Unit getCoordUnit()
        返回投影系统坐标单位。

        投影系统的坐标单位与距离单位(DistanceUnits)可以不同,例如经纬度坐标下的坐标单位是度,距离单位可以是米、公里等; 即使是普通平面坐标或者投影坐标,这两个单位同样可不同。

        返回:
        投影系统坐标单位。
        Default:
        默认值为 METER
      • setCoordUnit

        public void setCoordUnit(Unit value)
        设置投影系统坐标单位。

        投影系统的坐标单位与距离单位(DistanceUnits)可以不同,例如经纬度坐标下的坐标单位是度,距离单位可以是米、公里等; 即使是普通平面坐标或者投影坐标,这两个单位同样可不同。

        参数:
        value - 投影系统坐标单位。
      • getDistanceUnit

        public Unit getDistanceUnit()
        返回距离(长度)单位。
        返回:
        距离(长度)单位。
        Default:
        默认值为 METER
      • setDistanceUnit

        public void setDistanceUnit(Unit value)
        设置距离(长度)单位。该方法仅在坐标系类型为投影坐标系和地理坐标系时有效。
        参数:
        value - 距离(长度)单位。
      • fromXML

        public boolean fromXML(java.lang.String xml)
        据 XML 字符串构建 PrjCoordSys 对象,成功返回 true。
        参数:
        xml - 指定的 XML 字符串。
        返回:
        如果构建成功返回 true,否则返回 false。
      • toXML

        public java.lang.String toXML()
        将投影坐标系类的对象转换为 XML 格式的字符串。
        返回:
        表示投影坐标系类的对象的 XML 字符串。
      • fromFile

        public boolean fromFile(java.lang.String filePath,
                                PrjFileType type)
        根据 XML 文件与投影文件类型构建 PrjCoordSys 对象。
        参数:
        filePath - XML 文件的全路径。
        type - 投影文件的类型。
        返回:
        构建成功返回 true,否则返回 false。
      • toFile

        public boolean toFile(java.lang.String filePath,
                              PrjFileVersion version)
        根据指定版本将 PrjCoordSys 对象导出到投影文件。
        参数:
        filePath - XML 文件的全路径。
        version - 导出投影文件的版本。
        返回:
        导出成功返回 true,否则返回 false。
      • dispose

        public void dispose()
        释放该对象所占用的资源。当调用该方法之后,此对象不再可用。
      • clone

        public PrjCoordSys clone()
        对PrjCoordSys进行clone
        覆盖:
        clone 在类中 java.lang.Object
        返回:
        PrjCoordSys的clone对象