com.supermap.data
类 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 的新对象。

方法摘要

void	dispose() 释放该对象所占用的资源。
boolean	fromXML(java.lang.String xml) 根据 XML 字符串构建 GeoDatum 对象，成功返回 true。
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 iObjects Java 系统预定义，用户不必指定椭球体参数。参见 GeoDatumType。

返回：

大地参照系的类型。

默认值:

默认值为 DATUM_USER_DEFINED。

setType

public void setType(GeoDatumType value)

设置大地参照系的类型。

当大地参照系为自定义时，用户需另外指定椭球体参数；其它的值为 SuperMap iObjects Java 系统预定义，用户不必指定椭球体参数。参见 GeoDatumType。

参数：

value - 大地参照系的类型。

fromXML

public boolean fromXML(java.lang.String xml)

根据 XML 字符串构建 GeoDatum 对象，成功返回 true。

参数：

xml - 指定的 XML 字符串。

返回：

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

toXML

public java.lang.String toXML()

将大地参照系类的对象转换为 XML 格式的字符串。

返回：

表示大地参照系类的对象转换为 XML 格式的字符串。

dispose

public void dispose()

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