GeoSpheroid (iObjects Java Help)

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()` 构造一个新的 GeoSpheroid 对象。
`GeoSpheroid(double axis, double flatten, String name)` 根据指定的参数来构造一个 GeoSpheroid 的新对象。
`GeoSpheroid(GeoSpheroid geoSpheroid)`
`GeoSpheroid(GeoSpheroidType type)` 根据指定的参数来构造一个 GeoSpheroidType 的新对象。

方法概要

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

从类继承的方法 com.supermap.data.InternalHandleDisposable
makeSureNativeObjectLive

从类继承的方法 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,
                   String name)
```
    根据指定的参数来构造一个 GeoSpheroid 的新对象。
    
    参数:
    
    axis - 指定的地球椭球体的长半径。
    
    flatten - 指定的地球椭球体的扁率。
    
    name - 指定的地球椭球体的名称。
  - GeoSpheroid
```
public GeoSpheroid(GeoSpheroid geoSpheroid)
```
- 方法详细资料
  - clone
```
public GeoSpheroid clone()
```
    覆盖:
    
    clone 在类中 Object
  - 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 字符串。

类 GeoSpheroid

构造器概要

方法概要

从类继承的方法 com.supermap.data.InternalHandleDisposable

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

构造器详细资料

GeoSpheroid

GeoSpheroid

GeoSpheroid

GeoSpheroid

方法详细资料

clone

dispose

getAxis

setAxis

getFlatten

setFlatten

getName

setName

getType

setType

fromXML

toXML