com.supermap.data
类 PrjCoordSys
- java.lang.Object
-
- com.supermap.data.PrjCoordSys
-
public class PrjCoordSys extends java.lang.Object
投影坐标系类。
投影坐标系统由地图投影方式、投影参数、坐标单位和地理坐标系组成。SuperMap iMobile for Android 中提供了很多预定义的投影系统,用户可以直接使用,此外,用户还可以定制自己投影系统。
投影坐标系是定义在二维平面上的,不同于地理坐标系用经纬度定位地面点,投影坐标系是用 X、Y 坐标来定位的。每一个投影坐标系都基于一个地理坐标系。
-
-
构造器概要
构造器 构造器和说明 PrjCoordSys()
构造一个新的 PrjCoordSys 对象。PrjCoordSys(GeoCoordSys geoCoordSys, Projection projection, PrjParameter prjParameter, java.lang.String name)
根据指定的参数来构造一个 PrjCoordSys 的新对象。PrjCoordSys(int EPSGCode)
构造一个新的 PrjCoordSys 对象。PrjCoordSys(PrjCoordSys prjCoordSys)
根据给定的 PrjCoordSys 对象构造一个与其完全相同的新对象。PrjCoordSys(PrjCoordSysType type)
根据指定的参数来构造一个 PrjCoordSys 的新对象。
-
方法概要
所有方法 实例方法 具体方法 限定符和类型 方法和说明 PrjCoordSys
clone()
对PrjCoordSys进行clonevoid
dispose()
释放该对象所占用的资源。boolean
fromFile(java.lang.String filePath, PrjFileType type)
根据 XML 文件与投影文件类型构建PrjCoordSys
对象。boolean
fromXML(java.lang.String xml)
据 XML 字符串构建PrjCoordSys
对象,成功返回 true。Unit
getCoordUnit()
返回投影系统坐标单位。Unit
getDistanceUnit()
返回距离(长度)单位。GeoCoordSys
getGeoCoordSys()
返回投影坐标系的地理坐标系统对象。java.lang.String
getName()
返回投影坐标系对象的名称。PrjParameter
getPrjParameter()
返回投影坐标系统对象的投影参数。Projection
getProjection()
返回投影坐标系统的投影方式。PrjCoordSysType
getType()
返回投影坐标系类型。boolean
isSame(PrjCoordSys prjCoordSys)
左边是否相同void
setCoordUnit(Unit value)
设置投影系统坐标单位。void
setDistanceUnit(Unit value)
设置距离(长度)单位。void
setGeoCoordSys(GeoCoordSys value)
设置投影坐标系的地理坐标系统对象。void
setName(java.lang.String value)
设置投影坐标系对象的名称。void
setPrjParameter(PrjParameter value)
设置投影坐标系统对象的投影参数。void
setProjection(Projection value)
设置投影坐标系统的投影方式。void
setType(PrjCoordSysType value)
设置投影坐标系类型。boolean
toFile(java.lang.String filePath, PrjFileVersion version)
根据指定版本将PrjCoordSys
对象导出到投影文件。java.lang.String
toXML()
将投影坐标系类的对象转换为 XML 格式的字符串。
-
-
-
构造器详细资料
-
PrjCoordSys
public PrjCoordSys()
构造一个新的 PrjCoordSys 对象。
-
PrjCoordSys
public PrjCoordSys(int EPSGCode)
构造一个新的 PrjCoordSys 对象。
-
PrjCoordSys
public PrjCoordSys(PrjCoordSysType type)
根据指定的参数来构造一个 PrjCoordSys 的新对象。- 参数:
type
- 投影坐标系类型。
-
PrjCoordSys
public PrjCoordSys(GeoCoordSys geoCoordSys, Projection projection, PrjParameter prjParameter, java.lang.String name)
根据指定的参数来构造一个 PrjCoordSys 的新对象。- 参数:
geoCoordSys
- 投影坐标系所基于的地理坐标系。projection
- 投影方式。投影方式如等角圆锥投影、等距方位投影等等。prjParameter
- 投影参数。name
- 投影坐标系名称。
-
PrjCoordSys
public PrjCoordSys(PrjCoordSys prjCoordSys)
根据给定的 PrjCoordSys 对象构造一个与其完全相同的新对象。- 参数:
prjCoordSys
- 指定的 PrjCoordSys 对象。
-
-
方法详细资料
-
isSame
public boolean isSame(PrjCoordSys prjCoordSys)
左边是否相同- 参数:
prjCoordSys
- 投影坐标系- 返回:
- boolean
-
getName
public java.lang.String getName()
返回投影坐标系对象的名称。- 返回:
- 投影坐标系对象的名称。
- Default:
- 默认值为 "User Define"。
-
setName
public void setName(java.lang.String value)
设置投影坐标系对象的名称。该方法仅在坐标系类型为投影坐标系和地理坐标系时有效。- 参数:
value
- 投影坐标系对象的名称。
-
getType
public PrjCoordSysType getType()
返回投影坐标系类型。当投影坐标系类型为自定义时,用户需另外指定地理坐标系、投影方法、坐标单位以及投影参数;其余的值为 SuperMap Object Java 系统预定义,用户不必指定其他参数。
- 返回:
- 投影坐标系类型。
- Default:
- 默认值为
PrjCoordSysType.PCS_USER_DEFINED。
-
setType
public void setType(PrjCoordSysType value)
设置投影坐标系类型。当投影坐标系类型为自定义时,用户需另外指定地理坐标系、投影方法、坐标单位以及投影参数;其余的值为 SuperMap Object Java 系统预定义,用户不必指定其他参数。
- 参数:
value
- 投影坐标系类型。
-
getGeoCoordSys
public GeoCoordSys getGeoCoordSys()
返回投影坐标系的地理坐标系统对象。每个投影系都要依赖于一个地理坐标系。- 返回:
- 投影坐标系的地理坐标系统对象。
- Default:
- 默认值为空的
GeoCoordSys
对象。
-
setGeoCoordSys
public void setGeoCoordSys(GeoCoordSys value)
设置投影坐标系的地理坐标系统对象。每个投影系都要依赖于一个地理坐标系。该方法仅在坐标系类型为投影坐标系和地理坐标系时有效。- 参数:
value
- 投影坐标系的地理坐标系统对象。
-
getProjection
public Projection getProjection()
返回投影坐标系统的投影方式。投影方式如等角圆锥投影、等距方位投影等等。- 返回:
- 投影坐标系统的投影方式。
- Default:
- 默认值为空的
Projection
对象。
-
setProjection
public void setProjection(Projection value)
设置投影坐标系统的投影方式。投影方式如等角圆锥投影、等距方位投影等等。该方法仅在坐标系类型为投影坐标系时有效。- 参数:
value
- 投影坐标系统的投影方式。
-
getPrjParameter
public PrjParameter getPrjParameter()
返回投影坐标系统对象的投影参数。- 返回:
- 投影坐标系统对象的投影参数。
- Default:
- 默认值为空的
PrjParameter
。
-
setPrjParameter
public void setPrjParameter(PrjParameter value)
设置投影坐标系统对象的投影参数。该方法仅在坐标系类型为投影坐标系时有效。- 参数:
value
- 投影坐标系统对象的投影参数。
-
getCoordUnit
public Unit getCoordUnit()
返回投影系统坐标单位。投影系统的坐标单位与距离单位(DistanceUnits)可以不同,例如经纬度坐标下的坐标单位是度,距离单位可以是米、公里等; 即使是普通平面坐标或者投影坐标,这两个单位同样可不同。
- 返回:
- 投影系统坐标单位。
- Default:
- 默认值为
METER
。
-
setCoordUnit
public void setCoordUnit(Unit value)
设置投影系统坐标单位。投影系统的坐标单位与距离单位(DistanceUnits)可以不同,例如经纬度坐标下的坐标单位是度,距离单位可以是米、公里等; 即使是普通平面坐标或者投影坐标,这两个单位同样可不同。
- 参数:
value
- 投影系统坐标单位。
-
setDistanceUnit
public void setDistanceUnit(Unit value)
设置距离(长度)单位。该方法仅在坐标系类型为投影坐标系和地理坐标系时有效。- 参数:
value
- 距离(长度)单位。
-
fromXML
public boolean fromXML(java.lang.String xml)
据 XML 字符串构建PrjCoordSys
对象,成功返回 true。- 参数:
xml
- 指定的 XML 字符串。- 返回:
- 如果构建成功返回 true,否则返回 false。
-
toXML
public java.lang.String toXML()
将投影坐标系类的对象转换为 XML 格式的字符串。- 返回:
- 表示投影坐标系类的对象的 XML 字符串。
-
fromFile
public boolean fromFile(java.lang.String filePath, PrjFileType type)
根据 XML 文件与投影文件类型构建PrjCoordSys
对象。- 参数:
filePath
- XML 文件的全路径。type
- 投影文件的类型。- 返回:
- 构建成功返回 true,否则返回 false。
-
toFile
public boolean toFile(java.lang.String filePath, PrjFileVersion version)
根据指定版本将PrjCoordSys
对象导出到投影文件。- 参数:
filePath
- XML 文件的全路径。version
- 导出投影文件的版本。- 返回:
- 导出成功返回 true,否则返回 false。
-
dispose
public void dispose()
释放该对象所占用的资源。当调用该方法之后,此对象不再可用。
-
clone
public PrjCoordSys clone()
对PrjCoordSys进行clone- 覆盖:
clone
在类中java.lang.Object
- 返回:
- PrjCoordSys的clone对象
-
-