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()
```
    返回大地参照系对象的名称。
    
    返回:
    
    大地参照系对象的名称。
    
    默认值:
    
    默认值为 "User Define"。
  - setName
```
public void setName(java.lang.String value)
```
    设置大地参照系对象的名称。
    
    参数:
    
    value - 大地参照系对象的名称。
  - getGeoSpheroid
```
public GeoSpheroid getGeoSpheroid()
```
    返回地球椭球体对象。只当大地参照系类型为自定义类型时才可以设置。
    人们通常用球体或椭球体来描述地球的形状和大小，有时为了计算方便，可以将地球看作一个球体，但更多的时候是把它看作椭球体。一般情况下在地图比例尺小于1：1,000,000 时，假设地球形状为一球体，因为在这种比例尺下球体和椭球体的差别几乎无法分辨；而在1：1,000,000 甚至更高精度要求的大比例尺时，则需用椭球体逼近地球。椭球体是以椭圆为基础的，所以用两个轴来表述地球球体的大小，即长轴（赤道半径）和短轴（极地半径）。
    
    返回:
    
    地球椭球体对象。
    
    默认值:
    
    默认值为空的 GeoSpheroid 对象
  - setGeoSpheroid
```
public void setGeoSpheroid(GeoSpheroid value)
```
    设置地球椭球体对象。只当大地参照系类型为自定义类型时才可以设置。
    人们通常用球体或椭球体来描述地球的形状和大小，有时为了计算方便，可以将地球看作一个球体，但更多的时候是把它看作椭球体。一般情况下在地图比例尺小于1：1,000,000 时，假设地球形状为一球体，因为在这种比例尺下球体和椭球体的差别几乎无法分辨；而在1：1,000,000 甚至更高精度要求的大比例尺时，则需用椭球体逼近地球。椭球体是以椭圆为基础的，所以用两个轴来表述地球球体的大小，即长轴（赤道半径）和短轴（极地半径）。
    
    参数:
    
    value - 地球椭球体对象。
  - getType
```
public GeoDatumType getType()
```
    返回大地参照系的类型。
    当大地参照系为自定义时，用户需另外指定椭球体参数；其它的值为 SuperMap Objects Java 系统预定义，用户不必指定椭球体参数。参见 GeoDatumType。
    
    返回:
    
    大地参照系的类型。
    
    默认值:
    
    默认值为 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()
```
    释放该对象所占用的资源。当调用该方法之后，此对象不再可用。

类 GeoDatum

构造器概要

方法概要

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

构造器详细资料

GeoDatum

GeoDatum

GeoDatum

GeoDatum

方法详细资料

getName

setName

getGeoSpheroid

setGeoSpheroid

getType

setType

clone

fromXML

toXML

dispose