com.supermap.data

类 CoordSysTransParameter

  • java.lang.Object
    • com.supermap.data.InternalHandle
      • com.supermap.data.InternalHandleDisposable
        • com.supermap.data.CoordSysTransParameter
  • 所有已实现的接口:
    IDisposable


    public class CoordSysTransParameter
    extends com.supermap.data.InternalHandleDisposable

    投影转换参照系转换参数类,通常包括平移、旋转和比例因子。

    在进行投影转换时,如果源投影和目标投影的地理坐标系不同,则需要进行参照系转换。SuperMap 提供常用的六种参照系转换方法,详见 CoordSysTransMethod 方法。不同的参照系转换方法需要指定不同的转换参数:

    1. 三参数转换法(GeocentricTranslation)、莫洛金斯基转换法(Molodensky)、简化的莫洛金斯基转换法(MolodenskyAbridged)属于精度较低的几种转换方法,在数据精度要求不高的情况下一般可以采用这几种方法。这三种转换法需要给定三个平移转换参数:X 轴坐标偏移量(setTranslateX)、Y 轴坐标偏移量(setTranslateY)和 Z 轴坐标偏移量(setTranslateZ)。
    2. 位置矢量法(PositionVector)、基于地心的七参数转换法(CoordinateFrame)、布尔莎方法(BursaWolf)属于精度较高的几种转换方法。需要七个参数来进行调整和转换,包括除上述的三个平移转换参数外,还需要设置三个旋转转换参数(X 轴旋转角度(setRotateX)、Y 轴旋转角度(setRotateY)和 Z 轴旋转角度(setRotateZ))和投影比例尺差参数(setScaleDifference)。

    有关投影转换的详细介绍,请参阅《地图投影》《地理数据坐标系转换》技术文档。

    • 构造器详细资料

      • CoordSysTransParameter

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

        public CoordSysTransParameter(CoordSysTransParameter coordSysTransParameter)
        根据给定的 CoordSysTransParameter 对象构造一个与其完全相同的新对象。
        参数:
        coordSysTransParameter - 指定的 CoordSysTransParameter 对象。
      • CoordSysTransParameter

        public CoordSysTransParameter(long handle,
                                      boolean disposable)
    • 方法详细资料

      • clearHandle

        public void clearHandle()
        从类复制的说明: com.supermap.data.InternalHandle
        当内存先被释放,必须调用该函数以标记对象为不可用
        覆盖:
        clearHandle 在类中 com.supermap.data.InternalHandle
      • dispose

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

        public double getTranslateX()
        返回 X 轴的坐标偏移量。单位为米。
        返回:
        X 轴的坐标偏移量。
        默认值:
        默认值为 0。
      • setTranslateX

        public void setTranslateX(double value)
        设置 X 轴的坐标偏移量。单位为米。
        参数:
        value - X 轴的坐标偏移量。
      • getTranslateY

        public double getTranslateY()
        返回 Y 轴的坐标偏移量。单位为米。
        返回:
        Y 轴的坐标偏移量。
        默认值:
        默认值为 0。
      • setTranslateY

        public void setTranslateY(double value)
        设置 Y 轴的坐标偏移量。单位为米。
        参数:
        value - Y 轴的坐标偏移量。
      • getTranslateZ

        public double getTranslateZ()
        返回 Z 轴的坐标偏移量。单位为米。
        返回:
        Z 轴的坐标偏移量。
        默认值:
        默认值为 0。
      • setTranslateZ

        public void setTranslateZ(double value)
        设置 Z 轴的坐标偏移量。单位为米。
        参数:
        value - Z 轴的坐标偏移量。
      • getRotateX

        public double getRotateX()
        返回 X 轴的旋转角度。用于不同大地参照系之间的转换。单位为弧度。
        返回:
        X 轴的旋转角度。
        默认值:
        默认值为 0。
      • setRotateX

        public void setRotateX(double value)
        设置 X 轴的旋转角度。用于不同大地参照系之间的转换。单位为弧度。
        参数:
        value - X 轴的旋转角度。
      • getRotateY

        public double getRotateY()
        返回 Y 轴的旋转角度。用于不同大地参照系之间的转换。单位为弧度。
        返回:
        Y 轴的旋转角度。
        默认值:
        默认值为 0。
      • setRotateY

        public void setRotateY(double value)
        设置 Y 轴的旋转角度。用于不同大地参照系之间的转换。单位为弧度。
        参数:
        value - Y 轴的旋转角度。
      • getRotateZ

        public double getRotateZ()
        返回 Z 轴的旋转角度。用于不同大地参照系之间的转换。单位为弧度。
        返回:
        Z 轴的旋转角度。
        默认值:
        默认值为 0。
      • setRotateZ

        public void setRotateZ(double value)
        设置 Z 轴的旋转角度。用于不同大地参照系之间的转换。单位为弧度。
        参数:
        value - Z 轴的旋转角度。
      • getScaleDifference

        public double getScaleDifference()
        返回投影比例尺差。单位为百万分之一。用于不同大地参照系之间的转换。
        返回:
        投影比例尺差。
        默认值:
        默认值为 0。
      • setScaleDifference

        public void setScaleDifference(double value)
        设置投影比例尺差。单位为百万分之一。用于不同大地参照系之间的转换。
        参数:
        value - 投影比例尺差。
      • getRotationOriginX

        public double getRotationOriginX()
        返回旋转原点的X坐标的量。
        返回:
        返回旋转原点的X坐标的量。
      • setRotationOriginX

        public void setRotationOriginX(double value)
        设置旋转原点的X坐标。
        参数:
        value - 旋转原点的X坐标的量。
      • getRotationOriginY

        public double getRotationOriginY()
        返回旋转原点的Y坐标的量。
        返回:
        返回旋转原点的Y坐标的量。
      • setRotationOriginY

        public void setRotationOriginY(double value)
        设置旋转原点的Y坐标。
        参数:
        value - 旋转原点的Y坐标的量。
      • getRotationOriginZ

        public double getRotationOriginZ()
        返回旋转原点的Z坐标的量。
        返回:
        返回旋转原点的Z坐标的量。
      • setRotationOriginZ

        public void setRotationOriginZ(double value)
        设置旋转原点的Z坐标。
        参数:
        value - 旋转原点的Z坐标的量。
      • fromXML

        public boolean fromXML(String xml)
        根据 XML 字符串构建 CoordSysTransParameter 对象,成功返回 true。
        参数:
        xml - 表示投影转换参数对象的 XML 字符串。
        返回:
        如果构建 XML 字符串成功则返回 true,否则返回 false。
      • toXML

        public String toXML()
        将该 CoordSysTransParameter 对象输出为 XML 字符串。
        返回:
        CoordSysTransParameter 对象的 XML 格式字符串。

Copyright © 2021–2024 SuperMap. All rights reserved.