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 的新对象。

方法摘要

void	dispose() 释放该对象所占用的资源。
boolean	fromXML(java.lang.String xml) 从指定的 XML 字符串中构建地球椭球体参数类的对象。
double	getAxis() 返回地球椭球体的长半径。
double	getFlatten() 返回地球椭球体的扁率。
java.lang.String	getName() 返回地球椭球体对象的名称。
GeoSpheroidType	getType() 返回地球椭球体的类型。
void	setAxis(double value) 设置地球椭球体的长半径。
void	setFlatten(double value) 设置地球椭球体的扁率。
void	setName(java.lang.String value) 设置地球椭球体对象的名称。
void	setType(GeoSpheroidType value) 设置地球椭球体的类型。
java.lang.String	toXML() 将地球椭球参数类的对象转换为 XML 格式的字符串。

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

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

构造方法详细信息

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()

返回地球椭球体的长半径。地球椭球体的长半径也叫地球赤道半径，通过它和地球扁率可以求得地球椭球体的极地半径、第一偏心率、第二偏心率等等。只当地球椭球体的类型为自定义类型时，长半径才可以被设置。

返回：

地球椭球体的长半径。

默认值:

默认值为 0.0。

setAxis

public void setAxis(double value)

设置地球椭球体的长半径。地球椭球体的长半径也叫地球赤道半径，通过它和地球扁率可以求得地球椭球体的极地半径、第一偏心率、第二偏心率等等。只当地球椭球体的类型为自定义类型时，长半径才可以被设置。

参数：

value - 地球椭球体的长半径。

getFlatten

public double getFlatten()

返回地球椭球体的扁率。只当地球椭球体的类型为自定义类型时，扁率才可以被设置。

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

返回：

地球椭球体的扁率。

默认值:

默认值为 0.0。

setFlatten

public void setFlatten(double value)

设置地球椭球体的扁率。只当地球椭球体的类型为自定义类型时，扁率才可以被设置。

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

参数：

value - 地球椭球体的扁率。

getName

public java.lang.String getName()

返回地球椭球体对象的名称。只当地球椭球体的类型为自定义类型时，才可以设置。

返回：

地球椭球体对象的名称。

默认值:

默认值为 "USER_DEFINED"。

setName

public void setName(java.lang.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(java.lang.String xml)

从指定的 XML 字符串中构建地球椭球体参数类的对象。

参数：

xml - 指定的 XML 字符串。

返回：

如果构建成功返回 true，否则返回 false。

toXML

public java.lang.String toXML()

将地球椭球参数类的对象转换为 XML 格式的字符串。

返回：

表示地球椭球体参数类的对象的 XML 字符串。

dispose

public void dispose()

释放该对象所占用的资源。当调用该方法之后，此对象不再可用。