跳过导航链接
com.supermap.data

类 GeoDatum

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

  • public class GeoDatum
extends java.lang.Object

    大地参照系类。

    该类包含有地球椭球参数。

    地球椭球体仅仅是描述了地球的大小及形状，为了更准确地描述地球上的地物的具体位置，需要引入大地参照系。大地参照系确定了地球椭球体相对于地球球心的位置，为地表地物的测量提供了一个参照框架，确定了地表经纬网线的原点和方向。大地参照系把地球椭球体的球心当作原点。一个地区的大地参照系的地球椭球体或多或少地偏移了真正的地心，地表上的地物坐标都是相对于该椭球体的球心的。目前被广泛利用的是 WGS84，它被当着大地测量的基本框架。不同的大地参照系适用于不同的国家和地区，一个大地参照系并不适合于所有的地区。

    • 构造器概要

      构造器 
      构造器和说明
      GeoDatum()
      构造一个新的 GeoDatum 对象。
      GeoDatum(GeoDatum geoDatum)
      根据给定的 GeoDatum 对象构造一个与其完全相同的新对象。
      GeoDatum(GeoDatumType type)
      根据指定的参数来构造一个 GeoDatum 的新对象。
      GeoDatum(GeoSpheroid geoSpheroid, java.lang.String name)
      根据指定的参数来构造一个 GeoDatum 的新对象。

    • 方法概要

      所有方法 实例方法 具体方法 
      限定符和类型 方法和说明
      GeoDatum clone()
      返回当前GeoDatum对象的一个拷贝。
      void dispose()
      释放该对象所占用的资源。
      boolean fromXML(java.lang.String xml)
      根据 XML 字符串构建 GeoDatum 对象。
      GeoSpheroid getGeoSpheroid()
      返回地球椭球体对象。
      java.lang.String getName()
      返回大地参照系对象的名称。
      GeoDatumType getType()
      返回大地参照系的类型。
      void setGeoSpheroid(GeoSpheroid value)
      设置地球椭球体对象。
      void setName(java.lang.String value)
      设置大地参照系对象的名称。
      void setType(GeoDatumType value)
      设置大地参照系的类型。
      java.lang.String toXML()
      将大地参照系类的对象转换为 XML 格式的字符串。

      • 从类继承的方法 java.lang.Object

        equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

    • 构造器详细资料

      • GeoDatum

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

      • GeoDatum

        public GeoDatum(GeoDatumType type)
        根据指定的参数来构造一个 GeoDatum 的新对象。
        参数:
        type - 指定的大地参照系类型。

      • GeoDatum

        public GeoDatum(GeoSpheroid geoSpheroid,
                java.lang.String name)
        根据指定的参数来构造一个 GeoDatum 的新对象。
        参数:
        geoSpheroid - 地球椭球体。
        name - 大地参照系名称。

      • GeoDatum

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

    • 方法详细资料

      • getName

        public java.lang.String getName()
        返回大地参照系对象的名称。
        返回:
        大地参照系对象的名称。
        Default:
        默认值为 "User Define"。

      • setName

        public void setName(java.lang.String value)
        设置大地参照系对象的名称。
        参数:
        value - 大地参照系对象的名称。

      • getGeoSpheroid

        public GeoSpheroid getGeoSpheroid()
        返回地球椭球体对象。只当大地参照系类型为自定义类型时才可以设置。

        人们通常用球体或椭球体来描述地球的形状和大小，有时为了计算方便，可以将地球看作一个球体，但更多的时候是把它看作椭球体。一般情况下在地图比例尺小于1：1,000,000 时，假设地球形状为一球体，因为在这种比例尺下球体和椭球体的差别几乎无法分辨；而在1：1,000,000 甚至更高精度要求的大比例尺时，则需用椭球体逼近地球。椭球体是以椭圆为基础的，所以用两个轴来表述地球球体的大小，即长轴（赤道半径）和短轴（极地半径）。

        返回:
        地球椭球体对象。
        Default:
        默认值为空的 GeoSpheroid 对象

      • setGeoSpheroid

        public void setGeoSpheroid(GeoSpheroid value)
        设置地球椭球体对象。只当大地参照系类型为自定义类型时才可以设置。

        人们通常用球体或椭球体来描述地球的形状和大小，有时为了计算方便，可以将地球看作一个球体，但更多的时候是把它看作椭球体。一般情况下在地图比例尺小于1：1,000,000 时，假设地球形状为一球体，因为在这种比例尺下球体和椭球体的差别几乎无法分辨；而在1：1,000,000 甚至更高精度要求的大比例尺时，则需用椭球体逼近地球。椭球体是以椭圆为基础的，所以用两个轴来表述地球球体的大小，即长轴（赤道半径）和短轴（极地半径）。

        参数:
        value - 地球椭球体对象。

      • getType

        public GeoDatumType getType()
        返回大地参照系的类型。

        当大地参照系为自定义时，用户需另外指定椭球体参数；其它的值为 SuperMap Objects Java 系统预定义，用户不必指定椭球体参数。参见 GeoDatumType。

        返回:
        大地参照系的类型。
        Default:
        默认值为 DATUM_WGS_1984。

      • setType

        public void setType(GeoDatumType value)
        设置大地参照系的类型。

        当大地参照系为自定义时，用户需另外指定椭球体参数；其它的值为 SuperMap Objects Java 系统预定义，用户不必指定椭球体参数。参见 GeoDatumType。

        参数:
        value - 大地参照系的类型。

      • clone

        public GeoDatum clone()
        返回当前GeoDatum对象的一个拷贝。
        覆盖:
        clone 在类中 java.lang.Object
        返回:
        通过克隆操作得到的GeoDatum对象。

      • fromXML

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

      • toXML

        public java.lang.String toXML()
        将大地参照系类的对象转换为 XML 格式的字符串。
        返回:
        表示大地参照系类的对象转换为 XML 格式的字符串。

      • dispose

        public void dispose()
        释放该对象所占用的资源。当调用该方法之后，此对象不再可用。
跳过导航链接