com.supermap.data

类 GeoSpheroid

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


    public class GeoSpheroid
    extends com.supermap.data.InternalHandleDisposable
    地球椭球体参数类。

    该类主要用来描述地球的长半径和扁率。

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

    因为同一个投影方法,不同的椭球体参数,相同的数据投影出来的结果可能相差很大,所以需要选择合适的椭球参数。不同年代、不同国家和地区使用的地球椭球参数有可能不同,中国目前主要用的是克拉索夫斯基椭球参数;北美大陆及英法等主要用的是克拉克椭球参数。

    • 构造器详细资料

      • GeoSpheroid

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

        public GeoSpheroid(GeoSpheroidType type)
        根据指定的参数来构造一个 GeoSpheroidType 的新对象。
        参数:
        type - 指定的 GeoSpheroidType 对象。
      • GeoSpheroid

        public GeoSpheroid(double axis,
                           double flatten,
                           String name)
        根据指定的参数来构造一个 GeoSpheroid 的新对象。
        参数:
        axis - 指定的地球椭球体的长半径。
        flatten - 指定的地球椭球体的扁率。
        name - 指定的地球椭球体的名称。
      • GeoSpheroid

        public GeoSpheroid(GeoSpheroid geoSpheroid)
    • 方法详细资料

      • dispose

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

        public double getAxis()
        返回地球椭球体的长半径。地球椭球体的长半径也叫地球赤道半径,通过它和地球扁率可以求得地球椭球体的极地半径、第一偏心率、第二偏心率等等。只当地球椭球体的类型为自定义类型时,长半径才可以被设置。
        返回:
        地球椭球体的长半径。
        默认值:
        默认值为 0.0。
      • setAxis

        public void setAxis(double value)
        设置地球椭球体的长半径。地球椭球体的长半径也叫地球赤道半径,通过它和地球扁率可以求得地球椭球体的极地半径、第一偏心率、第二偏心率等等。只当地球椭球体的类型为自定义类型时,长半径才可以被设置。
        参数:
        value - 地球椭球体的长半径。
      • getFlatten

        public double getFlatten()
        返回地球椭球体的扁率。只当地球椭球体的类型为自定义类型时,扁率才可以被设置。

        地球椭球体的扁率反映了地球椭球体的圆扁情况, 一般为地球长短半轴之差与长半轴之比。

        返回:
        地球椭球体的扁率。
        默认值:
        默认值为 0.0。
      • setFlatten

        public void setFlatten(double value)
        设置地球椭球体的扁率。只当地球椭球体的类型为自定义类型时,扁率才可以被设置。

        地球椭球体的扁率反映了地球椭球体的圆扁情况, 一般为地球长短半轴之差与长半轴之比。

        参数:
        value - 地球椭球体的扁率。
      • getName

        public String getName()
        返回地球椭球体对象的名称。只当地球椭球体的类型为自定义类型时,才可以设置。
        返回:
        地球椭球体对象的名称。
        默认值:
        默认值为 "USER_DEFINED"。
      • setName

        public void setName(String value)
        设置地球椭球体对象的名称。只当地球椭球体的类型为自定义类型时,才可以设置。
        参数:
        value - 地球椭球体对象的名称。
      • getType

        public GeoSpheroidType getType()
        返回地球椭球体的类型。该地球椭球体类型为自定义类型时,用户需另外指定椭球体的长半径和扁率;其余的值为 SuperMap iObjects Java 系统预定义,用户不必指定长半径和扁率。可参见地球椭球体 GeoSpheroidType 枚举类。
        返回:
        地球椭球体的类型。
        默认值:
        默认值为 SPHEROID_USER_DEFINED
      • setType

        public void setType(GeoSpheroidType value)
        设置地球椭球体的类型。该地球椭球体类型为自定义类型时,用户需另外指定椭球体的长半径和扁率;其余的值为 SuperMap iObjects Java 系统预定义,用户不必指定长半径和扁率。可参见地球椭球体 GeoSpheroidType 枚举类。
        参数:
        value - 地球椭球体的类型。
      • fromXML

        public boolean fromXML(String xml)
        从指定的 XML 字符串中构建地球椭球体参数类的对象。
        参数:
        xml - 指定的 XML 字符串。
        返回:
        如果构建成功返回 true,否则返回 false。
      • toXML

        public String toXML()
        将地球椭球参数类的对象转换为 XML 格式的字符串。
        返回:
        表示地球椭球体参数类的对象的 XML 字符串。

Copyright © 2021–2024 SuperMap. All rights reserved.