com.supermap.data
类 GeoSpheroid
- java.lang.Object
-
- com.supermap.data.GeoSpheroid
-
public class GeoSpheroid extends java.lang.Object地球椭球体参数类。该类主要用来描述地球的长半径和扁率。
人们通常用球体或椭球体来描述地球的形状和大小,有时为了计算方便,可以将地球看作一个球体,但更多的时候是把它看作椭球体。一般情况下在地图比例尺小于1:1,000,000 时,假设地球形状为一球体,因为在这种比例尺下球体和椭球体的差别几乎无法分辨;而在1:1,000,000 甚至更高精度要求的大比例尺时,则需用椭球体逼近地球。椭球体是以椭圆为基础的,所以用两个轴来表述地球球体的大小,即长轴(赤道半径)和短轴(极地半径)。
因为同一个投影方法,不同的椭球体参数,相同的数据投影出来的结果可能相差很大,所以需要选择合适的椭球参数。不同年代、不同国家和地区使用的地球椭球参数有可能不同,中国目前主要用的是克拉索夫斯基椭球参数;北美大陆及英法等主要用的是克拉克椭球参数。
-
-
构造器概要
构造器 构造器和说明 GeoSpheroid()构造一个新的 GeoSpheroid 对象。GeoSpheroid(double axis, double flatten, java.lang.String name)根据指定的参数来构造一个 GeoSpheroid 的新对象。GeoSpheroid(GeoSpheroid geoSpheroid)根据给定的 GeoSpheroidType 对象构造一个与其完全相同的新对象。GeoSpheroid(GeoSpheroidType type)根据指定的参数来构造一个 GeoSpheroidType 的新对象。
-
方法概要
所有方法 实例方法 具体方法 限定符和类型 方法和说明 GeoSpheroidclone()对GeoSpheroid进行clonevoiddispose()释放该对象所占用的资源。booleanfromXML(java.lang.String xml)从指定的 XML 字符串中构建地球椭球体参数类的对象。doublegetAxis()返回地球椭球体的长半径。doublegetFlatten()返回地球椭球体的扁率。java.lang.StringgetName()返回地球椭球体对象的名称。GeoSpheroidTypegetType()返回地球椭球体的类型。voidsetAxis(double value)设置地球椭球体的长半径。voidsetFlatten(double value)设置地球椭球体的扁率。voidsetName(java.lang.String value)设置地球椭球体对象的名称。voidsetType(GeoSpheroidType value)设置地球椭球体的类型。java.lang.StringtoXML()将地球椭球参数类的对象转换为 XML 格式的字符串。
-
-
-
构造器详细资料
-
GeoSpheroid
public GeoSpheroid()
构造一个新的 GeoSpheroid 对象。
-
GeoSpheroid
public GeoSpheroid(GeoSpheroidType type)
根据指定的参数来构造一个 GeoSpheroidType 的新对象。- 参数:
type- 指定的 GeoSpheroidType 对象。
-
GeoSpheroid
public GeoSpheroid(double axis, double flatten, java.lang.String name)根据指定的参数来构造一个 GeoSpheroid 的新对象。- 参数:
axis- 指定的地球椭球体的长半径。flatten- 指定的地球椭球体的扁率。name- 指定的地球椭球体的名称。
-
GeoSpheroid
public GeoSpheroid(GeoSpheroid geoSpheroid)
根据给定的 GeoSpheroidType 对象构造一个与其完全相同的新对象。- 参数:
geoSpheroid- 指定的 GeoSpheroidType 对象。
-
-
方法详细资料
-
getAxis
public double getAxis()
返回地球椭球体的长半径。地球椭球体的长半径也叫地球赤道半径,通过它和地球扁率可以求得地球椭球体的极地半径、第一偏心率、第二偏心率等等。只当地球椭球体的类型为自定义类型时,长半径才可以被设置。- 返回:
- 地球椭球体的长半径。
- Default:
- 默认值为 6378137.0。
-
setAxis
public void setAxis(double value)
设置地球椭球体的长半径。地球椭球体的长半径也叫地球赤道半径,通过它和地球扁率可以求得地球椭球体的极地半径、第一偏心率、第二偏心率等等。只当地球椭球体的类型为自定义类型时,长半径才可以被设置。- 参数:
value- 地球椭球体的长半径。
-
getFlatten
public double getFlatten()
返回地球椭球体的扁率。只当地球椭球体的类型为自定义类型时,扁率才可以被设置。地球椭球体的扁率反映了地球椭球体的圆扁情况, 一般为地球长短半轴之差与长半轴之比。
- 返回:
- 地球椭球体的扁率。
- Default:
- 默认值为0.0033528107。
-
setFlatten
public void setFlatten(double value)
设置地球椭球体的扁率。只当地球椭球体的类型为自定义类型时,扁率才可以被设置。地球椭球体的扁率反映了地球椭球体的圆扁情况, 一般为地球长短半轴之差与长半轴之比。
- 参数:
value- 地球椭球体的扁率。
-
getName
public java.lang.String getName()
返回地球椭球体对象的名称。只当地球椭球体的类型为自定义类型时,才可以设置。- 返回:
- 地球椭球体对象的名称。
- Default:
- 默认值为 "WGS_1984"。
-
setName
public void setName(java.lang.String value)
设置地球椭球体对象的名称。只当地球椭球体的类型为自定义类型时,才可以设置。- 参数:
value- 地球椭球体对象的名称。
-
getType
public GeoSpheroidType getType()
返回地球椭球体的类型。该地球椭球体类型为自定义类型时,用户需另外指定椭球体的长半径和扁率;其余的值为 SuperMap objects Java 系统预定义,用户不必指定长半径和扁率。可参见地球椭球体 GeoSpheroidType 枚举类。- 返回:
- 地球椭球体的类型。
- Default:
- 默认值为
SPHEROID_WGS_1984。
-
setType
public void setType(GeoSpheroidType value)
设置地球椭球体的类型。该地球椭球体类型为自定义类型时,用户需另外指定椭球体的长半径和扁率;其余的值为 SuperMap objects Java 系统预定义,用户不必指定长半径和扁率。可参见地球椭球体 GeoSpheroidType 枚举类。- 参数:
value- 地球椭球体的类型。
-
fromXML
public boolean fromXML(java.lang.String xml)
从指定的 XML 字符串中构建地球椭球体参数类的对象。- 参数:
xml- 指定的 XML 字符串。- 返回:
- 如果构建成功返回 true,否则返回 false。
-
toXML
public java.lang.String toXML()
将地球椭球参数类的对象转换为 XML 格式的字符串。- 返回:
- 表示地球椭球体参数类的对象的 XML 字符串。
-
dispose
public void dispose()
释放该对象所占用的资源。当调用该方法之后,此对象不再可用。
-
clone
public GeoSpheroid clone()
对GeoSpheroid进行clone- 覆盖:
clone在类中java.lang.Object- 返回:
- GeoSpheroid的clone对象
-
-